Docs

Lens API

Lens is designed for quick, surface-level research. It performs a search, aggregates results, and provides a concise summary with citations. Ideal for "What is..." or "Who is..." style questions.

Quick Research

Get a quick summary and citations for a topic.

POST/lens/research

Request Body

payload.json

{
  "query": "string",
  "settings": {
    "max_results": 5  // Optional. Number of search results to analyze.
  }
}

Example Request

curl.sh

curl -X POST "https://api.tekkscope.com/lens/research" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "summary of the latest spacex launch",
    "settings": { "max_results": 5 }
  }'

Response

response.json

{
  "result": {
    "summary": "SpaceX successfully launched...",
    "sources": [
      { "title": "SpaceX Launch", "url": "https://..." },
      ...
    ]
  }
}

Stream Quick Research

Stream the research process and results in real-time.

GET/lens/research/stream

Query Parameters

query (string) - Required

Example Request

stream.js

const eventSource = new EventSource(
  "https://api.tekkscope.com/lens/research/stream?query=spacex+launch&token=YOUR_API_KEY"
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  
  if (data.type === "thinking") {
    // Updates on search progress
    console.log("Thinking:", data.content);
  } else if (data.type === "response") {
    // Streamed content chunks or citations
    if (data.content.citations) {
        console.log("Sources:", data.content.citations);
    } else {
        process.stdout.write(data.content); 
    }
  }
};