# citable.run Rank Check

> citable.run Rank Check is a paid API for AI agents from citable.run, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-16).

Returns the Google organic search position of a specific domain for a given keyword, using a licensed SERP data feed.

## Facts

- Endpoint: GET https://citable.run/v1/rank-check
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 9
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citable-run-rank-check-87a41497
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6nNCIac7A-4-tJ5qTffip

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability citable-run-rank-check-87a41497
```

Example prompt: What position does hubspot.com rank on Google for the keyword 'crm software' — check in the top 30 results for US English?

## When to prefer this

Choose this endpoint when you need a fast, single-query lookup of where a specific domain ranks organically on Google for one keyword. It is ideal for monitoring rank changes for a known domain-keyword pair, verifying competitor positions, or confirming whether a site has broken into the first page. It is more cost-efficient than pulling a full SERP page when only the rank position of one domain is needed.

## Known failure modes

- Domain not found in specified results window — returns no rank or null position
- Invalid keyword (too long or empty) — validation error
- Invalid country or language code — may default or return error
- Results window value outside 10–50 range — validation error
- SERP feed unavailability — upstream error response
- Payment failure — x402 payment required error

## How this service works

Google organic position of a domain for a keyword, via a licensed SERP feed.

## Output

Returns the Google organic search position (rank) of the specified domain for the given keyword, including position number within the checked results window. If the domain is not found in the results window, likely returns a null or not-found response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "keyword",
      "domain"
     ],
     "properties": {
      "gl": {
       "type": "string",
       "description": "country code, default us"
      },
      "hl": {
       "type": "string",
       "description": "language code, default en"
      },
      "num": {
       "type": "string",
       "description": "results window to check, 10–50 (default 20)"
      },
      "domain": {
       "type": "string",
       "description": "hostname to find, e.g. example.com (subdomains match)"
      },
      "keyword": {
       "type": "string",
       "description": "search query (1–120 chars)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citable-run-rank-check-87a41497/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from citable.run](https://www.zero.xyz/host/citable.run/llms.txt)