# Flashscore Scraper

> Flashscore Scraper is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-29).

Scrapes live scores, results, and fixtures from Flashscore for 24 sports across any day in a -7 to +7 day window, with optional match details, statistics, and timeline events.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/flashscore-scraper?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flashscore-scraper-3c4134a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OHfzjkMMYhjLRIUXgHlOO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability flashscore-scraper-3c4134a0 -d '<json body>'
```

Example prompt: Pull today's and tomorrow's finished and live Premier League football matches from Flashscore — I want the goals and cards timeline plus possession and shots stats for each game.

## When to prefer this

Choose this endpoint when you need real-time or historical sports scores, fixtures, and match statistics from Flashscore across a wide range of sports without needing a login or API key. Ideal for sports monitoring agents, score-tracking workflows, or fantasy sports assistants. Prefer this over generic web scraping when you need structured, parsed match data with timeline events and statistics already extracted.

## Known failure modes

- No matches found for the specified filters — returns empty result set (not charged)
- Invalid sport enum value returns validation error
- Day offset outside -7 to +7 range rejected
- Flashscore source temporarily unavailable — upstream scraping failure
- maxMatches cap reached before all matching results retrieved
- Team or league name not recognized by Flashscore naming convention

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

Returns a structured list of matches filtered by the specified criteria, each containing: team names, current score, match status, competition/league name, country, and optionally period/set/half scores plus goals/cards/substitutions timeline with player names and minutes, and detailed statistics like possession, shots, corners, aces, and double faults.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "array",
   "items": {
    "type": "integer"
   },
   "maxItems": 3,
   "description": "Day offsets from today (UTC): 0 = today, -1 = yesterday, 1 = tomorrow ... from -7 to 7. E.g. [-1, 0, 1]."
  },
  "teams": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "Keep matches of these teams or players (name contains), e.g. [\"Arsenal\", \"Djokovic\"]."
  },
  "sports": {
   "type": "array",
   "items": {
    "enum": [
     "football",
     "tennis",
     "basketball",
     "hockey",
     "american-football",
     "baseball",
     "handball",
     "rugby-union",
     "floorball",
     "bandy",
     "futsal",
     "volleyball",
     "cricket",
     "darts",
     "snooker",
     "boxing",
     "aussie-rules",
     "rugby-league",
     "badminton",
     "water-polo",
     "field-hockey",
     "table-tennis",
     "esports",
     "kabaddi"
    ],
    "type": "string"
   },
   "maxItems": 2,
   "description": "Sports to scrape."
  },
  "leagues": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "Keep matches whose competition contains any of these, e.g. [\"Premier League\", \"LaLiga\", \"ATP\", \"NBA\"]. Empty = all."
  },
  "statuses": {
   "type": "array",
   "items": {
    "enum": [
     "scheduled",
     "live",
     "finished",
     "postponed",
     "cancelled"
    ],
    "type": "string"
   },
   "maxItems": 3,
   "description": "Keep matches with these statuses."
  },
  "countries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 3,
   "description": "Keep these countries / regions as Flashscore names them, e.g. [\"England\", \"Spain\", \"Europe\", \"World\"]."
  },
  "maxMatches": {
   "type": "integer",
   "maximum": 100,
   "description": "Total cap for the run."
  },
  "includeStats": {
   "type": "boolean",
   "description": "With details: possession, shots, corners, cards (football) or aces, double faults (tennis)..."
  },
  "includeDetails": {
   "type": "boolean",
   "description": "For live and finished matches: goals / cards / substitutions timeline with minute and player, and half / period / set scores."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://www.flashscore.com/match/SAcNgulA/#/match-summary",
    "away": "Ararat",
    "home": "Van",
    "sport": "football",
    "league": "Premier League",
    "status": "scheduled",
    "country": "Armenia",
    "matchId": "SAcNgulA",
    "awayScore": null,
    "homeScore": null,
    "leagueUrl": "https://www.flashscore.com/football/armenia/premier-league/",
    "startTime": "2026-10-23T11:30:00+00:00",
    "competition": "ARMENIA: Premier League",
    "statusDetail": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flashscore-scraper-3c4134a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)