Skip to main content
The screener filters countries by macro conditions, the way a stock screener filters companies by fundamentals.

​
Screen by conditions

# Countries with CPI inflation > 3% AND unemployment < 5%
curl "https://api.financialdatapi.com/v1/public/screener?filter=cpi_inflation_yoy:gt:3,unemployment_rate:lt:5" \
  -H "x-api-key: $CONDUIT_API_KEY"
The filter is a comma-separated list of field:operator:value clauses (AND-combined). Operators include gt, gte, lt, lte, eq.
Python
import requests

res = requests.get(
    "https://api.financialdatapi.com/v1/public/screener",
    params={"filter": "cpi_inflation_yoy:gt:3,unemployment_rate:lt:5"},
    headers={"x-api-key": "your_key_here"},
)
for match in res.json()["data"]:
    print(match["entity"], {v["field"]: v["value"] for v in match["values"]})

​
Discover screenable fields

curl "https://api.financialdatapi.com/v1/public/screener/filters" \
  -H "x-api-key: $CONDUIT_API_KEY"
This returns every field you can screen on and the operators each supports — point your UI or agent at it instead of hard-coding the field list.