Rank tracking

Latest SERP snapshot for a tracked keyword

Changed on

Returns the metadata of the most recent stored crawl. Select the tracked keyword either by keyword_id (recommended — the id from the project keywords endpoint) or by keyword text plus country, language and device. Pass include_items=true to also receive the full result page — every stored item with position, URL, domain and title.

get/serp

Request

  • Base URL
    https://api.zutrix.com/v1
  • Auth
    HTTP bearer

Query parameters

keywordstring

Keyword text. Required unless keyword_id is sent.

keyword_idstring

Tracked keyword id. Takes precedence over keyword, country, language and device.

project_idstring required
countrystring

Country name, ISO code or location code. Defaults to United States. Ignored when keyword_id is sent.

languagestring

Language name or code. Defaults to English. Ignored when keyword_id is sent.

device'desktop' | 'mobile'

Defaults to desktop. Ignored when keyword_id is sent.

include_items'true' | 'false'

true to include the full items array (the stored top results with positions, URLs, domains, titles)

Response

Success

keywordstring required
location_codenumber required
language_codestring required
devicestring required
datetimestring nullable required

ISO-8601 time of the stored crawl

se_results_countnumber nullable required
items_countnumber nullable required
item_typesstring[] required
found_rankobject nullable required

Best position of the project domain in this SERP, or null if not ranked

Changes

    • info

      added the new optional query request parameter keyword_id

    • info

      the query request parameter keyword became optional

    • info

      added the new optional query request parameter include_items

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status