DataForAEOby Advance Labs
Docs menu

Getting started

Rate limits and cost

Two separate allowances: how fast you may call, and how many checks you may use.

Rate limits

WhoLimit
A request with a key120 calls a minute per key
A request without a key (the free endpoints)30 calls a minute per IP address

Going over answers 429 rate_limited. These headers come on every response from a rate-limited call:

HeaderMeaning
x-ratelimit-limitThe limit that applies to this call.
x-ratelimit-remainingCalls left in the current minute.
x-ratelimit-resetSeconds until the allowance resets.
retry-afterOn a 429 only: whole seconds to wait, at least 1.

The free endpoints expose these headers to browsers, so a web page can read them.

Cost

Every successful response carries cost.checks, the number of checks the call used, so you can meter yourself. A check is one answer from one AI engine. During the beta, calls draw on your AEO Toolkit plan’s monthly checks. When a workspace has used them, calls that need checks answer 402 quota_exceeded; GET /me shows what has been used.

EndpointCost
GET /ai-crawlersFree
POST /ai-crawlers/verifyFree
GET /demandFree
GET /keywordsFree
GET /referralsFree
GET /citationsFree
POST /answers/live1 check per prompt per engine answered
GET /meFree
Waiting out a 429
const res = await fetch(url, init);
if (res.status === 429) {
  const wait = Number(res.headers.get('retry-after') ?? '1');
  await new Promise((r) => setTimeout(r, wait * 1000));
  // then send the request again
}