[ search · endpoint ]API de recherche · Finances

API de recherche de finances d'entreprise

Interrogez bilans, comptes de résultat, tableaux de flux de trésorerie, dividendes et transactions d'initiés des sociétés cotées américaines depuis un seul endpoint. JSON pré-formaté pour l'analyse fondamentale, la due diligence et la recherche d'investissement par IA.

●200 crédits / appel●30 req / minPOST /api/search/financials

[ 01 · live ]

Essayez la recherche finances 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/financials

base

https://www.apipick.com

Recherche sémantique sur bilans, comptes de résultat, flux de trésorerie, dividendes et transactions d'initiés des sociétés américaines. 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/financials" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Apple balance sheet for the latest quarter",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "Apple balance sheet for the latest quarter",
  "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": 200,
  "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

30req/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: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

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

[ faq ]

Questions fréquentes

Pourquoi 200 crédits par appel ?

Les fondamentaux structurés — bilans, comptes de résultat, flux de trésorerie, dividendes et déclarations d'initiés — sont les jeux de données les plus coûteux à licencier et normaliser, donc l'endpoint coûte 200 crédits (≈ 0,20 $ par appel). Toujours une fraction d'un siège de terminal de fondamentaux.

Quels états sont couverts ?

Bilans, comptes de résultat, tableaux de flux de trésorerie, historique des dividendes et transactions d'initiés des sociétés cotées américaines. Passez un ticker ou une requête en langage naturel ; tous sont interrogés en parallèle.

Quelles sociétés ?

Sociétés cotées aux États-Unis. Passez un ticker (p. ex. AAPL) ou un nom de société. Pour le texte des dépôts et les transcriptions de résultats, utilisez l'endpoint de recherche SEC.

Filtrage par date ?

Oui. Passez start_date et end_date au format YYYY-MM-DD pour cibler une fenêtre de reporting.

Schéma d'outil pour OpenAI / Claude ?

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