Such-API · Web

Websuche-API für KI-Agenten

Ein Echtzeit-Websuche-Endpunkt, gebaut für LLM-Tool-Calling. Vorhersagbare JSON-Ausgabe, Länder- und Datumsfilter und Credit-Abrechnung pro Aufruf — andockbar an OpenAI-Function-Calling, Claude-Tool-Use oder beliebige Agenten-Frameworks.

15 Credits / Aufruf60 Anf./Min.POST /api/search/web

Websuche live testen

Gib deinen API-Key ein und führe eine echte Anfrage gegen den Live-Endpunkt aus.

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

Noch keinen API-Key?

Melde dich an, um API-Keys zu erstellen und zu verwalten.

5 Beispielanfragen — zum Laden klicken

API Integration Guide

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

API Overview
Durchsuche das öffentliche Web in Echtzeit. Liefert die relevantesten Seiten mit aufbereiteten Snippets bereit für nachgelagerte 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
}

Häufig gestellte Fragen

Was ist anders als bei Google- oder Bing-Such-APIs?

Antworten sind für LLM-Konsum vorformatiert: kurze Snippets (kein Boilerplate), strukturiertes JSON und ein Relevanz-Score. Kein separater Scrape-and-Clean-Schritt nötig, bevor Ergebnisse in ein Modell fließen.

Wie werden Ergebnisse geordnet?

Ergebnisse werden über semantische Embeddings statt Keyword-Match geordnet, sodass ähnliche Bedeutungen nah beieinanderliegen, auch wenn der Wortlaut variiert. Du kannst zudem relevance_threshold (0.0–1.0) übergeben, um schwache Ergebnisse zu verwerfen.

Kann ich auf ein bestimmtes Land oder Datum begrenzen?

Ja. Übergib country_code (ISO 3166-1 alpha-2, z. B. US, JP) und/oder start_date / end_date im Format YYYY-MM-DD.

Wie funktionieren Credits bei fehlgeschlagenen Aufrufen?

Bei Fehlschlägen (5xx oder ungültige Anfrage) werden keine Credits abgezogen. Du zahlst nur für erfolgreiche 2xx-Antworten.

Gibt es ein Tool-Schema für OpenAI-Function-Calling?

Ja. GET /api/search/web/tool-schema liefert fertige OpenAI-Function- und Claude-Tool-Use-Definitionen zum Einfügen.