Docs

Search API

The Search API allows you to programmatically retrieve search results from the web. It supports retrieving direct links or full content extraction via streaming.

Get Search Links

Retrieve a list of search results (links and titles) for a given query.

POST/links

Request Body

payload.json

{
  "query": "string",           // Required. The search query.
  "num_results": 10,           // Optional. Default: 10.
  "n_queries": 3,              // Optional. Number of sub-queries for enhanced search.
  "enhanced_search": false     // Optional. Use LLM to generate better queries.
}

Example Request

curl.sh

curl -X POST "https://api.tekkscope.com/links" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest advancements in nuclear fusion",
    "num_results": 5,
    "enhanced_search": true
  }'

Response

response.json

{
  "results": [
    {
      "title": "Nuclear Fusion Breakthrough...",
      "url": "https://example.com/fusion-news"
    },
    ...
  ]
}

Stream Content Extraction

Perform a search and stream back extracted text content from the visited pages. Useful for RAG pipelines or deep analysis.

GET/content/stream

Query Parameters

query (string) - Required
num_results (int) - Default: 8
enhanced_search (bool) - Default: false

Example Request

stream.js

const eventSource = new EventSource(
  "https://api.tekkscope.com/content/stream?query=ai+news&token=YOUR_API_KEY"
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.content === "[END_OF_STREAM]") {
    eventSource.close();
    return;
  }
  
  if (data.type === "thinking") {
    console.log("Status:", data.content.phase);
  } else if (data.type === "response") {
    // Contains extracted content or final results
    console.log("Data:", data.content);
  }
};