> ## Documentation index
> Fetch the complete documentation index at: https://rankfield.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Rankfield API docs

> Call Rankfield's SEO and web data API: Site Strength, referring domains, search suggestions and live page data, with one API key.

## Make your first request

1. Copy a key from the [API key panel](/?tab=key#playground). No sign-up.
2. Send it as a bearer token:

```bash
curl https://rankfield.dev/v1/domains/wikipedia.org/site-strength \
  -H "Authorization: Bearer $RANKFIELD_API_KEY"
```

3. Read the JSON: `{"domain": "wikipedia.org", "siteStrength": 100}`.

The [Quickstart](/docs/get-started/quickstart) has the same in Python and JavaScript.

## Endpoints

| Endpoint | What you get | Request |
|---|---|---|
| [Site Strength](/docs/site-strength/get-site-strength) | A domain's 0–100 link authority score | `GET /v1/domains/{domain}/site-strength` |
| [Referring Domains](/docs/referring-domains/get-referring-domains) | How many domains link to a site, and the strongest 20 | `GET /v1/domains/{domain}/referring-domains` |
| [All Referring Domains](/docs/referring-domains/list-referrers) | Every linking domain, paged or as CSV | `GET /v1/domains/{domain}/referrers` |
| [Link Extraction](/docs/link-extraction/extract-links) | Every link on a live page, with anchor text and rel | `GET /v1/html/link-extraction?url=` |
| [Scrape](/docs/scrape/scrape-a-page) | A page as Markdown, with metadata, links and structured data | `GET /v1/scrape?url=` |
| [Bot View](/docs/bot-view/check-a-page) | Which of 274 crawlers and AI bots may read a page | `GET /v1/bot-view?url=` |
| [Brand](/docs/brand/get-a-brand) | A company's logos, colours, fonts and profiles | `GET /v1/brand?domain=` |
| [Site Map](/docs/map/map-a-site) | Every URL of a website | `GET /v1/map?domain=` |
| [Site Audit](/docs/site-audit/audit-a-website) | Every page of a website checked for technical SEO and AEO problems | `POST /v1/site-audit` |
| [Bing Suggest](/docs/suggest/get-bing-suggestions) | Bing autocomplete for a keyword | `GET /v1/bing/suggest?query=` |
| [DuckDuckGo Suggest](/docs/suggest/get-duckduckgo-suggestions) | DuckDuckGo autocomplete for a keyword | `GET /v1/ddg/suggest?query=` |
| [Yahoo Search Predictions](/docs/suggest/get-yahoo-search-predictions) | Yahoo's predictions for a keyword | `GET /v1/yahoo/search-predictions?query=` |

Every endpoint takes the same key. For many URLs, domains or keywords at once, each one also has [batch jobs](/docs/get-started/batch-jobs).

## Before you build

- [Authentication](/docs/get-started/authentication): Send the key, get one from code, and keep it safe.
- [Errors](/docs/get-started/errors): Status codes, error bodies and which errors to retry.
- [Rate limits](/docs/get-started/rate-limits): How much one request or job holds, and what to do about a 429.
- [Batch jobs](/docs/get-started/batch-jobs): Start a job, follow it, and read results as they finish.

## For AI agents

- [For coding agents](/docs/agents/for-coding-agents): The whole API on one page: auth, which endpoint to pick, timeouts and gotchas.
- [MCP server](/docs/agents/mcp-server): Connect Claude, Cursor or any MCP client with your key.
- [Agent skill](/docs/agents/agent-skill): One SKILL.md file that teaches an agent to use Rankfield.
- [llms.txt and Markdown pages](/docs/agents/llms-txt-and-markdown): Every page as Markdown, indexed in /llms.txt.
:::