todocoleccion Marketplace Scraper

Collect public lot listings from todocoleccion search pages for collectible pricing, inventory, and seller research.

What does todocoleccion Marketplace Scraper do?

This Apify actor extracts public search results from todocoleccion.net, a Spanish marketplace for collectibles, antiques, books, toys, comics, coins, postcards, art, and other second-hand lots.

It turns todocoleccion search pages into a structured dataset with lot IDs, titles, URLs, prices, categories, images, offer flags, and optional detail-page seller and description fields.

Who is it for?

• 🧑‍💼 Resellers tracking market prices for collectible inventory.
• 🏬 Antique and hobby shops monitoring availability by category.
• 📊 Ecommerce analysts comparing asking prices across niches.
• 🧾 Auction researchers building comparable-sales lead lists.
• 🧑‍🎨 Brand and IP owners watching vintage product listings.
• 🧑‍💻 Data teams feeding internal dashboards or alerts.

Why use it?

Manual marketplace research is slow when you need hundreds or thousands of listings. This actor automates repeatable collection from public todocoleccion pages and exports data in JSON, CSV, Excel, XML, RSS, or through the Apify API.

Data you can extract

Field	Description
lotId	todocoleccion lot identifier
title	Listing title
url	Public lot URL
searchUrl	Search page where the lot was found
priceText	Displayed price string
price	Parsed numeric price when available
currency	Currency code, usually EUR
category	Visible marketplace category
imageUrl	Main image URL
saleMode	Visible sale or offer note
acceptsOffers	Whether the card mentions offers
seller	Seller username when detail fetch is enabled
sellerUrl	Seller profile URL when detail fetch is enabled
sellerSince	Public seller start date when visible
sellerLocation	Public seller location when visible
sellerRatingText	Public rating text when visible
description	Public lot description when detail fetch is enabled
scrapedAt	ISO timestamp of extraction

How much does it cost to scrape todocoleccion listings?

The pricing is pay per event: a small $0.005 run-start event plus a per-result event. Cloud validation set the BRONZE result price to about $0.18 per 1,000 listing results, with automatic tier discounts for higher Apify plans.

Input options

Use keyword searches, full search URLs, or both.

• searchQueries — keywords such as star wars, monedas, postales antiguas, or playmobil.
• searchUrls — full todocoleccion search/category URLs with filters already applied.
• maxItems — total number of lots to save.
• maxPages — number of result pages to scan per search.
• fetchDetails — enrich each lot with seller and description fields.
• proxyConfiguration — optional Apify proxy settings.
• maxRequestRetries — retry count for HTTP requests.

Example input

{
  "searchQueries": ["star wars"],
  "maxItems": 30,
  "maxPages": 2,
  "fetchDetails": false,
  "proxyConfiguration": { "useApifyProxy": false },
  "maxRequestRetries": 3
}

Example with detail pages

{
  "searchQueries": ["monedas romanas"],
  "maxItems": 25,
  "maxPages": 2,
  "fetchDetails": true
}

Detail mode is slower because every lot page is opened after the search result page. Use it when seller profile, location, rating text, or description matters.

Using search URLs

Paste a filtered todocoleccion URL when you want to preserve marketplace filters. For example, create a search in your browser, apply category or sorting filters, then copy the URL into searchUrls.

{
  "searchUrls": ["https://www.todocoleccion.net/buscador?bu=star%20wars&O=rl"],
  "maxItems": 60,
  "maxPages": 3
}

Output example

{
  "lotId": "680557595",
  "title": "CINEMANIA. STAR WARS EPISODIO II...",
  "url": "https://www.todocoleccion.net/libros-segunda-mano-cine/...~x680557595",
  "searchUrl": "https://www.todocoleccion.net/buscador?bu=star+wars&O=rl",
  "priceText": "1,00 €",
  "price": 1,
  "currency": "EUR",
  "category": "Libros de Cine de segunda mano",
  "acceptsOffers": false,
  "scrapedAt": "2026-05-18T00:00:00.000Z"
}

How to run

1. Open the actor on Apify.
2. Enter one or more keywords or URLs.
3. Set a conservative maxItems value for the first run.
4. Enable detail pages only if you need enriched fields.
5. Click Start.
6. Download the dataset or consume it through the API.

Tips for better results

• 🔎 Use Spanish marketplace terms for the best coverage.
• 📏 Start with 30 to 100 lots before scaling up.
• 🧩 Use category-filtered URLs for narrow niches.
• ⚙️ Turn on detail pages only for enriched seller and description data.
• 🧹 Deduplicate downstream by lotId if you run overlapping searches.

Integrations

Use this actor in workflows such as:

• Daily price monitoring for collectible SKUs.
• Seller-discovery dashboards for niche categories.
• Alerting pipelines when new lots match a brand or character.
• Research notebooks comparing asking prices across searches.
• Inventory sourcing spreadsheets for resale teams.

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/todocoleccion-marketplace-scraper').call({
  searchQueries: ['star wars'],
  maxItems: 30,
  maxPages: 2
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/todocoleccion-marketplace-scraper').call(run_input={
    'searchQueries': ['star wars'],
    'maxItems': 30,
    'maxPages': 2,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

API usage with cURL

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~todocoleccion-marketplace-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"searchQueries":["star wars"],"maxItems":30,"maxPages":2}'

MCP integration

Use Apify MCP when you want Claude to run this actor directly from a chat or coding session. Enable only this tool so prompts route to the correct scraper:

https://mcp.apify.com/?tools=automation-lab/todocoleccion-marketplace-scraper

Claude Code setup:

$claude mcp add apify-todocoleccion https://mcp.apify.com/?tools=automation-lab/todocoleccion-marketplace-scraper

Claude Desktop or other MCP client JSON configuration:

{
  "mcpServers": {
    "apify-todocoleccion": {
      "url": "https://mcp.apify.com/?tools=automation-lab/todocoleccion-marketplace-scraper"
    }
  }
}

Example prompts for MCP usage:

• "Run automation-lab/todocoleccion-marketplace-scraper for 50 Star Wars lots and summarize the price range."
• "Use the todocoleccion scraper to find Playmobil lots and group them by category."
• "Scrape vintage postcards with seller details enabled and return the most interesting low-price lots."

Data quality notes

The actor reads public HTML shown on todocoleccion pages. Some fields are optional because todocoleccion does not display every attribute for every listing. For example, seller details and descriptions require fetchDetails: true.

Performance notes

Search result mode is fast because it uses HTTP requests and parses server-rendered HTML. Detail mode is slower because it opens each lot page. For large monitoring jobs, run search-result mode first and enable detail mode only for selected niches.

Proxy notes

Direct HTTP is the default because public search pages are reachable without a proxy in current tests. If you run at higher volume or from restricted networks, enable Apify Proxy in the input.

Legality

This actor extracts publicly available marketplace data. You are responsible for using the data in accordance with applicable laws, marketplace terms, and privacy obligations. Avoid scraping private account data, bypassing access controls, or using the output for spam.

Troubleshooting: I got fewer items than requested

The source search may have fewer visible lots, filters may narrow the result set, or maxPages may be too low. Increase maxPages, try a broader keyword, or paste a different search URL.

Troubleshooting: Detail fields are empty

Enable fetchDetails to collect seller and description fields. Some lots still may not expose every field publicly.

FAQ

Does it require a todocoleccion account?

No. The actor targets public search and lot pages only.

Can it scrape sold prices?

The current MVP focuses on public active search listings and visible lot detail data.

Can I scrape multiple searches in one run?

Yes. Add multiple strings to searchQueries or multiple URLs to searchUrls.

How do I avoid duplicates?

The actor deduplicates lots inside one run by lotId. For multiple scheduled runs, deduplicate downstream by lotId and timestamp.

Related scrapers

Other automation-lab actors that may complement this workflow:

• https://apify.com/automation-lab/ebay-search-scraper
• https://apify.com/automation-lab/facebook-marketplace-scraper
• https://apify.com/automation-lab/etsy-scraper
• https://apify.com/automation-lab/amazon-search-scraper

Changelog

• Initial version: public todocoleccion search scraping with optional detail-page enrichment.

Support

If a public todocoleccion page shape changes or you need an additional output field, open an Apify issue with your input and expected result.