Discovery Search

Search across 2M+ provider series in the discovery catalog.

GET /api/indicators/discover

Examples

Find Eurostat HICP series across the euro area

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "q=harmonised consumer price" \
  --data-urlencode "provider=eurostat" \
  -H "X-API-Key: YOUR_KEY"

Restrict to a specific country

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "q=unemployment rate" \
  --data-urlencode "country=DE" \
  -H "X-API-Key: YOUR_KEY"

Prefer a country without filtering

Use preferredCountry for generic searches when you want a user's home country to rank first without hiding other countries. The hint is ignored when country, subdivision, region, or a country name in q already provides explicit geography.

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "q=gdp" \
  --data-urlencode "preferredCountry=JP" \
  -H "X-API-Key: YOUR_KEY"

Drill down to a subnational region

subdivision accepts ISO 3166-2 codes (US-CA, CA-ON, AU-NSW) or Eurostat NUTS codes (FR1, DE2, IT5). The query parameter state is a backward-compatible alias.

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "country=US" \
  --data-urlencode "subdivision=US-NY" \
  --data-urlencode "topic=consumer_price_index" \
  -H "X-API-Key: YOUR_KEY"

Browse top entries with no query

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "browse=all" \
  --data-urlencode "limit=50" \
  -H "X-API-Key: YOUR_KEY"

Combine multiple filters

curl -G https://macrobymark.com/api/indicators/discover \
  --data-urlencode "provider=oecd" \
  --data-urlencode "country=JP" \
  --data-urlencode "frequency=quarterly" \
  --data-urlencode "topic=gross_domestic_product" \
  -H "X-API-Key: YOUR_KEY"

See the Discovery Catalog guide for the full list of filters and the subnational classification systems currently covered.