AI के लिए खोज API

एक HTTP अनुरोध संरचित परिणाम लौटाता है — AI ऐप्स, RAG और एजेंट के लिए रीयल-टाइम वेब रिट्रीवल। विकल्प: Firecrawl · Exa · Tavily।

क्विक स्टार्ट

GET /api/v1/search

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

क्वेरी पैरामीटर

पैरामीटर	प्रकार	विवरण
q*	string	खोज क्वेरी (आवश्यक); कई शब्द डिफ़ॉल्ट AND (सभी मैच होने चाहिए)
limit	int	परिणाम संख्या, डिफ़ॉल्ट 10, अधिकतम 100
offset	int	पेजिनेशन ऑफ़सेट, डिफ़ॉल्ट 0, अधिकतम 990
lang	string	भाषा फ़िल्टर, जैसे zh / en
time_range	string	इंडेक्स समय सीमा: 1d/7d/30d/1y/all (crawled_at अनुसार)
site	string	किसी साइट डोमेन तक सीमित
lang_priority	string	भाषा प्राथमिकता (सॉफ्ट बूस्ट, हार्ड फ़िल्टर नहीं): जैसे zh मिलती भाषा के परिणाम ऊपर लाता है बिना अन्य छिपाए; lang से स्वतंत्र

क्वेरी ऑपरेटर (q के भीतर लिखें)

site:domain	किसी साइट तक सीमित, जैसे site:github.com rust
intitle:word	केवल शब्द वाले शीर्षकों से मैच
"exact phrase"	वाक्यांश का हर शब्द दिखना चाहिए
-exclude	शब्द वाले परिणाम बाहर करें, जैसे rust -tutorial
A OR B	किसी एक शब्द से मैच, जैसे rust OR golang
filetype:type	फ़ाइल प्रकार से फ़िल्टर (pdf/doc/ppt/xls), जैसे filetype:pdf

प्रतिक्रिया

{
  "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: प्रदर्शन नाम; छोड़ा जा सकता है — domain पर फ़ॉलबैक। source: local = हमारा इंडेक्स / brave = लोकल परिणाम अपर्याप्त होने पर वेब फ़ॉलबैक। has_llms_txt: क्या लक्ष्य साइट llms.txt देती है (AI-अनुकूल)।

पूर्ण पाठ प्राप्त करें (RAG)

GET /api/v1/content/{id}

जब खोज परिणाम में source=local और गैर-खाली id हो, तो उसका पूर्ण मुख्य पाठ लाकर LLM को दें। बाहरी फ़ॉलबैक परिणामों में लोकल बॉडी नहीं होती और वे यह endpoint नहीं उपयोग कर सकते।

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
}

एक्सेस और रेट सीमाएं

सार्वजनिक सर्च और कंटेंट एंडपॉइंट के लिए लॉगिन या API की आवश्यकता नहीं है — इन्हें सीधे आज़माएँ; सार्वजनिक स्तर प्रति क्लाइंट IP उचित दर-सीमा लागू करता है और सीमा पार होने पर 429 लौटाता है। समर्पित API कुंजियाँ पुष्ट एकीकरण के लिए ऑपरेटर द्वारा प्रदान की जाती हैं; यह साइट ऐसा स्व-सेवा साइनअप नहीं दिखाती जो मौजूद ही नहीं है।

समर्पित-कुंजी प्रतिक्रियाएँ X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset लौटाती हैं। 429 मिलने पर प्रतिक्रिया के संकेतों के अनुसार प्रतीक्षा करें — बिना सीमा के तुरंत पुनः प्रयास न करें।