Search
Search across multiple data sources with AI-powered summarization.
POST /22/search
Required attributes
- Name
prompt
- Type
- string
- Description
Search query text to run tools with
- Name
tools
- Type
- array
- Description
List of search tools to use for fetching data
- Name
model
- Type
- string
- Description
Model to use for scraping
Default:
NOVA
- Name
date_filter
- Type
- string
- Description
Time range filter for results
Default:
PAST_WEEK
- Name
streaming
- Type
- boolean
- Description
Whether to stream results
Default:
true
Optional attributes
- Name
result_type
- Type
- string
- Description
The result type for the search
Default:
LINKS_WITH_FINAL_SUMMARY
- Name
system_message
- Type
- string
- Description
Custom system message to be used for the search
Request
curl -X POST "https://api.bitmind.ai/oracle/v1/22/search" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"prompt": "",
"tools": [],
"model": "NOVA",
"date_filter": "PAST_WEEK",
"streaming": true,
"result_type": "LINKS_WITH_FINAL_SUMMARY",
"system_message": ""
}'
Response
{
"wikipedia_search_results": [],
"arxiv_search_results": [
{
"organic_results": [
{
"title": "Incentivized Learning in Decentralized Networks: A Case Study on Bittensor",
"link": "https://arxiv.org/abs/example123",
"snippet": "This paper examines Bittensor's approach to incentivizing machine learning model contributions in a decentralized network using blockchain technology and digital tokens as rewards.",
"summary_description": "Academic analysis of Bittensor's incentive mechanisms for decentralized machine learning"
}
]
}
],
"reddit_search_results": [
{
"organic_results": [
{
"title": "Technical Analysis: How Bittensor's Subnet Architecture Enables Specialized ML Tasks",
"link": "https://www.reddit.com/r/MachineLearning/comments/example1",
"snippet": "A detailed breakdown of how Bittensor's subnet system allows for specialized machine learning tasks to be performed within the larger network ecosystem.",
"summary_description": "Reddit discussion on the technical implementation of Bittensor's subnet architecture"
}
]
}
],
"hacker_news_search_results": [
{
"organic_results": [
{
"title": "Bittensor's Approach to Decentralized AI Development",
"link": "https://news.ycombinator.com/item?id=example456",
"snippet": "Discussion of Bittensor's technical approach to creating a decentralized marketplace for machine learning models and AI services.",
"summary_description": "Hacker News thread analyzing Bittensor's technical architecture and approach"
}
]
}
],
"completion": {
"summary": "Bittensor implements a decentralized approach to machine learning through several key technical mechanisms:\n\n1. **Subnet Architecture**: Bittensor organizes its network into 'subnets' - specialized areas where specific types of machine learning tasks occur. Each subnet has validators who evaluate the quality of models and miners who provide the actual computational resources.\n\n2. **Incentive Mechanism**: The network uses a digital token (TAO) to incentivize high-quality contributions. Models that provide valuable outputs receive rewards proportional to their utility to the network.\n\n3. **Consensus Through Validation**: Rather than traditional blockchain consensus, Bittensor implements a validation system where models compete to serve useful intelligence. Validators continuously assess the quality of outputs from miners.\n\n4. **Scalability Through Specialization**: By dividing the network into specialized subnets, Bittensor can scale to accommodate various AI tasks ranging from text generation to image recognition to scientific computing.\n\n5. **Open Participation**: Anyone can participate by running a mining node (contributing model outputs) or a validating node (evaluating outputs) without requiring permission.\n\nRecent developments include improvements to the validator scoring systems, enhanced security mechanisms to prevent gaming of the network, and the deployment of new specialized subnets focused on multimodal AI capabilities. The network continues to evolve with a focus on creating a truly decentralized intelligence market where AI services can be exchanged in an open ecosystem."
},
"completion_links": [
"https://arxiv.org/abs/example123",
"https://www.reddit.com/r/MachineLearning/comments/example1",
"https://news.ycombinator.com/item?id=example456",
"https://github.com/opentensor/bittensor",
"https://medium.com/examples/bittensor-technical-overview"
]
}
POST /22/search/links/web
Required attributes
- Name
prompt
- Type
- string
- Description
Search query prompt
- Name
tools
- Type
- array
- Description
List of tools to search with
Optional attributes
- Name
model
- Type
- string
- Description
Model to use for scraping
Default:
NOVA
Request
curl -X POST "https://api.bitmind.ai/oracle/v1/22/search/links/web" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"prompt": "",
"tools": [],
"model": "NOVA"
}'
Response
{
"youtube_search_results": [],
"hacker_news_search_results": [
{
"organic_results": [
{
"position": 1,
"title": "The Current State of Decentralized AI Development",
"link": "https://news.ycombinator.com/item?id=39876543",
"displayed_link": "news.ycombinator.com/item?id=39876543",
"favicon": "https://news.ycombinator.com/favicon.ico",
"date": "3 days ago",
"snippet": "An overview of progress in decentralized AI systems and their potential impact on how we build and deploy machine learning models.",
"source": "Hacker News",
"inline": [],
"summary_description": "Hacker News discussion on decentralized AI development trends"
}
]
}
],
"reddit_search_results": [
{
"organic_results": [
{
"position": 1,
"title": "Breakthrough in Decentralized Training Methods",
"link": "https://www.reddit.com/r/MachineLearning/comments/abc987",
"displayed_link": "reddit.com/r/MachineLearning/comments/abc987",
"favicon": "https://www.reddit.com/favicon.ico",
"date": "1 week ago",
"snippet": "Researchers have demonstrated a new approach to training large models across decentralized hardware with improved efficiency.",
"source": "Reddit",
"inline": [],
"summary_description": "Reddit post discussing new research in decentralized model training"
}
]
}
],
"wikipedia_search_results": [],
"arxiv_search_results": [],
"search_results": [
{
"organic_results": [
{
"position": 1,
"title": "The Rise of Decentralized AI Networks",
"link": "https://example-tech-blog.com/decentralized-ai-networks",
"displayed_link": "example-tech-blog.com/decentralized-ai-networks",
"favicon": "https://example-tech-blog.com/favicon.ico",
"date": "2 days ago",
"snippet": "Decentralized AI networks are gaining traction as alternatives to centralized cloud-based AI services, offering benefits in privacy, cost, and ownership.",
"source": "Tech Blog",
"inline": [],
"summary_description": "Overview of decentralized AI network development and adoption"
}
]
}
]
}
POST /22/search/links/twitter
Required attributes
- Name
prompt
- Type
- string
- Description
Search query prompt
Optional attributes
- Name
model
- Type
- string
- Description
Model to use for scraping
Default:
NOVA
Request
curl -X POST "https://api.bitmind.ai/oracle/v1/22/search/links/twitter" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"prompt": "",
"model": "NOVA"
}'
Response
{
"miner_tweets": [
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/AIResearcher",
"name": "AI Research Updates",
"username": "AIResearcher",
"created_at": "2020-05-15T14:30:15Z",
"description": "Sharing the latest in artificial intelligence research and development. Focus on neural networks and ML systems.",
"favourites_count": 3245,
"followers_count": 25600,
"listed_count": 120,
"media_count": 450,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/profile.jpg",
"statuses_count": 4321,
"verified": true,
"is_blue_verified": true,
"can_dm": false,
"can_media_tag": true,
"location": "Boston, MA"
},
"id": "9876543210",
"text": "The latest developments in decentralized AI show promising results for privacy-preserving machine learning. Community-owned models could be the future. #DecentralizedAI #MachineLearning",
"reply_count": 15,
"retweet_count": 87,
"like_count": 342,
"view_count": 12500,
"quote_count": 7,
"impression_count": 18750,
"bookmark_count": 42,
"url": "https://twitter.com/AIResearcher/status/9876543210",
"created_at": "2024-03-10T18:45:32Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543210",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null,
"quoted_status_id": null,
"quote": null,
"summary_description": "Discussion of privacy benefits in decentralized AI"
},
{
"user": {
"id": "2345678901",
"url": "https://twitter.com/TechFounder",
"name": "Tech Startup Insights",
"username": "TechFounder",
"created_at": "2019-07-22T09:15:42Z",
"description": "Founder of multiple tech startups. Sharing insights on emerging technologies and the future of tech.",
"favourites_count": 2156,
"followers_count": 32400,
"listed_count": 87,
"media_count": 320,
"profile_image_url": "https://pbs.twimg.com/profile_images/2345678901/founder.jpg",
"statuses_count": 3254,
"verified": true,
"is_blue_verified": true,
"can_dm": false,
"can_media_tag": true,
"location": "San Francisco, CA"
},
"id": "8765432109",
"text": "Just spoke at @AIConference about how decentralized AI networks could disrupt the current tech giants' monopoly on machine learning infrastructure. The slides from my talk are now available online. #FutureOfAI",
"reply_count": 28,
"retweet_count": 124,
"like_count": 567,
"view_count": 22480,
"quote_count": 12,
"impression_count": 29850,
"bookmark_count": 78,
"url": "https://twitter.com/TechFounder/status/8765432109",
"created_at": "2024-03-12T11:28:17Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "8765432109",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null,
"quoted_status_id": null,
"quote": null,
"summary_description": "Conference presentation about decentralized AI networks"
}
]
}
GET /22/twitter
Required attributes
- Name
query
- Type
- string
- Description
Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries
Example:
Bittensor
Optional attributes
- Name
sort
- Type
- string
- Description
Sort by Top or Latest
Example:
Top
- Name
user
- Type
- string
- Description
User to search for
- Name
start_date
- Type
- string
- Description
Start date in UTC (YYYY-MM-DD format)
- Name
end_date
- Type
- string
- Description
End date in UTC (YYYY-MM-DD format)
- Name
lang
- Type
- string
- Description
Language code (e.g., en, es, fr)
Example:
en
- Name
verified
- Type
- boolean
- Description
Filter for verified users
Example:
true
- Name
blue_verified
- Type
- boolean
- Description
Filter for blue checkmark verified users
- Name
is_quote
- Type
- boolean
- Description
Include only tweets with quotes
- Name
is_video
- Type
- boolean
- Description
Include only tweets with videos
- Name
is_image
- Type
- boolean
- Description
Include only tweets with images
- Name
min_retweets
- Type
- string
- Description
Minimum number of retweets
- Name
min_replies
- Type
- string
- Description
Minimum number of replies
- Name
min_likes
- Type
- string
- Description
Minimum number of likes
- Name
count
- Type
- string
- Description
Number of tweets to retrieve
Default:
20
Example:
10
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"query": "Bittensor",
"sort": "Top",
"user": "\"example-user\"",
"start_date": "\"example-start_date\"",
"end_date": "\"example-end_date\"",
"lang": "en",
"verified": true,
"blue_verified": false,
"is_quote": false,
"is_video": false,
"is_image": false,
"min_retweets": "\"example-min_retweets\"",
"min_replies": "\"example-min_replies\"",
"min_likes": "\"example-min_likes\"",
"count": 10
}'
Response
[
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "1234567891",
"text": "Join us tomorrow for our community call where we'll discuss the latest developments in our subnet architecture and upcoming features. Register now at https://example.com/register",
"reply_count": 5,
"retweet_count": 42,
"like_count": 128,
"view_count": 12500,
"quote_count": 2,
"url": "https://twitter.com/opentensor/status/1234567891",
"created_at": "2024-03-20T16:30:00Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567891"
},
{
"user": {
"id": "9876543210",
"url": "https://twitter.com/CryptoResearch",
"name": "Crypto Research Group",
"username": "CryptoResearch",
"created_at": "2019-08-10T12:45:30Z",
"description": "Independent research group focused on cryptocurrencies, blockchain technology, and decentralized systems.",
"favourites_count": 3450,
"followers_count": 42500,
"listed_count": 210,
"media_count": 560,
"profile_image_url": "https://pbs.twimg.com/profile_images/9876543210/research_logo.jpg",
"statuses_count": 5240,
"verified": true,
"is_blue_verified": true
},
"id": "9876543211",
"text": "Our latest research report analyzes the Bittensor network and its approach to incentivizing machine learning development through a decentralized marketplace. Read the full analysis here: https://example.com/bittensor-research",
"reply_count": 18,
"retweet_count": 75,
"like_count": 210,
"view_count": 15800,
"quote_count": 8,
"url": "https://twitter.com/CryptoResearch/status/9876543211",
"created_at": "2024-03-18T10:15:22Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543211"
}
]
GET /22/twitter/urls
Required attributes
- Name
urls
- Type
- array
- Description
List of urls that is to be retrieved
Example:
https://x.com/RacingTriple/status/1892527552029499853,https://x.com/elonmusk/status/1913232558805987451
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/urls" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://x.com/RacingTriple/status/1892527552029499853",
"https://x.com/elonmusk/status/1913232558805987451"
]
}'
Response
[
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/RacingTriple",
"name": "Racing Triple",
"username": "RacingTriple",
"created_at": "2020-05-15T10:22:34Z",
"description": "Motorsport news, updates, and analysis. Covering F1, MotoGP, NASCAR, and more.",
"favourites_count": 2345,
"followers_count": 12680,
"listed_count": 45,
"media_count": 287,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/racing_logo.jpg",
"statuses_count": 3687,
"verified": false,
"is_blue_verified": true
},
"id": "1892527552029499853",
"text": "New episode of The Motorsport Recently Show now out on YouTube and Spotify...",
"reply_count": 0,
"retweet_count": 0,
"like_count": 0,
"quote_count": 0,
"bookmark_count": 0,
"url": "https://x.com/RacingTriple/status/1892527552029499853",
"created_at": "Thu Feb 20 10:51:44 +0000 2025",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1892527552029499853",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null,
"quoted_status_id": null,
"quote": null,
"display_text_range": [
0,
166
],
"entities": {
"hashtags": [],
"symbols": [],
"timestamps": [],
"urls": [
{
"display_url": "open.spotify.com/episode/6lW29d…",
"expanded_url": "https://open.spotify.com/episode/6lW29dxjnWQPmSB5ilXnIi?si=a66a9c3b16bf41fe",
"indices": [
118,
141
],
"url": "https://t.co/N5oaoJRJx0"
},
{
"display_url": "youtu.be/0V1qT7ALPEE",
"expanded_url": "https://youtu.be/0V1qT7ALPEE",
"indices": [
143,
166
],
"url": "https://t.co/zdmk4zd13y"
}
],
"user_mentions": []
},
"extended_entities": {}
},
{
"user": {
"id": "44196397",
"url": "https://twitter.com/elonmusk",
"name": "Elon Musk",
"username": "elonmusk",
"created_at": "2009-06-02T20:12:29Z",
"description": "Technoking of Tesla, Chief Twit of X Corp",
"favourites_count": 20145,
"followers_count": 190000000,
"listed_count": 120345,
"media_count": 5432,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/elon_profile.jpg",
"statuses_count": 32456,
"verified": true,
"is_blue_verified": true
},
"id": "1892345678901234567",
"text": "AI is the future. We're making great progress with xAI.",
"reply_count": 5432,
"retweet_count": 12345,
"like_count": 98765,
"quote_count": 1234,
"bookmark_count": 5678,
"url": "https://x.com/elonmusk/status/1892345678901234567",
"created_at": "Thu Feb 19 15:30:22 +0000 2025",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1892345678901234567",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null,
"quoted_status_id": null,
"quote": null,
"display_text_range": [
0,
52
],
"entities": {
"hashtags": [],
"symbols": [],
"timestamps": [],
"urls": [],
"user_mentions": []
},
"extended_entities": {}
}
]
GET /22/twitter/post
Required attributes
- Name
id
- Type
- string
- Description
Post ID to retrieve
Example:
1234567891
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/post" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"id": "1234567891"
}'
Response
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/example_user",
"name": "Example User",
"username": "example_user",
"created_at": "2020-01-01T00:00:00Z",
"description": "This is an example user description.",
"favourites_count": 1000,
"followers_count": 5000,
"listed_count": 20,
"media_count": 100,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/example_profile.jpg",
"statuses_count": 2000,
"verified": false,
"is_blue_verified": true
},
"id": "1234567891",
"text": "This is an example tweet for the Twitter Post API endpoint.",
"reply_count": 10,
"retweet_count": 20,
"like_count": 100,
"quote_count": 5,
"bookmark_count": 15,
"url": "https://x.com/example_user/status/1234567891",
"created_at": "Thu Feb 20 10:00:00 +0000 2025",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567891",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null,
"quoted_status_id": null,
"quote": null,
"display_text_range": [
0,
58
],
"entities": {
"hashtags": [],
"symbols": [],
"timestamps": [],
"urls": [],
"user_mentions": []
},
"extended_entities": {}
}
GET /22/twitter/user/posts
Required attributes
- Name
user
- Type
- string
- Description
User to search for
Example:
opentensor
Optional attributes
- Name
query
- Type
- string
- Description
Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries
Example:
AI decentralized
- Name
count
- Type
- string
- Description
Number of tweets to retrieve
Default:
10
Example:
5
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/user/posts" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"user": "opentensor",
"query": "AI decentralized",
"count": 5
}'
Response
[
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "9876543210",
"text": "Excited to announce our latest research on decentralized machine learning networks. Our new paper explores how to optimize validator metrics for better model selection. #AI #DecentralizedAI",
"reply_count": 34,
"retweet_count": 156,
"like_count": 487,
"view_count": 28750,
"quote_count": 21,
"url": "https://twitter.com/opentensor/status/9876543210",
"created_at": "2024-03-15T14:22:36Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543210"
},
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "9876543211",
"text": "The future of AI is decentralized. Our growing community of developers is building the infrastructure for truly open machine learning. Join us and help shape this revolution.",
"reply_count": 28,
"retweet_count": 112,
"like_count": 346,
"view_count": 24100,
"quote_count": 15,
"url": "https://twitter.com/opentensor/status/9876543211",
"created_at": "2024-03-10T09:45:12Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543211"
}
]
GET /22/twitter/user/latest
Required attributes
- Name
user
- Type
- string
- Description
User to search for
Example:
opentensor
Optional attributes
- Name
count
- Type
- string
- Description
Number of tweets to retrieve
Default:
10
Example:
3
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/user/latest" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"user": "opentensor",
"count": 3
}'
Response
[
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "1234567891",
"text": "Join us tomorrow for our community call where we'll discuss the latest developments in our subnet architecture and upcoming features. Register now at https://example.com/register",
"reply_count": 5,
"retweet_count": 42,
"like_count": 128,
"view_count": 12500,
"quote_count": 2,
"url": "https://twitter.com/opentensor/status/1234567891",
"created_at": "2024-03-20T16:30:00Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567891"
},
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "1234567892",
"text": "Excited to announce our new partnership with @AIResearchLab to explore new applications of decentralized machine learning in scientific computing.",
"reply_count": 12,
"retweet_count": 87,
"like_count": 215,
"view_count": 18600,
"quote_count": 8,
"url": "https://twitter.com/opentensor/status/1234567892",
"created_at": "2024-03-19T10:15:32Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567892"
}
]
GET /22/twitter/user/replies
Required attributes
- Name
user
- Type
- string
- Description
The username of the user to search for
Example:
opentensor
Optional attributes
- Name
count
- Type
- string
- Description
The number of tweets to fetch
Default:
10
Example:
5
- Name
query
- Type
- string
- Description
Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries
Example:
subnet
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/user/replies" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"user": "opentensor",
"count": 5,
"query": "subnet"
}'
Response
[
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "1234567893",
"text": "@community_member Thanks for your question! The subnet deployment process is documented in our developer guide. Check out https://example.com/subnet-guide for step-by-step instructions.",
"reply_count": 2,
"retweet_count": 8,
"like_count": 42,
"view_count": 9600,
"quote_count": 0,
"url": "https://twitter.com/opentensor/status/1234567893",
"created_at": "2024-03-18T14:22:36Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543200",
"in_reply_to_screen_name": "community_member",
"in_reply_to_status_id": "9876543200",
"in_reply_to_user_id": "9876543200"
},
{
"user": {
"id": "1234567890",
"url": "https://twitter.com/opentensor",
"name": "Bittensor",
"username": "opentensor",
"created_at": "2020-04-15T16:22:34Z",
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"favourites_count": 1245,
"followers_count": 24680,
"listed_count": 78,
"media_count": 187,
"profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"statuses_count": 1687,
"verified": true,
"is_blue_verified": true
},
"id": "1234567894",
"text": "@developer_ai The subnet validation incentives are designed to reward high-quality machine learning models. Validators assess model outputs and distribute rewards based on utility to the network.",
"reply_count": 5,
"retweet_count": 12,
"like_count": 56,
"view_count": 11200,
"quote_count": 1,
"url": "https://twitter.com/opentensor/status/1234567894",
"created_at": "2024-03-17T09:45:12Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "9876543201",
"in_reply_to_screen_name": "developer_ai",
"in_reply_to_status_id": "9876543201",
"in_reply_to_user_id": "9876543201"
}
]
GET /22/twitter/post/replies
Required attributes
- Name
post_id
- Type
- string
- Description
The ID of the post to search for
Example:
1234567891
Optional attributes
- Name
count
- Type
- string
- Description
The number of tweets to fetch
Default:
10
Example:
5
- Name
query
- Type
- string
- Description
Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/post/replies" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"post_id": "1234567891",
"count": 5,
"query": ""
}'
Response
[
{
"user": {
"id": "9876543202",
"url": "https://twitter.com/ai_enthusiast",
"name": "AI Enthusiast",
"username": "ai_enthusiast",
"created_at": "2018-06-12T08:15:42Z",
"description": "Machine learning researcher and enthusiast. Interested in neural networks, reinforcement learning, and AI applications.",
"favourites_count": 2345,
"followers_count": 3250,
"listed_count": 45,
"media_count": 280,
"profile_image_url": "https://pbs.twimg.com/profile_images/9876543202/profile.jpg",
"statuses_count": 6520,
"verified": false,
"is_blue_verified": true
},
"id": "9876543203",
"text": "@opentensor Will the community call be recorded for those who can't attend live? Very interested in the subnet architecture updates!",
"reply_count": 1,
"retweet_count": 0,
"like_count": 5,
"view_count": 1200,
"quote_count": 0,
"url": "https://twitter.com/ai_enthusiast/status/9876543203",
"created_at": "2024-03-20T16:45:22Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567891",
"in_reply_to_screen_name": "opentensor",
"in_reply_to_status_id": "1234567891",
"in_reply_to_user_id": "1234567890"
},
{
"user": {
"id": "9876543204",
"url": "https://twitter.com/crypto_dev",
"name": "Crypto Developer",
"username": "crypto_dev",
"created_at": "2019-02-24T14:30:10Z",
"description": "Blockchain and crypto developer. Building decentralized applications and exploring new technologies.",
"favourites_count": 1870,
"followers_count": 2100,
"listed_count": 28,
"media_count": 145,
"profile_image_url": "https://pbs.twimg.com/profile_images/9876543204/profile.jpg",
"statuses_count": 3450,
"verified": false,
"is_blue_verified": false
},
"id": "9876543205",
"text": "@opentensor Looking forward to hearing about the subnet architecture improvements. Will there be any discussion about cross-subnet communication?",
"reply_count": 2,
"retweet_count": 1,
"like_count": 12,
"view_count": 1800,
"quote_count": 0,
"url": "https://twitter.com/crypto_dev/status/9876543205",
"created_at": "2024-03-20T16:58:35Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": false,
"lang": "en",
"conversation_id": "1234567891",
"in_reply_to_screen_name": "opentensor",
"in_reply_to_status_id": "1234567891",
"in_reply_to_user_id": "1234567890"
}
]
GET /22/twitter/post/retweets
Required attributes
- Name
post_id
- Type
- string
- Description
The ID of the post to search for
Example:
1234567891
Optional attributes
- Name
count
- Type
- string
- Description
The number of tweets to fetch
Default:
10
Example:
5
- Name
query
- Type
- string
- Description
Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/post/retweets" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"post_id": "1234567891",
"count": 5,
"query": ""
}'
Response
[
{
"user": {
"id": "9876543206",
"url": "https://twitter.com/ml_researcher",
"name": "ML Researcher",
"username": "ml_researcher",
"created_at": "2019-08-05T11:24:18Z",
"description": "Machine learning researcher focused on developing better AI systems. Working on neural networks and distributed computing.",
"favourites_count": 2780,
"followers_count": 5680,
"listed_count": 65,
"media_count": 320,
"profile_image_url": "https://pbs.twimg.com/profile_images/9876543206/profile.jpg",
"statuses_count": 4120,
"verified": false,
"is_blue_verified": true
},
"id": "9876543207",
"text": "RT @opentensor: Join us tomorrow for our community call where we'll discuss the latest developments in our subnet architecture and upcoming features. Register now at https://example.com/register",
"reply_count": 0,
"retweet_count": 3,
"like_count": 8,
"view_count": 2400,
"quote_count": 0,
"url": "https://twitter.com/ml_researcher/status/9876543207",
"created_at": "2024-03-20T16:48:12Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": true,
"lang": "en",
"conversation_id": "9876543207",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null
},
{
"user": {
"id": "9876543208",
"url": "https://twitter.com/blockchain_dev",
"name": "Blockchain Developer",
"username": "blockchain_dev",
"created_at": "2018-11-12T09:45:32Z",
"description": "Building the decentralized future. Blockchain engineer and decentralized AI enthusiast.",
"favourites_count": 1950,
"followers_count": 3450,
"listed_count": 42,
"media_count": 210,
"profile_image_url": "https://pbs.twimg.com/profile_images/9876543208/profile.jpg",
"statuses_count": 2870,
"verified": false,
"is_blue_verified": true
},
"id": "9876543209",
"text": "RT @opentensor: Join us tomorrow for our community call where we'll discuss the latest developments in our subnet architecture and upcoming features. Register now at https://example.com/register",
"reply_count": 0,
"retweet_count": 2,
"like_count": 5,
"view_count": 1800,
"quote_count": 0,
"url": "https://twitter.com/blockchain_dev/status/9876543209",
"created_at": "2024-03-20T17:15:45Z",
"media": [],
"is_quote_tweet": false,
"is_retweet": true,
"lang": "en",
"conversation_id": "9876543209",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_user_id": null
}
]
GET /22/twitter/user
Required attributes
- Name
user
- Type
- string
- Description
User to search for
Example:
opentensor
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/twitter/user" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"user": "opentensor"
}'
Response
{
"id": "1234567890",
"screen_name": "opentensor",
"is_blue_verified": true,
"following": false,
"can_dm": false,
"can_media_tag": true,
"created_at": "Wed Apr 15 16:22:34 +0000 2020",
"default_profile": false,
"default_profile_image": false,
"description": "Building the decentralized machine learning network. Join our community to help build the future of AI.",
"entities": {
"description": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": []
}
},
"fast_followers_count": 45,
"favourites_count": 1245,
"followers_count": 24680,
"friends_count": 320,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 78,
"location": "Decentralized",
"media_count": 187,
"name": "Bittensor",
"normal_followers_count": 24635,
"pinned_tweet_ids_str": [
"9876543210"
],
"possibly_sensitive": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1234567890/1656789012",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1234567890/bittensor_logo.jpg",
"profile_interstitial_type": "",
"statuses_count": 1687,
"translator_type": "none",
"verified": true,
"want_retweets": true,
"withheld_in_countries": []
}
GET /22/web
Required attributes
- Name
query
- Type
- string
- Description
The search query string
Example:
Bittensor machine learning
- Name
num
- Type
- integer
- Description
Count of results to get
Example:
5
- Name
start
- Type
- integer
- Description
How many results to skip (used for pagination with num)
Example:
1
Request
curl -X GET "https://api.bitmind.ai/oracle/v1/22/web" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"query": "Bittensor machine learning",
"num": 5,
"start": 1
}'
Response
{
"data": [
{
"title": "Bittensor: A Peer-to-Peer Intelligence Market",
"snippet": "Bittensor is an open-source protocol that powers a decentralized network of machine learning models. It allows anyone to build and connect machine learning systems, competing to provide the best intelligence to users.",
"link": "https://bittensor.com/",
"date": "2 days ago",
"source": "Bittensor",
"author": null,
"image": "https://bittensor.com/images/logo.png",
"favicon": "https://bittensor.com/favicon.ico",
"highlights": [
"Bittensor",
"machine learning",
"decentralized network"
]
},
{
"title": "Understanding Bittensor: The Decentralized Machine Learning Network",
"snippet": "Bittensor creates a market where machine learning models can be trained collectively, with participants earning rewards based on the quality of their contributions to the network. This innovative approach aims to democratize artificial intelligence.",
"link": "https://medium.com/example-blog/understanding-bittensor-decentralized-ml",
"date": "3 weeks ago",
"source": "Medium",
"author": "AI Researcher",
"image": "https://medium.com/images/example-bittensor.jpg",
"favicon": "https://medium.com/favicon.ico",
"highlights": [
"Bittensor",
"machine learning",
"decentralized",
"artificial intelligence"
]
},
{
"title": "How Bittensor's Decentralized Neural Network Is Changing AI",
"snippet": "The Bittensor network uses a unique consensus mechanism where machine learning models compete to serve valuable intelligence to the network. Models that provide useful outputs are rewarded with the network's native token, TAO.",
"link": "https://www.example-tech-journal.com/articles/bittensor-changing-ai",
"date": "1 month ago",
"source": "Tech Journal",
"author": "Tech Reporter",
"image": "https://www.example-tech-journal.com/images/bittensor-article.jpg",
"favicon": "https://www.example-tech-journal.com/favicon.ico",
"highlights": [
"Bittensor",
"decentralized",
"neural network",
"AI"
]
}
]
}
Last updated: April 24, 2025