List the public AI rankings

GET

/v1/rankings

curl --request GET \
  --url https://api.recomention.com/v1/rankings

Each category’s latest month: who the engines name, with counts. No key needed.

Responses

200

The rankings.

Media typeapplication/json

object

rankings

required

Array<object>

object

slug

required

string

category

required

string

month

required

YYYY-MM

string

prompts

required

Array<string>

checkedAt

required

string format: date-time

engines

required

Array<string>

Allowed values: OPENAI ANTHROPIC PERPLEXITY GEMINI GROK AI_OVERVIEW

top

required

Array<object>

object

name

required

string

domain

string

mentions

required

integer

>= -9007199254740991 <= 9007199254740991

answers

required

integer

>= -9007199254740991 <= 9007199254740991

url

required

string

Example

{
  "rankings": [
    {
      "engines": [
        "OPENAI"
      ]
    }
  ]
}

429

Rate limited. Wait Retry-After seconds.

Media typeapplication/json

object

error

required

What went wrong, in plain words. Never repeats a submitted secret.

string

fields

Request fields to fix (400).

Array<string>

retryAfterSeconds

Seconds to wait before retrying (429).

integer

>= -9007199254740991 <= 9007199254740991

limit

Which plan limit refused a start: plan, projects, reportsPerMonth, perDay, concurrent.

string

status

The report’s status, when it explains the refusal (409).

string

Example ^generated

{
  "error": "example",
  "fields": [
    "example"
  ],
  "retryAfterSeconds": 1,
  "limit": "example",
  "status": "example"
}

Headers

Retry-After

integer

Seconds to wait.

RateLimit-Limit

integer

Requests allowed in the window.

RateLimit-Remaining

integer

Requests left in the window (0 on a 429).

RateLimit-Reset

integer

Seconds until the window resets.