Skip to content

DEVELOPER API

Football Intelligence for Developers

13,500+ entities, 81,000+ graph edges, 11 leagues. Build smarter football apps.

Get Free API KeyView Docs

FREE TIER

Start building now. No credit card.

50 requests per day. Entity search, live scores, connection lookup, and league standings included.

HackathonsResearchPrototypesSide projects

Perfect for hackathons, research, and prototypes.

ENDPOINTS

What you can build with

GET/api/v1/search?q={query}

Search 13,500+ entities across players, coaches, clubs, and agents.

REQUEST

curl "https://the-graphs.com/api/v1/search?q=Vinicius"

RESPONSE

{
  "results": [
    { "id": "ent_4821", "name": "Vinicius Jr", "type": "player", "club": "Real Madrid" },
    { "id": "ent_9103", "name": "Vinicius Souza", "type": "player", "club": "Sheffield United" }
  ],
  "total": 2
}
GET/api/v1/live

Live scores and today's fixtures across all 11 leagues.

REQUEST

curl "https://the-graphs.com/api/v1/live"

RESPONSE

{
  "live": [
    { "home": "Barcelona", "away": "Atletico Madrid", "score": "2-1", "minute": 67 }
  ],
  "upcoming": 4
}
GET/api/v1/connections/{A}/{B}

Graph connections between two entities — shared agents, clubs, events.

REQUEST

curl "https://the-graphs.com/api/v1/connections/ent_4821/ent_1190"

RESPONSE

{
  "entityA": "Vinicius Jr",
  "entityB": "Rodrygo",
  "paths": [
    { "via": "Real Madrid", "type": "teammates", "weight": 0.92 }
  ]
}
GET/api/v1/league/{id}

League standings, top scorers, and recent form for any of 11 leagues.

REQUEST

curl "https://the-graphs.com/api/v1/league/laliga"

RESPONSE

{
  "league": "La Liga",
  "standings": [
    { "pos": 1, "team": "Barcelona", "pts": 78, "gd": 47 },
    { "pos": 2, "team": "Real Madrid", "pts": 74, "gd": 39 }
  ]
}
GET/api/v1/team/{id}PRO

Full team intelligence — squad, form, graph connections, upcoming fixtures.

REQUEST

curl -H "Authorization: Bearer tk_pro_..." "https://the-graphs.com/api/v1/team/real-madrid"

RESPONSE

{
  "team": "Real Madrid",
  "form": ["W","W","D","W","L"],
  "signals_active": 3,
  "graph_connections": 412
}
GET/api/v1/signalsPRO

Live story signals detected from the knowledge graph — transfers, tactical shifts, rivalries.

REQUEST

curl -H "Authorization: Bearer tk_pro_..." "https://the-graphs.com/api/v1/signals"

RESPONSE

{
  "signals": [
    { "type": "transfer", "confidence": 0.87, "summary": "Nico Williams link to Barcelona strengthens", "detected_at": "2026-04-01T08:12:00Z" }
  ],
  "total": 14
}

PRICING

Simple, transparent pricing

Free

$0forever

50 requests / day

  • ✓Entity search
  • ✓Live scores & fixtures
  • ✓Connection lookup
  • ✓League standings
  • ✓Community support
Get Free Key
MOST POPULAR

Pro

$4/ month

5,000 requests / day

  • ✓Everything in Free
  • ✓Team intelligence
  • ✓Story signals from graph
  • ✓Historical data access
  • ✓Priority support
Start Pro Trial

Enterprise

Contact us

Unlimited

  • ✓Everything in Pro
  • ✓Dedicated support
  • ✓Custom endpoints
  • ✓SLA guarantee
  • ✓Bulk data exports
Talk to Us

MCP INTEGRATION

Works with AI assistants

Add THE GRAPHS as an MCP server in Claude, ChatGPT, or any AI tool that supports the Model Context Protocol.

MCP CONFIG

{
  "mcpServers": {
    "the-graphs": {
      "url": "https://the-graphs.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ready to build?

Sign up for a free API key and start querying the graph in minutes.