Todocoleccion APItodocoleccion.net ↗
Search todocoleccion.net football card listings via API. Get prices, page statistics (avg, min, max), category, and offer status for cromos de fútbol.
What is the Todocoleccion API?
The Todocoleccion Football Cards API exposes one endpoint — search_football_cards — that returns up to 30 listings per page from todocoleccion.net's football card marketplace. Each response includes 7 fields per listing (id, title, url, price, price_text, category, accepts_offers) alongside page-level statistics: average, minimum, and maximum listed prices in EUR, and a total result count across all pages.
curl -X GET 'https://api.parse.bot/scraper/7114b1ae-5cef-4968-995a-7ade57691fbf/search_football_cards?page=1&sort=rl&query=cromos+futbol+messi' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace todocoleccion-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: todocoleccion football cards — search listings with price stats."""
from parse_apis.todocoleccion_net_api import Todocoleccion, Sort, InvalidInput
client = Todocoleccion()
# Browse recent Messi football card listings, capped at 5 total items.
for listing in client.listings.search(query="cromos futbol messi", sort=Sort.MOST_RECENT, limit=5):
print(listing.title, listing.price, listing.accepts_offers)
# Get price statistics for the same query via the scalar wrapper.
summary = client.price_summaries.search(query="cromos futbol messi")
print(f"Total results: {summary.total_results}, avg price: {summary.average_listed_price}€")
print(f"Price range: {summary.min_price}€ – {summary.max_price}€")
# Drill into the first listing from a different search.
try:
hit = client.listings.search(query="cromos liga este", sort=Sort.PRICE_LOW, limit=1).first()
except InvalidInput as e:
print(f"Bad input: {e.message}")
hit = None
if hit is not None:
print(hit.title, hit.category, hit.url)
print("exercised: listings.search / price_summaries.search")
Search for football cards on todocoleccion.net and return listings with their listed prices plus price statistics (average, min, max) for the current page. Results are paginated at 30 items per page. Use the page parameter to paginate through results.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination, starting at 1. Each page returns up to 30 items. |
| sort | string | Sort order for results. |
| query | string | Search query for football cards (e.g. 'cromos futbol messi', 'cromos futbol liga este'). |
{
"type": "object",
"fields": {
"items": "Array of football card listings with id, title, url, price, price_text, category, and accepts_offers",
"query": "The search query used",
"max_price": "Maximum listed price in EUR on this page",
"min_price": "Minimum listed price in EUR on this page",
"items_on_page": "Number of items returned on the current page",
"total_results": "Total number of matching listings across all pages",
"average_listed_price": "Average listed price in EUR of items on this page"
},
"sample": {
"data": {
"items": [
{
"id": "700811835",
"url": "https://www.todocoleccion.net/cromos-futbol/467-card-invencible-cristiano-messi-casillas-cromos-album-adrenalyn-xl-liga-futbol-2014-2015-14-15~x700811835",
"price": 2.95,
"title": "467 CARD INVENCIBLE CRISTIANO MESSI CASILLAS CROMOS ALBUM ADRENALYN XL LIGA FUTBOL 2014 2015 14 15",
"category": "Cromos de fútbol antiguos",
"price_text": "2,95 €",
"accepts_offers": false
}
],
"query": "cromos futbol messi",
"max_price": 1600,
"min_price": 0.49,
"items_on_page": 30,
"total_results": 17453,
"average_listed_price": 109.52
},
"status": "success"
}
}About the Todocoleccion API
What the API Returns
The search_football_cards endpoint queries todocoleccion.net for football card (cromos de fútbol) listings and returns a paginated result set. Each item in the items array carries a listing id, title, direct url, numeric price in EUR, a formatted price_text string, category, and a boolean accepts_offers flag indicating whether the seller accepts offers below the listed price.
Query Parameters
Three optional parameters control results. query accepts free-text search terms — for example 'cromos futbol messi' or 'cromos futbol liga este' — to narrow results to specific players, sets, or eras. sort controls result ordering. page (starting at 1) paginates through results; each page returns up to 30 items, and total_results in every response tells you how many listings match across all pages.
Page-Level Price Statistics
In addition to per-listing data, every response exposes average_listed_price, min_price, and max_price computed across the items on the current page, plus items_on_page to confirm how many listings were returned. These statistics reflect listed prices only — not sold or completed transaction prices. Price currency is EUR throughout, consistent with todocoleccion.net's primary market.
Coverage Scope
This API is scoped to football cards on todocoleccion.net. Todocoleccion.net is a Spanish-language collectibles marketplace with a significant catalogue of Spanish football cards (cromos), though the query parameter can retrieve international footballer cards as well. Listings without a visible price are excluded from the statistics calculations.
The Todocoleccion API is a managed, monitored endpoint for todocoleccion.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when todocoleccion.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official todocoleccion.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track listed price ranges for a specific footballer's cromos by querying their name and reading
min_price,max_price, andaverage_listed_price. - Build a price-alert tool that monitors whether new listings for a card set fall below a target by polling
search_football_cardswith a set-specific query. - Aggregate seller inventory by iterating pages via the
pageparameter and collectingid,title, andurlfields for all matching listings. - Identify which listings
accepts_offersto automate or prioritize negotiation workflows in a collector's deal-finding tool. - Compare price distributions across different Liga Este sticker series by running separate queries and comparing page-level statistics.
- Build a catalogue enrichment pipeline that maps listing titles to known card databases using the
titleandcategoryfields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does todocoleccion.net have an official developer API?+
What does `accepts_offers` mean in the listing data?+
accepts_offers boolean reflects whether the seller has indicated they will consider offers below the listed price. It is a per-listing field returned inside the items array; it does not expose offer history or the minimum accepted offer amount.Are the price statistics calculated across all results or just the current page?+
average_listed_price, min_price, and max_price are calculated from the items returned on the current page only — not across all pages of results. To get statistics across the full result set, you would need to paginate through all pages using the page parameter and aggregate the values yourself. total_results tells you the full match count so you can calculate how many pages to request.