[ search · endpoint ]Search API · Economic

Economic Indicators Search API

Query FRED, US Bureau of Labor Statistics, World Bank indicators, IMF macro data, US federal spending, and German labour statistics from one endpoint. Pre-shaped JSON for AI-driven macroeconomic research and analysis.

●50 credits / call●60 req / minPOST /api/search/economic

[ 01 · live ]

Try Economic Data Search Live

Enter your API key and run a real query against the live endpoint.

auth · x-api-key

API Key

Don't have an API key?

[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec

POST/api/search/economic

base

https://www.apipick.com

Semantic search across FRED, BLS, World Bank, IMF, USAspending, and Destatis. Returns ranked records with source URLs ready for downstream LLMs.

parameters

querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/economic" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "US unemployment rate over the past two years",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "US unemployment rate over the past two years",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 50,
  "remaining_credits": 99
}

[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

60req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers

X-RateLimit-LimitMaximum requests allowed per minute

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetSeconds until the current window resets

Retry-AfterSeconds to wait before retrying (only on 429)

● 429 · too many requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 60 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

[ faq ]

Frequently Asked Questions

Why is this 50 credits per call?

These six government and institutional datasets are aggregated and index-maintained, so the endpoint is priced at 50 credits (≈ $0.05 per call) — well below dedicated macro-data terminals.

Which sources are covered?

US Federal Reserve Economic Data (FRED), US Bureau of Labor Statistics (BLS), World Bank development indicators, IMF macro and financial indicators, US federal spending (USAspending), and German labour statistics (Destatis). All are queried in parallel.

Can I look up a specific series?

Yes. Pass a series name or a natural-language query like 'US unemployment rate 2024' or 'World Bank GDP per capita for India' and the endpoint ranks the most relevant records.

Date filtering?

Yes. Pass start_date and end_date in YYYY-MM-DD to scope to a specific window.

Tool schema for OpenAI / Claude?

GET /api/search/economic/tool-schema returns ready-to-paste OpenAI function and Claude tool-use definitions.