List Economic Intelligence
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.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-15-1"
Query Parameters
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.
Filter recommendations by their current status.
queued, pending, ready, running, executed, incomplete, superseded 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.
1000When 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.
Sort field.
created_at, run_started_at Sort direction.
asc, desc Number of results to return from the start of the range.
x <= 100Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.
Number of results to return from the end of the range.
x <= 100Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

