PilotFoxDocs
REST APIAPI referenceSearch Console

Get a search query's detail

GET
/api/v1/sites/{siteId}/search-console/queries/detail

One query's totals and series in the window, and its top 100 pages, countries and devices by clicks.

Requires searchConsole:read on the site (an API key, or a signed-in member's role). Share links: 401.

Authorization

headerx-api-key<token>

An organization API key (ak_…), with the permissions and the sites it was created with. For servers and scripts: no cookie and no Origin check. Also accepted as Authorization: Bearer ak_… (apiKeyBearer). A request carries one credential: a key sent with a share token or a live session cookie is 400 (details.reason: ambiguous_credentials).

Scope: searchConsole:read

Path Parameters

siteId*string

Query Parameters

start?string
end?string
last?string
all?"true"
Value in"true"
bucket?string
Value in"day""week""month"
compare?string
Value in"previous""year"
compare_start?string
compare_end?string
query*string
Length1 <= length <= 2048

Response Body

OK

application/json
  1. response
data*
meta*
Example Request
curl -X GET 'https://pilotfox.app/api/v1/sites/string/search-console/queries/detail?query=string'
Example Response200
{  "data": {    "totals": {      "clicks": 0,      "impressions": 0,      "ctr": 0,      "position": 0    },    "previous": {      "clicks": 0,      "impressions": 0,      "ctr": 0,      "position": 0    },    "series": [      {        "clicks": 0,        "impressions": 0,        "ctr": 0,        "position": 0,        "date": "string",        "provisional": true,        "synced": true      }    ],    "pages": [      {        "clicks": 0,        "impressions": 0,        "ctr": 0,        "position": 0,        "page": "string",        "previous": {          "clicks": 0,          "impressions": 0,          "ctr": 0,          "position": 0        }      }    ],    "countries": [      {        "clicks": 0,        "impressions": 0,        "ctr": 0,        "position": 0,        "country": "string",        "country3": "string",        "previous": {          "clicks": 0,          "impressions": 0,          "ctr": 0,          "position": 0        }      }    ],    "devices": [      {        "clicks": 0,        "impressions": 0,        "ctr": 0,        "position": 0,        "device": "string",        "previous": {          "clicks": 0,          "impressions": 0,          "ctr": 0,          "position": 0        }      }    ]  },  "meta": {    "window": {      "from": "string",      "to": "string",      "tz": "America/Los_Angeles",      "bucket": "day"    },    "compare": {      "from": "string",      "to": "string"    },    "totalCount": 0,    "previousAvailable": true,    "cache": "hit"  }}