AI Search

The Desearch API allows you to perform AI-powered web searches, gathering relevant information from multiple sources including web pages, research papers, and social media discussions.

Quick Start

Here's a simple example to get started:

python

import requests

url = "https://api.desearch.ai/desearch/ai/search"
headers = {
    "Authorization": "Bearer <your-api-key>",
    "Content-Type": "application/json"
}
data = {
    "prompt": "What is Bittensor?",
    "tools": ["web", "twitter", "reddit"],
    "date_filter": "PAST_24_HOURS",
    "streaming": False
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

💡 Try it live: Use our API Playground to test the AI Search endpoint interactively with your API key.

Parameters

Required

Parameter	Type	Description
`prompt`	string	The search query
`tools`	array	List of tools to search (e.g., `["web", "twitter", "reddit"]`)

Optional

Parameter	Type	Default	Description
`date_filter`	string	`PAST_24_HOURS`	Filter results by date (`PAST_24_HOURS`, `PAST_WEEK`, `PAST_MONTH`, `PAST_YEAR`, `ALL_TIME`)
`streaming`	boolean	`true`	Enable/disable streaming responses
`result_type`	string	`LINKS_WITH_SUMMARIES`	Result format: `ONLY_LINKS`, `LINKS_WITH_SUMMARIES`, or `LINKS_WITH_FINAL_SUMMARY`
`system_message`	string	`""`	Custom system message for AI processing
`count`	integer	`10`	Number of results per source (10-200)

For complete parameter details and live testing, visit the API Reference.

Available Tools

Tool	Description
`web`	Search across web pages
`twitter`	Real-time X (Twitter) posts
`reddit`	Community discussions
`hackernews`	Tech news and discussions
`youtube`	Video content
`wikipedia`	Encyclopedia articles
`arxiv`	Research papers and preprints

Response Example

json

{
  "completion": {
    "search_summary": "Bittensor is a decentralized AI network...",
    "key_sources": [
      {
        "text": "Bittensor enables open AI collaboration",
        "url": "https://example.com/article"
      }
    ],
    "key_tweets": [...],
    "key_posts": [...]
  },
  "reddit_search_results": {...},
  "hacker_news_search_results": {...}
}

Next Steps

API Reference: Full endpoint documentation with interactive playground
Python SDK: Official Python client library
JavaScript SDK: Official JavaScript/TypeScript client library