# Ranked Keywords

> Ranked Keywords is a paid API for AI agents from agent.chiemgaufilms.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-29).

Returns up to 25 Google keywords a domain ranks for, including position, ranking URL, search volume, CPC, and keyword difficulty via DataForSEO Labs.

## Facts

- Endpoint: POST https://agent.chiemgaufilms.com/api/v1/ranked-keywords?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ranked-keywords-a0245826
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__vbyal_uFM3V0elyPo5RT

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 ranked-keywords-a0245826 -d '<json body>'
```

Example prompt: What Google keywords does ahrefs.com rank for in the United States? Show me their positions, search volumes, and keyword difficulty scores.

## When to prefer this

Choose this endpoint when you need to quickly discover which Google keywords a specific domain is ranking for, along with actionable SEO metrics like position, search volume, CPC, and difficulty. It is ideal for competitive keyword research, SEO audits, and traffic source analysis. Prefer this over the 'Keywords for Site' endpoint when you want actual current ranking data (real positions) rather than keyword suggestions, and over 'Domain Overview' when you need keyword-level granularity rather than aggregate metrics.

## Known failure modes

- Unsupported country/language pair rejected before payment is charged
- Invalid domain format (IP addresses or ports) rejected with error
- Domain not found in DataForSEO index returns empty keywords array
- Invalid location_code returns an error response
- Malformed language_code pattern rejected with validation error
- Domain has no ranking data for the specified location/language combination

## How this service works

Up to 25 Google keywords a domain ranks for, with position, ranking page, search volume, CPC and difficulty (DataForSEO Labs Ranked Keywords).

## Output

Returns a JSON object with the target domain, location and language codes, total number of rankable keywords available, and an array of up to 25 keyword objects each containing: keyword text, ranking position, absolute position, ranking page URL, monthly search volume, CPC, competition level (LOW/MEDIUM/HIGH), keyword difficulty score (0-100), and estimated monthly traffic.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "maxLength": 300
  },
  "language_code": {
   "type": "string"
  },
  "location_code": {
   "type": "integer",
   "default": 2840,
   "maximum": 99999999,
   "minimum": 1000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "target": "example.com",
  "keywords": [
   {
    "cpc": 0.8,
    "url": "https://www.example.com/",
    "keyword": "example domain",
    "position": 1,
    "search_volume": 5400,
    "absolute_position": 2,
    "competition_level": "LOW",
    "estimated_traffic": 1800.5,
    "keyword_difficulty": 12
   }
  ],
  "language_code": "en",
  "location_code": 2840,
  "total_available": 8806
 }
}
```

## More

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