5DollarFootballAPI Countries API
The country master referenced by league and team records.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/5dollarfootballapi:5dollarfootballapi-countries-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: 5DollarFootballAPI — Football Data Countries API
version: 1.0.0
summary: 'Football (soccer) data: live scores, fixtures, standings, corner and card statistics, and odds.'
description: The 5DollarFootballAPI is a read-only REST API.
termsOfService: https://5dollarfootballapi.com/terms
contact:
name: 5DollarFootballAPI support
url: https://5dollarfootballapi.com/contact
email: contact@5dollarfootballapi.com
servers:
- url: https://api.5dollarfootballapi.com/v1
description: Production
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Countries
description: The country master referenced by league and team records.
paths:
/countries:
get:
operationId: countries
summary: List countries
description: The country master referenced by league and team country_id.
tags:
- Countries
parameters:
- name: search
in: query
required: false
description: Match on country name.
schema:
type: string
- name: lang
in: query
required: false
description: Localize country names (21 languages besides English, e.g. zh-cn, zh-tw, ja, es, de, pt). Unrecognized non-country rows fall back to English.
schema:
type: string
- name: page
in: query
required: false
description: Pagination.
schema:
type: integer
- name: per_page
in: query
required: false
description: Pagination.
schema:
type: integer
responses:
'200':
description: Success
headers:
X-RateLimit-Limit:
description: Requests allowed in the current window.
schema:
type: integer
X-RateLimit-Remaining:
description: Requests left in the current window.
schema:
type: integer
X-RateLimit-Reset:
description: Unix timestamp when the window resets.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/SuccessEnvelope'
example:
success: 1
data:
- id: 14
name: England
continent_id: 3
- id: 26
name: Spain
continent_id: 3
- id: 7
name: Brazil
continent_id: 5
pagination:
page: 1
per_page: 50
count: 3
has_more: true
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'401':
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'403':
description: The resource is outside your plan.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
'500':
description: Unexpected server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
externalDocs:
description: Endpoint reference
url: https://5dollarfootballapi.com/docs/countries
components:
schemas:
ErrorEnvelope:
type: object
description: Every error response. The status code and `error.code` identify the failure; `message` is for humans.
required:
- success
- error
properties:
success:
type: integer
const: 0
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
description: Error family, e.g. authentication_error.
code:
type: string
description: Machine-readable code, e.g. missing_api_key.
message:
type: string
param:
type:
- string
- 'null'
description: The parameter at fault, when one applies.
doc_url:
type: string
request_id:
type: string
description: Quote this in support requests.
Pagination:
type: object
description: Returned by list endpoints. Keep requesting pages while `has_more` is true.
properties:
page:
type: integer
per_page:
type: integer
count:
type: integer
description: Rows on this page.
has_more:
type: boolean
SuccessEnvelope:
type: object
description: Every successful response. `data` is the endpoint payload — see the example on each operation. List endpoints add `pagination`.
required:
- success
- data
properties:
success:
type: integer
const: 1
data:
description: 'Endpoint payload: an object, or an array of objects on list endpoints.'
oneOf:
- type: object
- type: array
items:
type: object
pagination:
$ref: '#/components/schemas/Pagination'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Send your key as `Authorization: Bearer <key>`.'
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: Alternative to the Authorization header.
externalDocs:
description: Full documentation
url: https://5dollarfootballapi.com/docs