API de búsqueda · Noticias

API de búsqueda de noticias para agentes de IA

Búsqueda de noticias en directo en los principales medios con filtrado integrado por país y fecha. Diseñada para bots de briefing matinal, agentes de noticias del mercado y cualquier pipeline RAG que necesite anclar respuestas en eventos actuales.

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

Prueba la búsqueda de noticias 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.

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
Búsqueda de noticias en tiempo real con filtros por rango de fecha y país. Devuelve titulares rankeados con snippets limpios listos para LLMs.
POST
/api/search/news

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/news
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/news" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "artificial intelligence regulation updates",
  "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": "artificial intelligence regulation updates",
  "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

¿Cómo de frescos son los resultados?

Los resultados incluyen artículos indexados en los últimos minutos. Usa start_date / end_date para acotar a una ventana específica, p. ej. últimas 24 horas para noticias de última hora o último trimestre para cobertura de earnings.

¿Puedo filtrar por país?

Sí. country_code acepta códigos ISO 3166-1 alpha-2 (US, GB, JP, DE…). Sesga los resultados hacia fuentes de ese país.

¿Cuál es la diferencia frente a /api/search/web?

El endpoint de noticias está afinado para fuentes periodísticas con fecha de publicación y prefiere artículos recientes. /api/search/web es mejor para contenido de referencia general (docs, tipo Wikipedia, páginas perennes).

¿Hay un esquema tool para agentes de IA?

Sí. GET /api/search/news/tool-schema devuelve definiciones de function calling de OpenAI y tool use de Claude listas para pegar en código de agente.