Skip to content

Available now

FootyLens News API

Football news, structured and ready to query.

A clean, documented REST API for football news — headlines, sources and metadata, without scraping.

  • Web

Overview

Getting football news into a product usually means writing scrapers, and then maintaining them every time a publisher redesigns.

Structured headlines with sources and metadata, already parsed, so you can query football news instead of harvesting it.

This is the feed behind the news in the FootyLens app. It exists because we had to solve the problem for ourselves first, and maintaining one set of parsers is better than everyone maintaining their own.

What it does

Built to do a few things properly

  • Structured headlines

    Title, summary, publication time and source for each item, in a consistent shape.

  • Attributed sources

    Every item carries where it came from, so you can credit it properly and filter by publisher.

  • Team and competition tags

    Items are tagged so you can pull only what is relevant to a club or a competition.

  • No scraping to maintain

    The parsing and the breakage are our problem, not yours.

Example

What a call looks like

Request

GET /v1/news?team=west-ham&limit=2
Authorization: Bearer <your-key>

Response

{
  "items": [
    {
      "id": "01J8XR3K2M",
      "title": "Team news ahead of Saturday",
      "summary": "Two returns to the squad after the international break.",
      "publishedAt": "2026-08-13T09:12:00Z",
      "source": { "name": "Example Sports", "url": "https://example.test/a" },
      "tags": ["west-ham", "team-news"]
    }
  ]
}

Authentication is a bearer token in the Authorization header. Keys are issued per project and can be rotated on request.

Access

Request access

Keys are issued by hand at the moment. Tell us what you are building and we will get you set up.

The form is not connected yet

It is built, but its delivery is not configured yet. The API works today regardless of that — email support@mileendmedia.co.uk and we will issue you a key by hand.

Questions

Before you ask

  • How do I get a key?

    Ask, using the form on this page. Keys are issued by hand at the moment, so tell us what you are building and we will set you up.

  • What does it cost?

    Nothing today. The API is not currently monetised, and access is granted on request.

  • Can I republish the articles?

    No. The API returns headlines, summaries and links with attribution — the full text stays with the publisher who wrote it.