Economic Intelligence

List Economic Intelligence

Lists an account's recommendations and generation requests, newest first. Without an account, signed-out visitors receive a business-setup template and eligible users receive their saved setup recommendation.

get/economic_intelligence

Query parameters

account_idstring

Account ID, prefixed biz_. Defaults to the API key's own account; omit for personal onboarding.

status'queued' | 'pending' | 'ready' | 'executed' | 'superseded'

Filter recommendations by their current status.

inputstring

What you want recommendations for, in your own words. Up to 1000 characters. Narrows the list to the recommendations that address it.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

recommendations listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "action_type": "scale_winning_ads",
      "created_at": "2026-01-01T12:00:00.000Z",
      "executed_at": "2026-01-01T12:00:00.000Z",
      "expected_tool_calls": [
        {
          "description": "Increase the summer campaign budget",
          "tool_name": "updateAdCampaign"
        }
      ],
      "id": "reca_xxxxxxxxxxxxxx",
      "input": "more sales from ads",
      "prompt": "Create a 20% off promo code for my members.",
      "reasoning": "Capped 9 of 14 days.",
      "sentiment": "positive",
      "status": "ready",
      "superseded_at": "2026-01-01T12:00:00.000Z",
      "target_url": "https://example.com/join",
      "title": "Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes