# Transfermarkt Player Search Scraper (x402)

> Transfermarkt Player Search Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches Transfermarkt for football/soccer player records by name, returning club, position, and optional detailed profile data as structured JSON.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/transfermarkt?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/transfermarkt-player-search-scraper-x402-c8471100
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TSfXNXlwSroJ9rE1L8rk9

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 transfermarkt-player-search-scraper-x402-c8471100 -d '<json body>'
```

Example prompt: Search Transfermarkt for players named 'Erling Haaland' and return up to 5 results including full profile details like position, height, foot, birth date, and contract dates.

## When to prefer this

Use this endpoint when you need structured Transfermarkt player data (club, position, contract, profile) without building your own scraper. It is ideal for football analytics pipelines, agent workflows querying player info on demand, or enriching existing datasets with Transfermarkt-sourced details. The pay-per-call model with no charge for failed runs makes it low-risk for exploratory queries. Prefer this over generic web scraping tools when Transfermarkt specifically is the target source.

## Known failure modes

- No players found matching the search name — returns empty items array (not charged)
- Transfermarkt page structure changes breaking the scraper — may return null fields
- Network or scraping failure — run fails and is not charged
- Very common names may return many pages; maxItems controls truncation
- Rate limiting or blocking by Transfermarkt — scraper may return incomplete results

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of matched players and an array of player records, each with fields for player name, player ID, player URL, club, club ID, club URL, position, and (if profile details enabled) birth date, height, preferred foot, contract dates, and other profile attributes. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 30,
   "minimum": 0,
   "description": "Maximum player records to return across search pages. Set 0 to collect all available matches."
  },
  "playerName": {
   "type": "string",
   "description": "Name or part of a name to search in public player results. Results may include similar names."
  },
  "includeProfileDetails": {
   "type": "boolean",
   "default": true,
   "description": "Open each player profile for birth date, full position, height, foot, contract dates, and other details. Turning this off makes runs faster."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "club": null,
    "clubId": null,
    "clubUrl": null,
    "playerId": null,
    "position": null,
    "playerUrl": null,
    "playerName": null,
    "searchQuery": null
   }
  ],
  "product": "transfermarkt"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/transfermarkt-player-search-scraper-x402-c8471100/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)