Bulk macro observations

Return a bulk, filterable export of macro observations across countries and indicators, with cursor pagination and CSV or async export.

get/v1/macro/all

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/macro/all
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

countrystring

ISO country code, or a comma-separated list (alias: countries). Defaults to US.

indicator_type'growth' | 'inflation' | 'labor' | 'rates' | 'trade' | 'fiscal' | 'housing' | 'sentiment' | 'money' | 'other'

Filter by macro indicator type.

indicatorstring

Filter by a specific indicator key.

frequency'daily' | 'weekly' | 'monthly' | 'quarterly' | 'annual'

Filter by observation frequency.

date_fromstring

Inclusive lower bound on the observation period (ISO date).

date_tostring

Inclusive upper bound on the observation period (ISO date).

cursorstring

Opaque pagination cursor from the previous page's nextCursor.

limitinteger

Maximum observations per page (default 250, max 1000).

format'json' | 'csv'

Response format. csv returns an attachment; oversized exports are generated asynchronously and returned as an export job.

Response

A page of macro observations, or — when the filtered result set is too large to inline — an async export job whose signed download URL is delivered via the export.completed webhook event.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.