[ search · endpoint ]API de recherche · Politique

API de recherche du Parlement britannique

Interrogez les débats du Parlement britannique, les questions écrites et l'activité des députés (Hansard) depuis un seul endpoint. JSON pré-formaté pour les outils civiques, le suivi législatif et la recherche en politiques publiques par IA.

●40 crédits / appel●60 req / minPOST /api/search/politics

[ 01 · live ]

Essayez la recherche politique 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/politics

base

https://www.apipick.com

Recherche sémantique dans le Hansard du Parlement britannique : débats, questions écrites et activité des députés. Renvoie des passages 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/politics" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "UK Parliament debates on AI regulation",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "UK Parliament debates on AI regulation",
  "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": 40,
  "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 40 crédits par appel ?

Le Hansard du Parlement britannique est un corpus volumineux et continuellement mis à jour qui nécessite une maintenance d'index, donc l'endpoint coûte 40 crédits (≈ 0,04 $ par appel).

Quelles sources sont couvertes ?

Les débats du Parlement britannique, les questions écrites et l'activité des députés du Hansard (Communes et Lords). Passez un sujet, un projet de loi ou un nom de député comme requête en langage naturel.

Est-ce uniquement le Royaume-Uni ?

Oui. Cet endpoint couvre le Parlement britannique. Pour la jurisprudence et la législation britanniques, utilisez l'endpoint de recherche juridique du Royaume-Uni.

Filtrage par date ?

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

Schéma d'outil pour OpenAI / Claude ?

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