Search

Search across multiple data sources with AI-powered summarization.


POST/v1/22/search

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

POST
/v1/22/search
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/v1/22/search/links/web

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

POST
/v1/22/search/links/web
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/v1/22/search/links/twitter

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

POST
/v1/22/search/links/twitter
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/v1/22/twitter

GET /22/twitter

Required attributes

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

GET
/v1/22/twitter
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/v1/22/twitter/urls

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

GET
/v1/22/twitter/urls
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/v1/22/twitter/post

GET /22/twitter/post

Required attributes

  • Name
    id
    Type
    string
    Description

    Post ID to retrieve

    Example: 1234567891

Request

GET
/v1/22/twitter/post
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/v1/22/twitter/user/posts

GET /22/twitter/user/posts

Required attributes

  • Name
    user
    Type
    string
    Description

    User to search for

    Example: opentensor

Optional attributes

Request

GET
/v1/22/twitter/user/posts
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/v1/22/twitter/user/latest

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

GET
/v1/22/twitter/user/latest
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/v1/22/twitter/user/replies

GET /22/twitter/user/replies

Required attributes

  • Name
    user
    Type
    string
    Description

    The username of the user to search for

    Example: opentensor

Optional attributes

Request

GET
/v1/22/twitter/user/replies
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/v1/22/twitter/post/replies

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

Request

GET
/v1/22/twitter/post/replies
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/v1/22/twitter/post/retweets

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

Request

GET
/v1/22/twitter/post/retweets
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/v1/22/twitter/user

GET /22/twitter/user

Required attributes

  • Name
    user
    Type
    string
    Description

    User to search for

    Example: opentensor

Request

GET
/v1/22/twitter/user
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/v1/22/web

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

GET
/v1/22/web
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