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 on the website, and they need no API key.

List the rankings

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

{
  "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

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’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.