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

Authorization
string
header
required

Body

application/json
prompt
string
required

Search query prompt

Example:

"Bittensor"

tools
enum<string>[]
required

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"
]
model
enum<string>
required

The model to be used for the search

Available options:
NOVA,
ORBIT,
HORIZON
Example:

"NOVA"

streaming
boolean
required

Whether to stream results

Example:

true

date_filter
enum<string>

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.
wikipedia_search_results
youtube_search_results
arxiv_search_results
reddit_search_results
hacker_news_search_results
text_chunks
completion
object