API Reference
Desearch AI Search
API Reference
Desearch 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.
POST
/
desearch
/
ai
/
search
curl --request POST \
--url https://apis.datura.ai/desearch/ai/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Bittensor",
"tools": [
"Web Search",
"Hacker News Search",
"Reddit Search",
"Wikipedia Search",
"Youtube Search",
"Twitter Search",
"ArXiv Search"
],
"model": "NOVA",
"date_filter": "PAST_24_HOURS",
"streaming": true
}'{
"youtube_search_results": {
"organic_results": [
{
"title": "Did The FED Do The Impossible? [Huge Implications For Bitcoin]",
"link": "https://www.youtube.com/watch?v=Ycq1u2zWfr8",
"snippet": "Did we avoid a recession and is there still more upside for Bitcoin? GET MY FREE NEWSLETTER ...",
"summary_description": "Did The FED Do The Impossible? [Huge Implications For Bitcoin]"
}
]
},
"hacker_news_search_results": {
"organic_results": [
{
"title": "latest",
"link": "https://news.ycombinator.com/latest?id=42816511",
"snippet": "The streaming app for the Paris Olympics was a revolution from which I can never go back to OTA coverage. I watched so many more competitions ...",
"summary_description": ""
}
]
},
"reddit_search_results": {
"organic_results": [
{
"title": "6 New Sports at Los Angeles 2028 Olympics",
"link": "https://www.reddit.com/r/olympics/comments/1ert9av/6_new_sports_at_los_angeles_2028_olympics/",
"snippet": "Baseball and softball are not new olympic sports, but returning. Up to Tokyo, baseball was at every olympics since 1984 except London and Rio.",
"summary_description": ""
}
]
},
"arxiv_search_results": {
"organic_results": [
{
"title": "[2304.02655] Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications",
"link": "https://arxiv.org/abs/2304.02655",
"snippet": "Abstract page for arXiv paper 2304.02655: Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications",
"with_metadata": true,
"summary_description": "[2304.02655] Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications"
}
]
},
"wikipedia_search_results": {
"organic_results": [
{
"title": "List of bitcoin companies - Wikipedia",
"link": "https://en.wikipedia.org/wiki/List_of_Bitcoin_companies",
"snippet": "",
"with_metadata": true,
"summary_description": "List of bitcoin companies - Wikipedia"
}
]
},
"text_chunks": {
"twitter_summary": [
"<string>"
]
},
"search_completion_links": [
"https://www.youtube.com/watch?v=Ycq1u2zWfr8",
"https://news.ycombinator.com/latest?id=42816511",
"https://www.reddit.com/r/olympics/comments/1ert9av/6_new_sports_at_los_angeles_2028_olympics/",
"https://en.wikipedia.org/wiki/List_of_Bitcoin_companies"
],
"completion_links": [
"https://news.ycombinator.com/latest?id=42816511",
"https://www.youtube.com/watch?v=Ycq1u2zWfr8"
],
"completion": {
"key_posts": [
{
"text": "This is an example post text.",
"url": "https://x.com/example_post"
}
],
"key_tweets": [
{
"text": "This is an example tweet text.",
"url": "https://x.com/example_tweet"
}
],
"key_news": [
{
"text": "This is an example news text.",
"url": "https://news.example.com/123"
}
],
"key_sources": [
{
"text": "This is an example source text.",
"url": "https://www.example.com"
}
],
"twitter_summary": "This is an example Twitter summary.",
"summary": "This is an example summary.",
"reddit_summary": "This is an example summary.",
"hacker_news_summary": "This is an example summary."
}
}Authorizations
Body
application/json
Search query prompt
Example:
"Bittensor"
A list of tools to be used for the search
An enumeration.
Available options:
Web Search, Hacker News Search, Reddit Search, Wikipedia Search, Youtube Search, Twitter Search, ArXiv Search Example:
[
"Web Search",
"Hacker News Search",
"Reddit Search",
"Wikipedia Search",
"Youtube Search",
"Twitter Search",
"ArXiv Search"
]
The model to be used for the search
Available options:
NOVA, ORBIT, HORIZON Example:
"NOVA"
Whether to stream results
Example:
true
The date filter to be used for the search
Available options:
PAST_24_HOURS, PAST_2_DAYS, PAST_WEEK, PAST_2_WEEKS, PAST_MONTH, PAST_2_MONTHS, PAST_YEAR, PAST_2_YEARS Example:
"PAST_24_HOURS"
Response
200
application/json
A JSON object mapping tool names to their search results.
Example:
"Example Title"
Example:
"https://example.com"
Example:
"https://example.com/link"
Example:
"This is an example snippet from the search result."
Example:
"This is a summary description of the search result."
Example:
"Example Title"
Example:
"https://example.com"
Example:
"https://example.com/link"
Example:
"This is an example snippet from the search result."
Example:
"This is a summary description of the search result."
Example:
"Example Title"
Example:
"https://example.com"
Example:
"https://example.com/link"
Example:
"This is an example snippet from the search result."
Example:
"This is a summary description of the search result."
Example:
"Example Title"
Example:
"https://example.com"
Example:
"https://example.com/link"
Example:
"This is an example snippet from the search result."
Example:
"This is a summary description of the search result."
Example:
"Example Title"
Example:
"https://example.com"
Example:
"https://example.com/link"
Example:
"This is an example snippet from the search result."
Example:
"This is a summary description of the search result."
Example:
"This is an example Twitter summary."
Example:
"This is an example summary."
curl --request POST \
--url https://apis.datura.ai/desearch/ai/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Bittensor",
"tools": [
"Web Search",
"Hacker News Search",
"Reddit Search",
"Wikipedia Search",
"Youtube Search",
"Twitter Search",
"ArXiv Search"
],
"model": "NOVA",
"date_filter": "PAST_24_HOURS",
"streaming": true
}'{
"youtube_search_results": {
"organic_results": [
{
"title": "Did The FED Do The Impossible? [Huge Implications For Bitcoin]",
"link": "https://www.youtube.com/watch?v=Ycq1u2zWfr8",
"snippet": "Did we avoid a recession and is there still more upside for Bitcoin? GET MY FREE NEWSLETTER ...",
"summary_description": "Did The FED Do The Impossible? [Huge Implications For Bitcoin]"
}
]
},
"hacker_news_search_results": {
"organic_results": [
{
"title": "latest",
"link": "https://news.ycombinator.com/latest?id=42816511",
"snippet": "The streaming app for the Paris Olympics was a revolution from which I can never go back to OTA coverage. I watched so many more competitions ...",
"summary_description": ""
}
]
},
"reddit_search_results": {
"organic_results": [
{
"title": "6 New Sports at Los Angeles 2028 Olympics",
"link": "https://www.reddit.com/r/olympics/comments/1ert9av/6_new_sports_at_los_angeles_2028_olympics/",
"snippet": "Baseball and softball are not new olympic sports, but returning. Up to Tokyo, baseball was at every olympics since 1984 except London and Rio.",
"summary_description": ""
}
]
},
"arxiv_search_results": {
"organic_results": [
{
"title": "[2304.02655] Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications",
"link": "https://arxiv.org/abs/2304.02655",
"snippet": "Abstract page for arXiv paper 2304.02655: Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications",
"with_metadata": true,
"summary_description": "[2304.02655] Deciphering the Blockchain: A Comprehensive Analysis of Bitcoin's Evolution, Adoption, and Future Implications"
}
]
},
"wikipedia_search_results": {
"organic_results": [
{
"title": "List of bitcoin companies - Wikipedia",
"link": "https://en.wikipedia.org/wiki/List_of_Bitcoin_companies",
"snippet": "",
"with_metadata": true,
"summary_description": "List of bitcoin companies - Wikipedia"
}
]
},
"text_chunks": {
"twitter_summary": [
"<string>"
]
},
"search_completion_links": [
"https://www.youtube.com/watch?v=Ycq1u2zWfr8",
"https://news.ycombinator.com/latest?id=42816511",
"https://www.reddit.com/r/olympics/comments/1ert9av/6_new_sports_at_los_angeles_2028_olympics/",
"https://en.wikipedia.org/wiki/List_of_Bitcoin_companies"
],
"completion_links": [
"https://news.ycombinator.com/latest?id=42816511",
"https://www.youtube.com/watch?v=Ycq1u2zWfr8"
],
"completion": {
"key_posts": [
{
"text": "This is an example post text.",
"url": "https://x.com/example_post"
}
],
"key_tweets": [
{
"text": "This is an example tweet text.",
"url": "https://x.com/example_tweet"
}
],
"key_news": [
{
"text": "This is an example news text.",
"url": "https://news.example.com/123"
}
],
"key_sources": [
{
"text": "This is an example source text.",
"url": "https://www.example.com"
}
],
"twitter_summary": "This is an example Twitter summary.",
"summary": "This is an example summary.",
"reddit_summary": "This is an example summary.",
"hacker_news_summary": "This is an example summary."
}
}