Such-API für KI

Eine HTTP-Anfrage liefert strukturierte Ergebnisse — Echtzeit-Web-Retrieval für KI-Apps, RAG und Agenten. Eine Alternative zu Firecrawl · Exa · Tavily.

Schnellstart

GET /api/v1/search

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

Abfrageparameter

Parameter	Typ	Beschreibung
q*	string	Suchanfrage (erforderlich); mehrere Wörter standardmäßig AND (alle müssen passen)
limit	int	Ergebnisanzahl, Standard 10, max. 100
offset	int	Paginierungs-Offset, Standard 0, max. 990
lang	string	Sprachfilter, z. B. zh / en
time_range	string	Indexzeit-Bereich: 1d/7d/30d/1y/all (nach crawled_at)
site	string	Auf eine Site-Domain beschränken
lang_priority	string	Sprachpriorität (weiches Boosting, kein harter Filter): z. B. hebt zh Ergebnisse der passenden Sprache an, ohne andere zu verbergen; unabhängig von lang

Abfrageoperatoren (in q schreiben)

site:domain	Auf eine Site beschränken, z. B. site:github.com rust
intitle:word	Nur Titel mit dem Wort abgleichen
"exact phrase"	Jedes Wort der Phrase muss vorkommen
-exclude	Ergebnisse mit dem Wort ausschließen, z. B. rust -tutorial
A OR B	Einen der Begriffe abgleichen, z. B. rust OR golang
filetype:type	Nach Dateityp filtern (pdf/doc/ppt/xls), z. B. filetype:pdf

Antwort

{
  "total": 586,
  "took_ms": 142,
  "results": [
    {
      "id": "a1b2c3d4-…",         // page id for local results; may be empty for external fallback
      "url": "https://rust-lang.org/",
      "title": "Rust Programming Language",
      "snippet": "A language empowering everyone to build reliable software…",
      "domain": "rust-lang.org",
      "site_name": "Rust Programming Language", // display name (optional; client falls back to domain)
      "lang": "en",
      "score": 12.4,
      "source": "local",          // local (our index) | brave (web fallback)
      "has_llms_txt": true,
      "published_at": "2010-01-25T…", // article publish time (nullable; returned when known; RAG freshness/date)
      "crawled_at": "2026-07-18T…" // crawl time (freshness; time_range filters on this)
    }
  ]
}

site_name: Anzeigename; kann fehlen — Rückfall auf domain. source: local = unser Index / brave = Web-Fallback bei unzureichenden lokalen Ergebnissen. has_llms_txt: ob die Zielsite eine llms.txt bereitstellt (KI-freundlich).

Volltext abrufen (RAG)

GET /api/v1/content/{id}

Wenn ein Ergebnis source=local und eine nicht-leere id hat, holen Sie den Volltext für ein LLM. Externe Fallback-Ergebnisse haben keinen lokalen Text und können diesen Endpunkt nicht nutzen.

curl "https://tutusoo.com/api/v1/content/<local_page_id>"

# Response (RAG-relevant fields only, no internal columns):
{
  "id": "…",
  "url": "https://rust-lang.org/",
  "title": "Rust Programming Language",
  "body_text": "…full article text…",
  "author": "Jane Doe",        // author (nullable; RAG citation/byline)
  "published_at": "2026-01-…", // original publish time (nullable; freshness)
  "lang": "en",
  "word_count": 1200,
  "crawled_at": "2026-07-18T…",
  "has_llms_txt": true
}

Zugriff & Rate-Limits

Die öffentlichen Such- und Inhalts-Endpunkte benötigen weder Login noch API-Schlüssel — probiere sie direkt aus; die öffentliche Ebene wendet eine faire Ratenbegrenzung pro Client-IP an und gibt bei Überschreitung 429 zurück. Dedizierte API-Schlüssel werden vom Betreiber für bestätigte Integrationen bereitgestellt; diese Website zeigt keine Selbstbedienungs-Anmeldung, die es nicht gibt.

Antworten mit dediziertem Schlüssel liefern X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Bei einem 429 warte gemäß den Hinweisen der Antwort — wiederhole nicht sofort und unbegrenzt.