Aapipick
API recherche · Web

API de recherche web pour agents IA

Endpoint de recherche web en temps réel conçu pour le tool calling LLM. Sortie JSON prévisible, filtres pays et date, et facturation par crédits par appel — branchable au function calling OpenAI, au tool use Claude ou à n'importe quel framework d'agents.

15 crédits / appel60 req / minPOST /api/search/web

Essayer la recherche web en direct

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

API Authentication Required
Enter your API key to access this service. All API calls require authentication.

Pas encore de clé API ?

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

Se connecterGérer les clés API
5 requêtes d'exemple — cliquez pour charger

API Integration Guide

Learn how to integrate this API into your applications with code examples and detailed documentation.

API Overview
Recherchez sur le web public en temps réel. Renvoie les pages les plus pertinentes avec des snippets nettoyés prêts pour les LLM en aval.
POST
/api/search/web

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/web
Parameters
Required and optional parameters for this API
query
required
string

Natural-language search query

max_num_results
optional
integer

1–5, default 5

relevance_threshold
optional
number

0.0–1.0 quality filter

country_code
optional
string

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

start_date
optional
string

ISO date YYYY-MM-DD

end_date
optional
string

ISO date YYYY-MM-DD

Code Examples
Copy and paste these examples to quickly integrate the API into your application

cURL Request

curl -X POST "https://www.apipick.com/api/search/web" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "latest developments in quantum computing",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
Replace YOUR_API_KEY with your actual API key
Response Example
Example response from the API

JSON Response

{
  "query": "latest developments in quantum computing",
  "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": 15,
  "remaining_credits": 99
}
Integration Tips

✓Best Practices

  • • Always include x-api-key header
  • • Always handle errors gracefully
  • • Validate input data before sending
  • • Use HTTPS for secure communication
  • • Cache responses when appropriate

ℹResponse Headers

  • • Content-Type: application/json
  • • x-api-key: Required for authentication
  • • Status codes: 200 (success), 400 (error), 401 (unauthorized)
  • • No rate limiting applied

Rate Limits

⏱️

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
}

Questions fréquentes

Qu'est-ce qui change par rapport aux API Google ou Bing ?

Les réponses sont pré-formatées pour la consommation LLM : snippets courts (sans boilerplate), JSON structuré et score de pertinence. Pas besoin d'une étape supplémentaire de scraping et de nettoyage avant d'envoyer les résultats au modèle.

Comment les résultats sont-ils classés ?

Les résultats sont classés par embeddings sémantiques plutôt que par correspondance de mots-clés, donc des sens proches restent regroupés même si la formulation diffère. Vous pouvez aussi passer relevance_threshold (0.0–1.0) pour écarter les résultats de faible qualité.

Puis-je restreindre à un pays ou une plage de dates ?

Oui. Passez country_code (ISO 3166-1 alpha-2, p. ex. US, JP) et/ou start_date / end_date au format YYYY-MM-DD.

Comment fonctionnent les crédits pour les appels échoués ?

Si la recherche échoue (5xx ou requête invalide), aucun crédit n'est déduit. Vous n'êtes facturé que sur les réponses 2xx réussies.

Existe-t-il un schéma outil pour le function calling OpenAI ?

Oui. GET /api/search/web/tool-schema renvoie des définitions function calling OpenAI et tool use Claude prêtes à coller.