# Rankings

Rankings are recomention's public research: for a category such as "accounting software", the same buyer questions are put to every engine, and every brand named is counted. They are the same data as the [AI rankings pages](https://www.recomention.com/ai-rankings) on the website, and they need no API key.

## List the rankings

```bash
curl https://api.recomention.com/v1/rankings
```

```json
{
  "rankings": [
    {
      "slug": "accounting-software",
      "category": "accounting software",
      "month": "2026-10",
      "prompts": ["What is the best accounting software for a small business?"],
      "checkedAt": "2026-10-03T09:12:00.000Z",
      "engines": ["OPENAI", "ANTHROPIC", "PERPLEXITY", "GEMINI", "GROK"],
      "top": [{ "name": "QuickBooks", "domain": "quickbooks.intuit.com", "mentions": 41 }],
      "answers": 75,
      "url": "https://www.recomention.com/ai-rankings/accounting-software"
    }
  ]
}
```

Each entry is a category's latest month: the questions asked, the engines, the five brands named most, and `answers`, the number of answers counted. `mentions` is always out of `answers`, so quote it as "named in 41 of 75 answers".

## Get one ranking

```bash
curl https://api.recomention.com/v1/rankings/accounting-software
```

The full ranking adds every brand named with its mention count and average position, and every answer verbatim (`answers[]`, each with the question index, engine and run). Further fields may be added over time; ignore the ones you don't use.

The numbers in these examples are illustrative; the list endpoint has the real ones.

## Use them before you spend

A ranking is free evidence. Before starting a paid report for a product, check whether a ranking already covers its category and where the product appears in it. The [MCP server](/mcp/)'s skills do this automatically.

## Caching

Ranking responses are cacheable for five minutes (`Cache-Control: public, max-age=300`). Rankings change monthly, so there is no reason to poll them.