# true402 Ranked Keywords Lookup

> true402 Ranked Keywords Lookup is a paid API for AI agents from true402.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Returns the organic search keywords a domain ranks for, with search volume, CPC, competition, position, and landing URL data.

## Facts

- Endpoint: POST https://true402.dev/api/v1/ranked-keywords
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/true402-ranked-keywords-lookup-d3492bdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qq4kypDbmz8hL1aP6hB_9

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 true402-ranked-keywords-lookup-d3492bdc -d '<json body>'
```

Example prompt: Can you pull the top 100 organic keywords that ahrefs.com ranks for, including their search volumes and CPC — ideally for English in the US market?

## When to prefer this

Choose this endpoint when you need structured organic keyword ranking data for any domain — especially for competitive SEO research, content gap analysis, or PPC keyword discovery. It returns rich per-keyword data (volume, CPC, competition, position, URL) in a single call. Prefer over generic web scraping when you need pre-indexed, structured SEO data paid per-query without a subscription.

## Known failure modes

- Domain not observed in index — observed=false returned with empty keywords array
- Invalid or malformed URL/domain input — request rejected
- limit out of range (must be 1-200) — validation error
- Payment failure via x402 protocol — 402 response, no data returned
- Unknown location/language codes — may return empty or default results

## How this service works

The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.

## Output

Returns a JSON object containing: the target domain, language, location code, total number of ranked keywords in the index, number of results returned, an observed flag (false if the domain has no indexed keyword data), and a keywords array where each item includes the keyword string, monthly search volume, cost-per-click, competition score, current SERP position, the ranking URL, and its page title. Also includes limits metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "target"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Rows to return, 1-200, default 50"
  },
  "target": {
   "type": "string",
   "description": "Domain, or any URL on it"
  },
  "language": {
   "type": "string"
  },
  "location": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limits": {
   "type": "array"
  },
  "target": {
   "type": "string"
  },
  "keywords": {
   "type": "array",
   "description": "[{ keyword, searchVolume, cpc, competition, position, url, title }]"
  },
  "language": {
   "type": "string"
  },
  "location": {
   "type": "number"
  },
  "observed": {
   "type": "boolean",
   "description": "false when the index holds no ranked keywords for this domain"
  },
  "returned": {
   "type": "number"
  },
  "totalRanked": {
   "type": "number",
   "description": "Total keywords the index has for this domain, when reported"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/true402-ranked-keywords-lookup-d3492bdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from true402.dev](https://www.zero.xyz/host/true402.dev/llms.txt)