All SportFeeds API endpoints require authentication via the Authorization header.

curl -H "Authorization: YOUR_API_KEY" "https://api.sportfeeds.com/v1/posts?leagues=NFL"

Key delivery modes

Each key is fixed to one delivery mode when it is created, so a single account can run Direct and Sync side by side. Keys created before delivery modes shipped stay flexible and behave exactly as they always have — nothing to migrate.

Manage your keys, and choose a mode for new ones, from the Dashboard.

/agents.md is a complete, agent-ready integration guide: authentication, every parameter, league and sport codes, ID translation, the engagement rating, error handling, quota hygiene, polling patterns, a ready-made tool schema, and TypeScript/Python reference clients. Drop it into your repo and a coding agent can integrate SportFeeds without further instruction.

mkdir -p docs && curl -s https://sportfeeds.com/agents.md \
  -o docs/sportfeeds-agents.md

## SportFeeds API
Full integration guide: @docs/sportfeeds-agents.md

- Base URL: https://api.sportfeeds.com/v1 — the ONLY content endpoint is GET /posts.
- Auth: header "Authorization: Bearer $SPORTFEEDS_API_KEY". Server-side only.
- List params are PLURAL and comma-separated: leagues=, sports=, teams=, players=, sources=.
- Never call /posts/leagues, /posts/teams, /posts/players, /posts/games,
  /posts/nearby or /posts/trending — they return 410.
- "football" means soccer; the NFL game is "americanfootball".
- Poll incrementally with since=<created_at of newest post seen>. Never re-page history.
- If a response has a non-empty warnings[] array, the query is wrong — fix it, don't ship it.

mkdir -p .cursor/rules && curl -s https://sportfeeds.com/agents.md \
  -o .cursor/rules/sportfeeds.md

https://your-domain.com/video-proxy?url=%3Cmedia.url%3E

Retrieve your company information, billing cycle, and current API usage. Free — call as often as needed.

{
  "company": { "name": "Acme Sports Inc", "plan": "paid", "subscription_status": "active" },
  "billing_cycle": {
    "current_period_start": "2026-02-07T20:16:36+00:00",
    "current_period_end":   "2026-03-07T20:16:36+00:00"
  },
  "usage": { "current_calls": 12450 }
}

Returns post IDs that should be deleted from your storage to remain compliant with the X platform's developer agreement. Recommended polling cadence depends on your plan (daily / weekly / monthly).

{
  "ids_to_delete": ["1846572934857291245", "1846572934857291246"],
  "as_of": "2026-04-30T05:00:00Z"
}

Returns every source your account can query, tagged as default (globally available) or custom (added to your company). Each source includes a geo_availability block listing ISO 3166-1 alpha-2 country codes where the source is explicitly viewable or blocked. Includes a counts block for quick verification. Available on paid plans, which see their own custom sources; enterprise accounts also receive the full default catalogue. Sandbox accounts get a 403.

A source's source_type can change from custom to default over time. When a customer-added handle proves broadly useful, SportFeeds promotes it into the standard catalog: posts keep flowing, the response shape is unchanged, and the handle stops counting toward your custom source limit. After promotion its sport, league and geo settings are managed by SportFeeds. Treat source_type as a current-state field, not a stable identifier.

{
  "ok": true,
  "counts": { "total": 185, "default": 177, "custom": 8 },
  "sources": [
    {
      "platform": "X",
      "username": "acme_custom",
      "name": "Acme Custom Feed",
      "type": null,
      "league": "multiple",
      "source_type": "custom",
      "geo_availability": {
        "viewable": ["US", "CA"],
        "blocked": []
      }
    },
    {
      "platform": "X",
      "username": "nba",
      "name": "NBA",
      "type": "league",
      "league": "NBA",
      "source_type": "default",
      "geo_availability": {
        "viewable": [],
        "blocked": ["ZA"]
      }
    }
  ]
}

One endpoint for all ID lookups. Pass entity to choose teams, players, leagues, or posts.

List all teams in a league. Returned alphabetically by location. Auto-paginated up to 1,000 per call.

{
  "ok": true,
  "count": 32,
  "items": [
    {
      "sportfeeds_id": 12000045,
      "location": "Atlanta",
      "name": "Falcons",
      "conference": null,
      "division": null,
      "league": "NFL",
      "sportradar_id": "e6aa13a4-0055-48a9-bc41-be28dc106929"
    }
  ]
}