---
title: "Latest SERP snapshot for a tracked keyword"
method: GET
path: "/serp"
tags: ["Rank tracking"]
---

# Latest SERP snapshot for a tracked keyword

`GET /serp`

Returns the metadata of the most recent stored crawl. Pass include_items=true to also receive the full result page — every stored item with position, URL, domain and title.

## Query parameters

- `keyword` string, required
- `project_id` string, required
- `country` string
- `language` string
- `device` 'desktop' | 'mobile'
- `include_items` 'true' | 'false' — true to include the full items array (the stored top results with positions, URLs, domains, titles)

## Response `200`

Success

- object
  - `keyword` string, required
  - `location_code` number, required
  - `language_code` string, required
  - `device` string, required
  - `datetime` string, nullable, required — ISO-8601 time of the stored crawl
  - `se_results_count` number, nullable, required
  - `items_count` number, nullable, required
  - `item_types` string[], required
  - `found_rank` object, nullable, required — Best position of the project domain in this SERP, or null if not ranked
  - `items` SerpItem[] — Present only when include_items=true
    - `position` number, nullable
    - `item_type` string — e.g. organic, featured_snippet, video
    - `rank_absolute` number, nullable
    - `rank_group` number, nullable
    - `domain` string
    - `root_domain` string
    - `url` string
    - `title` string

## Other responses

- `400` — Invalid input or feature not enabled
- `401` — Missing or invalid API key
- `404` — Not found (or no data available yet)
- `429` — Rate limit exceeded — respect Retry-After

## Changes

- **2026-09-03** `49e0b4b72568` — 11 info
  - added the new optional `query` request parameter `include_items`
  - added the optional property `items` to the response with the `200` status
  - added the required property `datetime` to the response with the `200` status
  - added the required property `device` to the response with the `200` status
  - …7 more

[Change history](https://skmtc.dev/zutrix/apis/zutrix-api/changes/serp/get.md)

---

[API](https://skmtc.dev/zutrix/apis/zutrix-api.md) · [All operations](https://skmtc.dev/zutrix/apis/zutrix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zutrix/zutrix-api/revisions/49e0b4b72568/schema)