WHwhop
Economic Intelligence

List Economic Intelligence

Changed on

Lists an account's recommendations and generation requests, newest first by default. When no recommendations are ready or in progress and you have company:update permission, listing queues generation, with a ten-minute cooldown after an unsuccessful request; unsuccessful requests are not listed. An account's executed recommendations and runs stay listed after Economic Intelligence turns off, but new recommendations are offered only while it is on. For visitor countries, page views, ad impressions and clicks, or payment volume over a time range, use GET /stats/time_series/:metric.

get/economic_intelligence

Request

  • Base URL
    https://api.whop.com/api/v1
  • URL
    https://api.whop.com/api/v1/economic_intelligence
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or none

Query parameters

account_idstring

Account ID, prefixed biz_. Defaults to the API key's own account; omit for personal onboarding, where signed-out visitors receive a business-setup template and eligible users receive their saved setup recommendation.

status'queued' | 'pending' | 'ready' | 'running' | 'executed' | 'incomplete' | '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. Without a status filter, when none do and you can update the account, new recommendations start generating for your input, and the list shows that request until they're ready. Repeating the same input while it generates doesn't start another.

has_runboolean

When true, only recommendations someone has started running, by any user. Without account_id, covers every account you can read that has Economic Intelligence. Can't be combined with input.

order'created_at' | 'run_started_at'

Sort field.

direction'asc' | 'desc'

Sort direction.

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",
      "acknowledged_at": "2026-01-01T12:00:00.000Z",
      "action_type": "cut_losing_ad_spend",
      "ai_chat_id": "aich_xxxxxxxxxxxxxx",
      "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",
      "inputs": [
        {
          "id": "audience",
          "label": "Guide audience",
          "options": [
            "Daily drivers"
          ],
          "template": "Guide audience: {answer}"
        }
      ],
      "prompt": "Create a 20% off promo code for my members.",
      "reasoning": "Capped 9 of 14 days.",
      "result_url": "https://atlas.whop.site/",
      "run_by_user_id": "user_xxxxxxxxxxxxxx",
      "run_ended_at": "2026-01-01T12:00:00.000Z",
      "run_started_at": "2026-01-01T12:00:00.000Z",
      "sentiment": "negative",
      "status": "executed",
      "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",
      "user_feedback": "They already do this"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 7777af2c99e5Revision changes
    • info

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

    • info

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

  • dfe1a28eca1dRevision changes
    • info

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

    • info

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