Aapipick
API de búsqueda · Web

API de búsqueda web para agentes de IA

Endpoint de búsqueda web en tiempo real construido para tool calling de LLM. Salida JSON predecible, filtros por país y fecha, y facturación por créditos en cada llamada — encaja en function calling de OpenAI, tool use de Claude o cualquier framework de agentes.

15 créditos / llamada60 req / minPOST /api/search/web

Prueba la búsqueda web en directo

Introduce tu API Key y ejecuta una consulta real contra el endpoint en producción.

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

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

Iniciar sesiónGestionar claves API
5 consultas de ejemplo — haz clic para cargar

API Integration Guide

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

API Overview
Busca en la web pública en tiempo real. Devuelve las páginas más relevantes con snippets limpios listos para LLMs.
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
}

Preguntas frecuentes

¿En qué se diferencia de las APIs de Google o Bing?

Las respuestas están preformateadas para LLM: snippets cortos (sin elementos accesorios), JSON estructurado y puntuación de relevancia. No necesitas un paso adicional de scraping y limpieza antes de pasar resultados al modelo.

¿Cómo se rankean los resultados?

Los resultados se rankean por embeddings semánticos en lugar de coincidencia de palabras clave, por lo que significados similares quedan próximos aunque la redacción difiera. También puedes pasar relevance_threshold (0.0–1.0) para descartar resultados de baja calidad.

¿Puedo limitar a un país o rango de fechas?

Sí. Pasa country_code (ISO 3166-1 alpha-2, p. ej. US, JP) y/o start_date / end_date en formato YYYY-MM-DD.

¿Cómo funcionan los créditos en llamadas fallidas?

Si la búsqueda falla (5xx o consulta inválida), no se descuentan créditos. Solo se cobra por respuestas 2xx exitosas.

¿Hay un esquema tool para function calling de OpenAI?

Sí. GET /api/search/web/tool-schema devuelve definiciones listas para pegar de function calling de OpenAI y tool use de Claude.