[ search · endpoint ]API de recherche · Économie

API de recherche d'indicateurs économiques

Interrogez FRED, le Bureau of Labor Statistics américain, les indicateurs de la Banque mondiale, les données macro du FMI, les dépenses fédérales américaines et les statistiques du travail allemandes depuis un seul endpoint. JSON pré-formaté pour la recherche macroéconomique par IA.

●50 crédits / appel●60 req / minPOST /api/search/economic

[ 01 · live ]

Essayez la recherche données économiques en direct

Saisissez votre clé API et exécutez une vraie requête sur l'endpoint en production.

auth · x-api-key

Clé API

Pas encore de clé API ?

Connectez-vous à votre compte pour créer et gérer vos clés API.

Se connecter Gérer les clés API

[ 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

Recherche sémantique sur FRED, BLS, Banque mondiale, FMI, USAspending et Destatis. Renvoie des enregistrements classés avec URLs sources prêts pour les LLM.

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 ]

Questions fréquentes

Pourquoi 50 crédits par appel ?

Ces six jeux de données gouvernementaux et institutionnels sont agrégés et maintenus en index, donc l'endpoint coûte 50 crédits (≈ 0,05 $ par appel), bien en dessous des terminaux de données macro dédiés.

Quelles sources sont couvertes ?

FRED de la Réserve fédérale américaine, le Bureau of Labor Statistics (BLS), les indicateurs de développement de la Banque mondiale, les indicateurs macro et financiers du FMI, les dépenses fédérales américaines (USAspending) et les statistiques du travail allemandes (Destatis). Tous sont interrogés en parallèle.

Puis-je chercher une série précise ?

Oui. Passez un nom de série ou une requête en langage naturel comme « taux de chômage américain 2024 » ou « PIB par habitant de la Banque mondiale pour l'Inde » et l'endpoint classe les enregistrements les plus pertinents.

Filtrage par date ?

Oui. Passez start_date et end_date au format YYYY-MM-DD pour cibler une fenêtre précise.

Schéma d'outil pour OpenAI / Claude ?

GET /api/search/economic/tool-schema renvoie des définitions prêtes à coller de fonction OpenAI et d'utilisation d'outil Claude.