---
title: "Poll a SERP rank-check job"
method: GET
path: "/v1/serp/rank-check/{jobId}"
tags: ["SERP"]
---

# Poll a SERP rank-check job

`GET /v1/serp/rank-check/{jobId}`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/serp/rank-check/{jobId}`
- Auth: HTTP bearer

Returns the rank-check job state; `result.ranks` maps each requested domain to its best 1-based organic rank (or null if absent).

## Path parameters

- `jobId` string, required

## Response `200`

Job state

- object
  - `id` string, required
  - `query` string, required
  - `status` 'running' | 'completed' | 'failed', required
  - `createdAt` string, date-time, required
  - `error` string, nullable
  - `result` object, nullable
    - `query` string
    - `ranks` object: Map of requested domain → best 1-based rank, or null if not found
    - `top10` string[]

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)