v1.0.0 · updated from bundled OpenAPI
/desearch/ai/searchThe 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. Billing metadata: successful billable responses include the `X-Desearch-Cost-Usd`, `X-Desearch-Usage-Count`, `X-Desearch-Service`, and `X-Desearch-Currency` headers. JSON object responses also include optional `cost_usd`, `usage_count`, `service`, and `currency` fields. For example, `usage_count=10` at `$0.015 / 1,000` resolves to `cost_usd=0.00015`. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.
Base URL
https://api.desearch.aiUse AI Contextual Search when your application needs search-grounded AI resultswithout maintaining its own crawler, social-data pipeline, or retrieval infrastructure. The endpoint returns structured data that can be consumed by agents, research tools, dashboards, and retrieval-augmented generation workflows. Keep the request focused on the minimum fields your workflow needs so responses remain fast and easy to validate.
Send requests to POST /desearch/ai/search with your Desearch API key in the authorization header. Treat the key as a server-side secret, validate all required parameters before sending the request, and handle non-2xx responses explicitly. Production integrations should use sensible timeouts, retry only transient failures with backoff, and record the response status and request identifier for troubleshooting.
Test the example request below before integrating it into a larger workflow. Confirm that the returned fields, links, and timestamps meet your freshness requirements, then add schema validation at the application boundary. For agentic systems, preserve source URLs with the generated answer so users can inspect evidence and your application can avoid presenting unsupported claims.
promptstringrequiredSearch query prompt
toolsarrayrequiredA list of tools to be used for the search
start_datestringThe start date for the search query. Format: YYYY-MM-DDTHH:MM:SSZ (UTC)
end_datestringThe end date for the search query. Format: YYYY-MM-DDTHH:MM:SSZ (UTC)
date_filterstringPredefined date filters for the search results, or you can use specific start and end dates
Default: PAST_24_HOURS
streamingbooleanWhether to stream results
Default: false
result_typestringThe result type to be used for the search
Default: LINKS_WITH_FINAL_SUMMARY
system_messagestringThe system message to be used for the search
Default:
scoring_system_messagestringSystem message for scoring the response
countstringThe number of results to return per source. Min 10. Max 200.
Default: 10
Your API key is sent in the Authorization header.
curl -X POST "https://api.desearch.ai/desearch/ai/search" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Bittensor",
"tools": [
"web",
"hackernews",
"reddit",
"wikipedia",
"youtube",
"twitter",
"arxiv"
],
"streaming": false
}'{
"hacker_news_search": [
{
"link": "https://news.ycombinator.com/item?id=35114983",
"snippet": "Mar 12, 2023 � As a decentralized AI network, Bittensor leverages the power of AI to drive innovation and collaboration on a global scale.",
"title": "How Bittensor Is Pioneering a New Era of AI Innovation - Hacker News"
}
],
"reddit_search": [
{
"link": "https://www.reddit.com/r/bittensor_/comments/1blm5iv/thinking_of_going_in_big_on_bittensor/",
"snippet": "Mar 23, 2024 � I have great hopes for Bittensor and am about to commit to a sizeable position to which I will probably be adding over the coming months and even years.",
"title": "Thinking of going in big on Bittensor : r/bittensor_ - Reddit"
}
],
"search": [
{
"link": "https://www.thebigwhale.io/tokens/bittensor",
"snippet": "Bittensor (TAO) is a decentralized, open-source, and permissionless machine learning network that transforms machine intelligence into a tradable commodity.",
"title": "What is Bittensor?"
}
],
"youtube_search": [
{
"link": "https://www.youtube.com/watch?v=tDWhnsZB6XI",
"snippet": "In this video, I break down exactly how I'm maximizing my $TAO stack through smart staking strategies on the Bittensor network ...",
"title": "TAO (Bittensor) is PUMPING - how to make more profit with Staking 💰"
}
],
"tweets": [
{
"bookmark_count": 2,
"conversation_id": "1932946234920349827",
"created_at": "2025-06-11T23:41:09.000Z",
"display_text_range": [
0,
269
],
"entities": {
"hashtags": [],
"media": [
{
"display_url": "pic.x.com/L1icjTabYS",
"expanded_url": "https://x.com/HOSS_ibc/status/1932946234920349827/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": [
{
"h": 77,
"w": 77,
"x": 1877,
"y": 521
},
{
"h": 93,
"w": 93,
"x": 971,
"y": 571
}
]
},
"medium": {
"faces": [
{
"h": 45,
"w": 45,
"x": 1100,
"y": 305
},
{
"h": 55,
"w": 55,
"x": 569,
"y": 335
}
]
},
"orig": {
"faces": [
{
"h": 137,
"w": 137,
"x": 3301,
"y": 917
},
{
"h": 165,
"w": 165,
"x": 1708,
"y": 1005
}
]
},
"small": {
"faces": [
{
"h": 25,
"w": 25,
"x": 623,
"y": 173
},
{
"h": 31,
"w": 31,
"x": 322,
"y": 189
}
]
}
},
"id_str": "1932944082281574400",
"indices": [
270,
293
],
"media_key": "3_1932944082281574400",
"media_url_https": "https://pbs.twimg.com/media/GtMyZtMWMAAPfq9.jpg",
"original_info": {
"focus_rects": [
{
"h": 1800,
"w": 3214,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 1800,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 1579,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 900,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 3600,
"x": 0,
"y": 0
}
],
"height": 1800,
"width": 3600
},
"sizes": {
"large": {
"h": 1024,
"resize": "fit",
"w": 2048
},
"medium": {
"h": 600,
"resize": "fit",
"w": 1200
},
"small": {
"h": 340,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/L1icjTabYS"
}
],
"symbols": [
{
"indices": [
10,
14
],
"text": "TAO"
}
],
"timestamps": [],
"urls": [],
"user_mentions": []
},
"extended_entities": {
"media": [
{
"display_url": "pic.x.com/L1icjTabYS",
"expanded_url": "https://x.com/HOSS_ibc/status/1932946234920349827/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": [
{
"h": 77,
"w": 77,
"x": 1877,
"y": 521
},
{
"h": 93,
"w": 93,
"x": 971,
"y": 571
}
]
},
"medium": {
"faces": [
{
"h": 45,
"w": 45,
"x": 1100,
"y": 305
},
{
"h": 55,
"w": 55,
"x": 569,
"y": 335
}
]
},
"orig": {
"faces": [
{
"h": 137,
"w": 137,
"x": 3301,
"y": 917
},
{
"h": 165,
"w": 165,
"x": 1708,
"y": 1005
}
]
},
"small": {
"faces": [
{
"h": 25,
"w": 25,
"x": 623,
"y": 173
},
{
"h": 31,
"w": 31,
"x": 322,
"y": 189
}
]
}
},
"id_str": "1932944082281574400",
"indices": [
270,
293
],
"media_key": "3_1932944082281574400",
"media_url_https": "https://pbs.twimg.com/media/GtMyZtMWMAAPfq9.jpg",
"original_info": {
"focus_rects": [
{
"h": 1800,
"w": 3214,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 1800,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 1579,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 900,
"x": 0,
"y": 0
},
{
"h": 1800,
"w": 3600,
"x": 0,
"y": 0
}
],
"height": 1800,
"width": 3600
},
"sizes": {
"large": {
"h": 1024,
"resize": "fit",
"w": 2048
},
"medium": {
"h": 600,
"resize": "fit",
"w": 1200
},
"small": {
"h": 340,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/L1icjTabYS"
}
]
},
"id": "1932946234920349827",
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"like_count": 31,
"media": [
{
"media_url": "https://pbs.twimg.com/media/GtMyZtMWMAAPfq9.jpg",
"type": "photo"
}
],
"quote_count": 3,
"reply_count": 16,
"retweet_count": 3,
"text": "Bittensor $TAO seems oversold here.\n\nGrowth up but price is down\n\nPrice Valuation (Next 12 Months)\n\nFactors \n\nTechnical: Trading above 200-day MA; support at $350-$380. \n\nFundamental: Halving, subnet growth, institutional interest (e.g., Grayscale’s Bittensor Trust). \n\nSentiment: Strong staking (72%) and developer activity.\n\nForecast (Jun 2025-Jun 2026) \n\nConservative: $350-$600 \n\nBase: $600-$900 \n\nBullish: $900-$1,200",
"url": "https://x.com/HOSS_ibc/status/1932946234920349827",
"user": {
"can_dm": true,
"can_media_tag": false,
"created_at": "Sun Jul 18 05:20:07 +0000 2021",
"description": "Entrepreneur, Angel Investor & Product Advisor | 4+ years full-time in Crypto | 16+ years building businesses | Passionate about DeFi, Art & impactful content",
"entities": {
"description": {
"urls": []
},
"url": {
"urls": [
{
"display_url": "metimmerse.io/hoss",
"expanded_url": "https://metimmerse.io/hoss",
"indices": [
0,
23
],
"url": "https://t.co/kAQCAPyc7F"
}
]
}
},
"favourites_count": 163851,
"followers_count": 63156,
"id": "1416628772565143561",
"is_blue_verified": true,
"listed_count": 460,
"location": "Tweets aren't financial advice",
"media_count": 8421,
"name": "Hoss",
"pinned_tweet_ids": [
"1932920070222889063"
],
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1416628772565143561/1749700252",
"profile_image_url": "https://pbs.twimg.com/profile_images/1915178001026723840/s0MX6RPL_normal.jpg",
"statuses_count": 77157,
"url": "https://x.com/HOSS_ibc",
"username": "HOSS_ibc",
"verified": false
}
}
],
"text": "This is some additional text related to the search query.",
"miner_link_scores": {
"https://news.ycombinator.com/item?id=35114983": "MEDIUM",
"https://news.ycombinator.com/item?id=42684057": "MEDIUM"
},
"completion": "Bittensor is a decentralized, open-source machine learning network that transforms AI models into tradable commodities."
}Possible status codes: