Transfermarkt Data, Rendered and Returned as JSON
Transfermarkt publishes player profiles, transfer histories, match statistics and market valuations as public web pages.
This API takes a Transfermarkt URL, loads the page in a real browser, rotates the IP, and returns the result your pipeline can consume. You can ask for parsed JSON with CSS or XPath rules, or describe the fields you want in natural language. The page below explains the request model, the credit costs that apply, and the decisions worth making before you build.
What a Transfermarkt request returns
A single call accepts a Transfermarkt URL and returns the rendered page or a structured extraction. The data types that teams most often target are:
- Player transfer records: transfer dates, source club, destination club, and transfer fees.
- Match statistics per player per match: goals, assists, minutes played, and bookings.
- Market valuations and contract data: player market valuations, contract end dates, and salary disclosures where exposed.
- Player profile fields: player name, position, market valuation, contract end date, transfer history, match statistics, and salary signals.
If you supply extraction rules, the response is parsed JSON keyed by the field names you chose. If you supply a natural-language spec through ai_extract_rules, the response is structured JSON for the player and club pages you named, with no selectors required. Without either, you receive the rendered page response your own scraper can act on.
Request model: URL in, rendered response out
The workflow has four steps.
- Create an account to receive an API key and the free starting credits.
- Install a client for your stack, or call the endpoint directly with cURL. SDKs are published for Python, Node.js, Go, PHP, Ruby, and Java; plain cURL works too.
- Send the Transfermarkt URL with your API key as a parameter. The renderer executes the page in a real browser, rotates the IP, and returns the response.
- Add advanced parameters only when the page needs them: render_js for JavaScript execution, stealth_proxy for CAPTCHA-heavy targets, country_code for geo-targeting, and ai_extract_rules for natural-language extraction.
A request builder in the dashboard lets you test a request without writing code. Code samples exist in Python, Node.js, Ruby, PHP, Go, and cURL.
Field and control map
Use this map to decide which request parameter produces which output field. It is a planning aid, not a schema guarantee; the exact parameter names and credit rules are fixed by the API contract.
| Goal | Request parameter | Output you receive |
|---|---|---|
| Render a JavaScript-heavy Transfermarkt page | render_js | Rendered HTML or parsed result |
| Target a CAPTCHA-protected page | stealth_proxy | Rendered response through stealth infrastructure |
| Route through a specific country | country_code | Response from the chosen geolocation |
| Extract named fields with selectors | extract_rules | Parsed JSON keyed by your field names |
| Extract fields from a natural-language description | ai_extract_rules | Structured JSON without selectors |
| Capture a visual record of the page | screenshot option | Full-page screenshot |
| Feed a page into an LLM | Markdown output | Clean Markdown of the page |
If a field is missing from the JSON, check whether the page actually exposes it. Salary disclosures in particular appear only where Transfermarkt publishes them.
How credits are consumed
Requests start at one credit each. Options increase the cost per successful request:
- JavaScript rendering: 5 credits.
- Premium proxies: 10 credits without JS rendering, 25 with JS rendering.
- stealth_proxy: 75 credits.
API credits are valid for one month and do not roll over. Concurrency is the number of requests that can be sent at the same time; it is set per plan rather than per target. If Transfermarkt throttles aggressive patterns, space requests out or use multiple sessions.
A worked estimate: if every request needs JavaScript rendering plus a premium proxy, each call costs 25 credits. A 75,000-credit plan therefore covers about 3,000 such calls per month before any other options. If stealth_proxy is required, each call costs 75 credits and the same plan covers about 1,000 calls. These are arithmetic examples from the published credit figures, not a promise about your success rate.
Decision checklist before you build
Work through these questions in order; each one changes the shape of the integration.
- Which Transfermarkt pages do you need? Player profiles, club pages, match pages, and transfer lists expose different fields. Confirm the field exists on the page before writing an extraction rule.
- Do you need rendered HTML or parsed JSON? Parsed JSON with extract_rules or ai_extract_rules removes downstream parsing work; raw rendered HTML gives you full control.
- Which options does the target require? JavaScript rendering, premium proxies, and stealth proxies each add credits. Estimate monthly volume against the credit table before choosing a plan.
- Is your bottleneck concurrency or target throttling? Concurrency is a plan limit; target throttling is a separate problem solved by spacing requests or using multiple sessions.
- Do you need a visual record? Screenshots are useful for verification when a parsed field looks wrong.
- Do you need LLM-ready text? Markdown output is available when the downstream consumer is a language model rather than a database.
- Have you reviewed the target site's terms of service? Public-facing pages can usually be scraped, but the target's terms govern what is acceptable, and post-login content should be avoided.
Distinguishing common failure modes
Three failures look similar in a log but need different fixes.
- Blocked target: the response is a CAPTCHA or an access-denied page. Add stealth_proxy or premium proxies, and slow the request pattern.
- Extraction mismatch: the page loads but the JSON is missing fields. The selector or natural-language spec does not match the current page structure. Re-check the field on the live page and adjust extract_rules or ai_extract_rules.
- Credit exhaustion: requests fail even though the target is reachable. Check remaining credits and whether the chosen options consumed more per request than expected. Credits reset monthly and do not roll over.
A fourth case is a concurrency error: the plan's simultaneous request limit has been reached. Queue requests or move to a plan with higher concurrency.
Plan reference
The plan table below is a dated reference captured from the published pricing page. Prices are exclusive of VAT. Check the current pricing page before committing to a plan, because plan names, credit allowances, and concurrency limits can change.
The table is delivered as an exact module; every row, numeric cell, and link is preserved as published. Use it to compare credit allowances and concurrency limits, not as a quote for a new purchase.
Compliance and scale notes
The service does not collect or store personal data from scraped sites unless the user explicitly requests it. Proxy rotation and headless browser rendering are used to reduce IP-based blocking and to mimic real browsing behaviour. The platform is described as scaling with thousands of headless browsers and rotating proxies, with typical response times of one to five seconds across most sites, including JavaScript-heavy ones.
These are the provider's own operational descriptions. They are not a guarantee of success on any specific Transfermarkt page, and they do not replace your own review of the target's terms of service.
| Plan | Price | API credits | Concurrent requests | JavaScript rendering | Rotating & premium proxies | Geotargeting | Screenshots & extraction rules | Priority email support | Dedicated account manager | Team management |
|---|---|---|---|---|---|---|---|---|---|---|
| Hobby | $19 /mo | 75,000 | 25 | Included | Included | Included | Included | Not included | Not included | Not included |
| Freelance | $49 /mo | 250,000 | 50 | Included | Included | Included | Included | Not included | Not included | Not included |
| Startup (Recommended) | $99 /mo | 1,000,000 | 100 | Included | Included | Included | Included | Not included | Not included | Not included |
| Business | $249 /mo | 3,000,000 | 200 | Included | Included | Included | Included | Included | Included | Included |
| Business + | $599 /mo | 8,000,000 | 400 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 14 | $999 /mo | 14,000,000 | 500 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 24 | $1,599 /mo | 24,000,000 | 600 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 41 (Recommended) | $2,399 /mo | 41,000,000 | 700 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 69 | $3,599 /mo | 69,000,000 | 800 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 120 | $5,799 /mo | 120,000,000 | 900 | Included | Included | Included | Included | Included | Included | Included |
Prices are exclusive of VAT. Credit allowances are monthly and do not roll over. This is a dated reference; check the current pricing page before purchase.
Frequently asked questions
Do I need a Transfermarkt account to use this API?
No. You sign up for an API key, send the public Transfermarkt URL, and the service handles rendering and IP rotation. You do not log in to Transfermarkt, and post-login content should be avoided.
Is scraping Transfermarkt legal?
Public-facing pages can usually be scraped, but the target site's terms of service govern what is acceptable. Review those terms before deploying, and avoid post-login content. This is general guidance, not legal advice.
Is there a rate limit per target?
The API applies concurrency limits per plan rather than per-target rate limits. If Transfermarkt throttles aggressive patterns, space out requests or use multiple sessions.
How do I get structured JSON from Transfermarkt?
You have two routes. With extract_rules, you map CSS selectors to the field names you want, and each field is filled from the matched element. With ai_extract_rules, you describe the fields in plain language instead of writing selectors. Either way, the API returns the result as parsed JSON.
Which programming languages can I use?
Any. SDKs are published for Python, Node.js, Go, PHP, Ruby, and Java, and plain cURL works too. Pick whatever your stack already uses.
How much does a Transfermarkt request cost?
Requests start at one credit each. JavaScript rendering costs 5 credits; premium proxies cost 10 without JS rendering and 25 with it; stealth_proxy costs 75. Credits are valid for one month and do not roll over. Paid plans start at $19/month, and new accounts receive free starting credits without a card.
Why is a field missing from the JSON?
Either the page does not expose that field, or the extraction rule does not match the current page structure. Check the live page first, then adjust extract_rules or ai_extract_rules. Salary disclosures in particular appear only where Transfermarkt publishes them.