Get search results

curl --request GET \
  --url https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results \
  --header 'API-KEY: <api-key>'

import requests

url = "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results"

headers = {"API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'API-KEY': '<api-key>'}};

fetch('https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

SERP Analyzer

Get search results

Returns search results for a given query in the CSV format. The report contains URLs with SERP data, keywords and factors calculated by Surfer. The data here highlights important page characteristics and provides high-level overview of SERP quality.

Rate limit: 10 requests/sec

Example response:

"position","url","state","title/keywordCount/all","title/keywordCount/outsideLinks","meta_description/keywordCount/all","meta_description/keywordCount/outsideLinks","url/path/keywordCount/all","url/domain/keywordCount/all","body/wordCount/all","body/wordCount/outsideLinks","body/keywordCount/all","body/keywordCount/outsideLinks","p/wordCount/all","p/wordCount/outsideLinks","p/keywordCount/all","p/keywordCount/outsideLinks","p/elementCount/all","p/elementCount/outsideLinks","headings/wordCount/all","headings/wordCount/outsideLinks","headings/keywordCount/all","headings/keywordCount/outsideLinks","headings/elementCount/all","headings/elementCount/outsideLinks","above_the_fold/wordCount/all","above_the_fold/wordCount/outsideLinks","above_the_fold/keywordCount/all","above_the_fold/keywordCount/outsideLinks","h1/keywordCount/all","h1/keywordCount/outsideLinks","h2/keywordCount/all","h2/keywordCount/outsideLinks","h3/keywordCount/all","h3/keywordCount/outsideLinks","h4/keywordCount/all","h4/keywordCount/outsideLinks","h5/keywordCount/all","h5/keywordCount/outsideLinks","h6/keywordCount/all","h6/keywordCount/outsideLinks","h1/elementCount/all","h1/elementCount/outsideLinks","h2/elementCount/all","h2/elementCount/outsideLinks","h3/elementCount/all","h3/elementCount/outsideLinks","h4/elementCount/all","h4/elementCount/outsideLinks","h5/elementCount/all","h5/elementCount/outsideLinks","h6/elementCount/all","h6/elementCount/outsideLinks","img_alt/keywordCount/all","img_alt/keywordCount/outsideLinks","img_alt/wordCount/all","img_alt/wordCount/outsideLinks","img/elementCount/all","img/elementCount/outsideLinks","strong_and_b/wordCount/all","strong_and_b/wordCount/outsideLinks","strong_and_b/keywordCount/all","strong_and_b/keywordCount/outsideLinks","strong_and_b/elementCount/all","strong_and_b/elementCount/outsideLinks","score/content/all","pageSpeed/ttfb/all","pageSpeed/totalSize/all","pageSpeed/load/all"
"1","https://www.intel.com/content/www/us/en/gaming/resources/how-to-build-a-gaming-pc.html","completed","0","0","0","0","1","0","8251","7087","0","0","5022","4885","0","0","134","134","214","139","0","0","34","34","81","68","0","0","0","0","0","0","0","0","0","0","0","0","0","0","1","1","18","18","14","14","2","2","0","0","0","0","0","0","215","205","40","38","108","92","0","0","37","37","77","99","4139.0771484375","11186"

The exact amount of SERP results may vary depending on the specified keyword, location and device type, max top 50 competitors.

Each row can be considered a “mini-query” with it’s own state, which can be:

scheduled - crawl and analysis of this specific competitor did not complete yet
failed - crawl did not succeed, most likely due to timeout, bot block or content paint issue
completed - crawl completed and populated data fields based on received HTML code

GET

api

exports

csv

serp_analyzer

{serp_analyzer_id}

search_results

Get search results

curl --request GET \
  --url https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results \
  --header 'API-KEY: <api-key>'

import requests

url = "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results"

headers = {"API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'API-KEY': '<api-key>'}};

fetch('https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.surferseo.com/api/v1/exports/csv/serp_analyzer/{serp_analyzer_id}/search_results")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

Authorizations

API-KEY

string

header

required

Path Parameters

serp_analyzer_id

integer

required

The unique identifier of the entity

Required range: x >= 1

Example:

1

Overview

API v2

API v1 (legacy)

Get search results

Authorizations

Path Parameters

Response