Matches, clubs, and lineups

Football API

Live and upcoming matches, then the lineup and the club. Pass a date as YYYYMMDD, then a match id. Match prices are a read, not a place to bet.

Get an API key View documentation

Capabilities

Matches, clubs, and players

For live boards and club pages. Pass a date as YYYYMMDD, then a match id. Match prices are a read, not a bet.

What is on now

Live matches, upcoming matches, and matches for a date are three ways in. The date is YYYYMMDD. See examples

Search

Search returns players and clubs that match the name, with the ids the other calls expect.

One match

The match, its lineup, its events, its stats, the preview, and the head-to-head are separate calls on the same match id.

The club

A club comes back with its competition, its ground, and its coach. The squad is the next call. See examples

The player

A player call is the profile. Summary, defensive, offensive, passing, and goals are further splits.

Transfers and prices

Transfers are their own call. One match call returns the prices attached to that match. You can read them. You cannot place a bet here.

How a call is made

The path

The key goes in the Authorization header as a bearer token. The live list is the way in.

What is on

GET /api/v1/football/matches-live and /api/v1/football/matches-upcoming take date as YYYYMMDD. Leave it off for today in America/New_York.

One match

The match id from that list is matchId. The lineup, events, stats, preview, head-to-head, and betting prices all take that id.

A name

GET /api/v1/football/search requires search, at least two characters. A club profile then takes teamId.

Shortened examples

Sample responses

Shortened examples of a live match, a club, a lineup, an event, a player, and a search. The minute and the score are the ones in the sample.

{
    "matchId": 6280450,
    "status": "live",
    "minute": "18",
    "score": "0 - 1",
    "home": {
        "name": "Maldives",
        "score": 0
    },
    "away": {
        "name": "Lebanon",
        "score": 1
    },
    "startTime": "2026-10-01T14:00:00.000Z"
}
{
    "teamId": 9879,
    "name": "Fulham",
    "formation": "4-2-3-1",
    "coach": {
        "name": "Álvaro Arbeloa"
    },
    "starters": [
        {
            "name": "Bernd Leno",
            "shirtNumber": "1",
            "country": "Germany"
        }
    ]
}
{
    "playerId": 737066,
    "name": "Erling Haaland",
    "age": "26",
    "shirtNumber": 9,
    "country": "Norway",
    "team": {
        "name": "Manchester City"
    },
    "position": {
        "primary": "Striker"
    },
    "marketValue": "€98.8m"
}
{
    "teamId": 9825,
    "name": "Arsenal",
    "countryCode": "ENG",
    "primaryTournament": {
        "name": "Premier League"
    },
    "season": "2026/2027",
    "venue": {
        "name": "Emirates Stadium",
        "city": "London"
    },
    "coach": {
        "name": "Mikel Arteta"
    }
}
{
    "minute": 45,
    "type": "card",
    "side": "home",
    "player": {
        "name": "Joshua King"
    },
    "card": "Yellow"
}
{
    "players": [
        {
            "playerId": 1035614,
            "name": "Manuel Ugarte",
            "teamName": "Manchester United"
        }
    ],
    "teams": [
        {
            "teamId": 10260,
            "name": "Manchester United",
            "tournamentName": "Premier League"
        }
    ]
}

Before you integrate

Common questions

Short answers about dates, ids, and what this feed does not do.

JSON for a list of matches, one match, a club, or a player. The lineup and the events are further calls on the same matchId.

One call, match-betting, returns the prices attached to a match. It is a read of that feed. It does not place a bet.

No. The live-match sample keeps the minute and the score from the example, so you can see the fields.

YYYYMMDD, with no dashes. That is different from the baseball and hockey dates, which use YYYY-MM-DD.

Search by name, then pass the teamId from that response to /api/v1/football/team. The squad is /api/v1/football/team-squad.

Documentation

Live matches, lineups, and clubs are in the football docs, in four languages.

View documentation

Code samples

A sample for each endpoint, in Shell, JavaScript, PHP, and Python.

View documentation

Related APIs

Also in the catalog

Other feeds on the same key. Open one if this page isn't quite what you needed.

Baseball

Clubs, the day's schedule, and the box score for a single game. It's the published record of the game. Baseball API

Hockey

Tonight's games, the standings, and a club's roster. You get the score. Betting lines are not in this feed. Hockey API

Markets

Quotes, price history, option chains, and the earnings and dividend calendars. The right feed when the job is prices. Stock and Options API

Pricing

Same plans, whole catalog

Plans cover the whole SteadyAPI catalog, not only this API. The monthly allowance is on the table. For a larger volume, email [email protected].

Starter
$14.95
$19.95
per month
Developer Popular
$39.95
$59.95
per month
Business
$89.95
$99.95
per month
Enterprise
$299.95
$499.95
per month
Start 7-Day TrialStart 7-Day TrialStart 7-Day TrialStart 7-Day Trial
Requests per month10,00050,000250,0002,500,000
Stock Market API
Options Data API
Crypto Data API
AliExpress API
Reddit API
Booking.com API
Real Estate API
Baseball (MLB) API
Hockey API
Football API
Amazon API
eBay API
Walmart API
Instagram API
Twitter / X API
TikTok API
YouTube API
AutoHub API
ScrapeFlow
Commercial Use
Optional overage rate*$1.50 per 1,000 requests$1.05 per 1,000 requests$0.50 per 1,000 requests$0.09 per 1,000 requests
Overage capup to 50,000 extraup to 250,000 extraup to 1,250,000 extraup to 12,500,000 extra
Starter
$11.96
$14.35
per month$143.52 billed yearly
Developer Popular
$31.96
$40.00
per month$383.52 billed yearly
Business
$71.96
$90.00
per month$863.52 billed yearly
Enterprise
$320.83
$400.00
per month$3,849.95 billed yearly
Start 7-Day TrialStart 7-Day TrialStart 7-Day TrialStart 7-Day Trial
Requests per month10,00050,000250,0002,500,000
Stock Market API
Options Data API
Crypto Data API
AliExpress API
Reddit API
Booking.com API
Real Estate API
Baseball (MLB) API
Hockey API
Football API
Amazon API
eBay API
Walmart API
Instagram API
Twitter / X API
TikTok API
YouTube API
AutoHub API
ScrapeFlow
Commercial Use
Optional overage rate*$1.50 per 1,000 requests$1.05 per 1,000 requests$0.50 per 1,000 requests$0.09 per 1,000 requests
Overage capup to 50,000 extraup to 250,000 extraup to 1,250,000 extraup to 12,500,000 extra

* Overage stays off until you turn it on in Billing, and only for Stripe card subscriptions. Usage is counted in monthly periods that start on your billing day, yearly plans included. Requests past the included limit are billed after the period ends, up to the cap. If you switch plans during a period, the limit and overage rate of the plan you are on when that period ends apply to the whole period.

Why SteadyAPI

The list, then the match

Live and upcoming calls return match ids. Lineups and events take that id.

List, then match

Live and upcoming calls return match ids. The lineup, events, and stats take that id.

Search when you have a name

A club or player name goes through search. The id in that response is what the profile calls expect.

The heavy splits are optional

Team and player splits are there when a table needs them. A scoreboard does not.

Your monthly plan

A live list and a lineup count separately against the plan on the account.

Also on the blog

From the blog

These posts come from across SteadyAPI, so the one at the top may be about a different API. The reference for this page is the documentation above.

How to Read TikTok Video Comments Using SteadyAPIOct 05, 2026

How to Read TikTok Video Comments Using SteadyAPI

Read TikTok comments 20 at a time. Video 7106594312292453675 has 1269 comments. The next cursor is the string 20.

READ MORE
How to Look Up a Crypto Profile Using SteadyAPIOct 09, 2026

How to Look Up a Crypto Profile Using SteadyAPI

Look up one coin by slug. Store the symbol, status, and website list. Quotes are a later call and use data, not body.

READ MORE
How to Read Stock Financials Using SteadyAPIOct 09, 2026

How to Read Stock Financials Using SteadyAPI

Annual income, balance sheet, and cash flow for one ticker. Amounts come back as formatted strings in three tables.

READ MORE
How to Check Vehicle Recalls Using SteadyAPIOct 08, 2026

How to Check Vehicle Recalls Using SteadyAPI

Learn how to check vehicle recalls with SteadyAPI. Read component, summary, and remedy for a vehicle id.

READ MORE