API Documentation

Welcome to the SearchIT API. Our REST API allows you to execute real-time web searches and receive clean, structured JSON results instantly. It's designed explicitly to be consumed by LLMs, Agentic frameworks, and RAG pipelines.

Authentication

All API requests must be authenticated via a Bearer token in the Authorization header.

HTTP Header

Authorization: Bearer sk_your_api_key_here

You can generate API keys from your Dashboard.

Perform a Search

POST/v1/search

Executes a web search and returns a list of highly relevant, sanitized results with titles, URLs, and snippet content directly injected for your LLM.

Request Body JSON

Parameter	Type	Description
query *	string	The search query (e.g. "latest AI models").
categories	array[string]	Filter by category. Options: `general, news, science, it`.
time_range	string	Limit results by time. Options: `day, week, month, year`.

Example Response

200 OK - application/json

{
  "query": "latest AI models",
  "results": [
    {
      "title": "Anthropic releases Claude 3.5",
      "url": "https://example.com/news/claude-3-5",
      "content": "Today Anthropic announced...",
      "score": 0.98
    }
  ],
  "credits_used": 1,
  "credits_remaining": 499,
  "response_time_ms": 342
}

Errors & Limits

401 Invalid or missing API key.
402 Insufficient credits to perform the search. Purchase credits in the billing dashboard.
429 You have exceeded the rate limit (100 req/min per key). Back off and retry.
500 An issue occurred on our upstream search cluster. We will be notified immediately.