n8n Community Node

The Sportmonks Football API v3 is available as an open-source community node for n8n, the workflow automation platform. Built and maintained by Arthur Rahimov, the node lets you use Sportmonks data inside n8n workflows without writing any API integration code.

The package is published on npm and the source is available on GitHub. It is built and signed on GitHub Actions with a public transparency log.

What is n8n?

n8n is an open-source, node-based workflow automation platform. It lets you connect services, automate tasks, and build data pipelines using a visual canvas. It supports self-hosting and n8n Cloud, and has over 400 built-in integrations alongside a community node ecosystem of nearly 2,000 packages.

Resources and operations

The node provides 28 actions across seven resources:

Resource	Operations
Livescores	Get Inplay, Get All Today, Get Latest Updated
Fixture	Get by ID, Get by Date, Get by Date Range, Get by Date Range for Team, Head to Head, Latest Updated, Search by Name
Team	Get by ID, Get by Season, Get by Country, Search by Name
Player	Get by ID, Get by Country, Search by Name
League	Get All, Get by ID, Get by Country, Get Live, Search by Name
Standing	Get by Season ID, Get Live by League ID
Season	Get All, Get by ID, Get by Team, Search by Name

Include selector

Most operations support the Sportmonks include system. The node exposes a full include selector so you can attach related data to any response without making extra API calls:

Include	What it adds
Participants (Teams)	Both teams with home/away and winner metadata
Scores	Goals per half and current total
Events (Goals, Cards, Subs)	Goals, cards, substitutions, VAR decisions
Periods (Halves)	Half timestamps and ticking status
League + Country	League name, image, and country details combined
Round	Round name and dates
Venue	Stadium information
Statistics	Match or season statistics
Lineups	Starting XI and bench

Pagination

Every list operation includes a built-in page parameter. Use it to step through large result sets without any additional workflow configuration.

Error handling

The node surfaces user-friendly messages for the following error codes:

Code	Meaning	Hint
401	Invalid or missing API token	Check your credentials
403	Endpoint not available on your plan	Upgrade or check coverage
429	Rate limit reached	Slow polling or reduce request frequency
500	Server error	Retry or contact Sportmonks support

The node supports n8n's Continue On Fail mode. When enabled, errors are captured as node output rather than stopping the workflow, which is useful for bulk operations across many fixtures or teams.

Installation

Via the n8n GUI (recommended)

1. Open your n8n instance.

2. Go to Settings, then Community Nodes, then Install.

3. Enter n8n-nodes-sportmonks and confirm.

4. Restart n8n when prompted.

Via npm (self-hosted CLI or Docker)

cd ~/.n8n/nodes
npm install n8n-nodes-sportmonks
# then restart n8n

Via Docker Dockerfile

FROM n8nio/n8n
USER root
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-sportmonks
USER node

Authentication

1. In n8n, go to Settings, then Credentials, then New Credential.

2. Search for SportMonks API.

3. Paste your API token from my.sportmonks.com.

4. Save. The credential is available across all workflows in your instance.

Plan requirements

Feature	Minimum plan
Fixtures, Teams, Players, Leagues, Standings	Free
Live scores (in-play)	Starter or above
Odds, predictions, xG	Add-on required

See the full plans and pricing page for details.

Example workflows

The repository includes three importable workflow JSON files in the workflows/ directory. To import: open your n8n instance, go to Workflows, select Import from file, and load the JSON.

File	Description	Plan required
demo-league-season.json	Leagues and seasons only — works on the free plan	Free
demo-all-features.json	All resources with sticky-note explanations	Paid (for livescores)
livescore-monitor.json	Polls in-play scores every 30 seconds	Paid

Quick example

The simplest live workflow: Trigger node, then SportMonks Football node configured as Livescores, Get Inplay, with the participants;scores include. The node outputs one item per live fixture, each containing the raw Sportmonks API response for that match.

Links

• npm: npmjs.com/package/n8n-nodes-sportmonks

• GitHub: github.com/ragmon/n8n-nodes-sportmonks

• n8n community node installation guide: docs.n8n.io/integrations/community-nodes

Notes

This is a community-maintained node and is not an official Sportmonks product. For issues or feature requests, open an issue on the GitHub repository. For questions about the Sportmonks Football API itself, refer to the Football API documentation or contact Sportmonks support.