Sign in
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

Changed in 17 of the 74 revisions of this API.8235

  • 78e1ed7366cd2See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 73dd0533cd812See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 86b97292852d2See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • c1dceb26e5052See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 7fcefabddb0a3See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    • ○

      added the new optional query request parameter input

      new-optional-request-parameter

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99663See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    • ○

      added the required property // to the response with the status

      response-required-property-added

  • 35edb053220a2See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ac2b9b1c6a002See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • a88353507eac2See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 51933d70d7f52See the full diff
    • ○

      the security scope company:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope ai_chat:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

Of the 74 revisions, 1 has no diff computed.