LogoLogo
  • Welcome
  • News and updates
  • Subnet Status Update
  • Macromedia
  • Bittensor
    • DTAO
  • SUBNETS
    • Subnet 1 - Apex
      • Subnet 1: How to use APEX
      • Subnet 1: Incentive Mechanism
      • Subnet 1: Base Miner Setup
      • Subnet 1: Roadmap
    • Subnet 9 - Pre-training
      • Subnet 9: How to use Pre-training
      • Subnet 9: Incentive Mechanism
      • Subnet 9: Roadmap
    • Subnet 13 - Data Universe
      • Subnet 13: How to use Data Universe
      • Subnet 13: Incentive Mechanism
      • Subnet 13: Roadmap
      • Subnet 13 API
    • Subnet 25 - Mainframe
      • Subnet 25: How to use Mainframe
      • Subnet 25: Incentive Mechanism
      • Subnet 25: Roadmap
  • Subnet 37 - Finetuning
    • Subnet 37: How to use Fine-Tuning
    • Subnet 37: Miners
    • Subnet 37: Validators
    • Subnet 37: Incentive Mechanism
    • Subnet 37: Competitions
    • Subnet 37: Roadmap
  • CONSTELLATION - USER GUIDES
    • Apex
      • Navigating Apex
      • FAQs
    • Gravity
      • Scraping data
      • Managing and Collecting your data
      • FAQs
    • Nebula
      • Explore Nebula
      • Analyzing data
  • Developers
    • API Documentation
      • Accessing API Keys
      • SN1 - APEX
        • Endpoints
        • Example Usage
        • Agentic Tasks
        • Supported Models
      • SN13 - Data Universe
        • Endpoints
        • Example usage
        • Scraping Youtube Data
      • SN25 - Mainframe
        • API Keys
        • Folding API
          • Running Folding API Server
          • Endpoints
        • Organic API
          • Endpoints
    • Macrocosmos SDK
      • Installation
      • API Keys
      • APEX
      • Gravity
    • Tools
      • Macrocosmos MCP
      • Developer Projects
Powered by GitBook
On this page
  • What is Gravity?
  • Base URL: https://sn13.api.macrocosmos.ai
  • Gravity's APIs
  • Rate limits
  • Need Help?
  1. Developers
  2. API Documentation

SN13 - Data Universe

Getting started - Data Scraping on Macrocosms

PreviousSupported ModelsNextEndpoints

Last updated 3 days ago

Gravity is an on-demand data scraping application, allowing developers and business owners to access timely, relevant, and decentralized data from various sources like Twitter (X), Reddit, Youtube and Hugging Face repositories.


What is Gravity?

SN13 - Gravity is designed for real-time data retrieval. You can:

  • Fetch recent posts by accounts (e.g. Elon Musk mentioning "space")

  • Search Reddit using keywords or specific subreddits

  • Discover Hugging Face repositories deployed by miners

  • Launch incentivized scraping tasks for specific keywords (miners get rewarded for collecting the data you request)

Try the visual interface at


Base URL: https://sn13.api.macrocosmos.ai

The SN13 Gravity API is designed for data collection across social platforms, including Reddit and Twitter (X). You can create data collection tasks, monitor their progress, build and retrieve structured datasets upon completion. Each task is registered on the network and remains active for seven days, after which the compiled dataset becomes available for download. You can access these operations through the GravityClient in the Macrocosmos SDK.


Gravity's APIs

The SN13 API is organized around a few endpoints:

  • POST /api/v1/on_demand_data_request Query X or Reddit for real-time, validated posts matching keywords, usernames, and timeframes.

  • POST /api/v1/set_desirabilities Create tasks that miners will prioritize scraping.

  • GET /api/v1/list_repo_names List Hugging Face models published by SN13 miners.


Rate limits

Regular API keys: Limited to 100 requests per hour Validator key: Limited to 1000 requests per hour

Need Help?

Join the and drop into the #sn13-data-universe channel — we’re happy to help you get started.

Mission Command
Macrocosmos Discord