{"uid":"cap_eckTh7cADo93t1TDrMSrX","slug":"transfermarkt-player-search-scraper-9bceb199","name":"Transfermarkt Player Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/transfermarkt?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"club":null,"clubId":null,"clubUrl":null,"playerId":null,"position":null,"playerUrl":null,"playerName":null,"searchQuery":null}],"product":"transfermarkt"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__T9nXReZPopMB27yXcGjY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Transfermarkt for football/soccer player records by name and returns structured player data including club, position, profile details, and more","exampleAgentPrompt":"Can you look up Erling Haaland on Transfermarkt and give me his club, position, height, and contract details? Return up to 5 player results in case there are multiple matches.","exampleUseCases":[{"title":"Scout report on a specific player","prompt":"I'm putting together a scouting report — can you pull up all the Transfermarkt details for Jude Bellingham, including his current club, position, birth date, height, preferred foot, and contract end date?"},{"title":"Find players with similar names","prompt":"Search Transfermarkt for players named 'Müller' and give me up to 20 results with their clubs and positions so I can figure out which one is the Bayern striker."},{"title":"Quick club lookup without full profile","prompt":"I just need to know which clubs the top results for 'Salah' are at on Transfermarkt — can you run a fast search without loading each player's full profile page?"}],"resultDescription":"A JSON object with a count of results and an array of player items, each containing the player's name, player ID, player URL, current club name, club ID, club URL, position, and the search query used. When includeProfileDetails is true, additional fields such as birth date, height, preferred foot, contract dates, and full position are included.","failureModes":["Player name not found on Transfermarkt — returns empty items array with count 0 (not charged)","Transfermarkt rate limiting or downtime causes failed run (not charged)","Ambiguous name returns many unrelated players — caller should increase maxItems or refine name","includeProfileDetails=true significantly increases latency if many matches are returned","Very common names (e.g. 'Martinez') may exhaust maxItems before finding the target player"],"whenToPreferThis":"Choose this endpoint when you need structured, ready-to-use football player data from Transfermarkt without managing your own scraper. It is ideal for agents that need to enrich player profiles, verify club affiliations, or build scouting databases. Prefer it over raw web scraping when you want reliable JSON output and only pay for successful results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:55.153Z","isFirstParty":false,"canonicalSlug":"transfermarkt-player-search-scraper-9bceb199"}