Scan History

How scans run

Every tracked prompt is scanned once daily. The scan cycle starts at 03:00 UTC and processes all active prompts across every configured AI engine. Results are typically available 1–4 hours after the cycle starts — by 04:00–07:00 UTC most days.

Each scan produces one run per engine per prompt. A prompt configured for ChatGPT and Gemini in the US generates two runs per day.

Querying history

Use GET /v1/aeo/prompts/{id}/runs to retrieve the full scan history for a prompt:

curl "https://api.reddgrow.ai/v1/aeo/prompts/1234/runs?from=2026-04-01&to=2026-04-10&limit=20&offset=0" \
  -H "x-api-key: rg_YOUR_KEY"

Available filters:

• engine — filter to a specific AI engine
• country — filter to a specific country
• from / to — ISO 8601 date strings (e.g., 2026-04-01)

Pagination:

• limit — number of results per page (default: 20)
• offset — number of results to skip (default: 0)

To page through all results: increment offset by limit until you receive fewer results than limit.

First scan: what to expect

New prompts enter the queue immediately after creation. They are included in the next daily scan cycle that runs after they were created.

If you create a prompt at 10:00 UTC on Monday, it will be scanned during the 03:00 UTC cycle on Tuesday. Results appear by 04:00–07:00 UTC Tuesday.

There is no on-demand scan trigger. The API does not provide a way to force an immediate scan because doing so would allow runaway costs against your prompt quota.

Data retention

Reactivating your Pro plan within the 90-day window restores full access to all historical scan data.

Backfill

Historical backfill is not available. Scan data starts from the day a prompt was first created and included in a scan cycle. If you create a prompt today, you have no data for yesterday.

To build a historical baseline, create your prompts as early as possible. Daily scans accumulate automatically — the longer a prompt has been active, the more trend data you have.