cash-converters-spain-scraper

Apify actor autoclient/cash-converters-spain-scraper (id O9AcccmxDkRyiOyDL). Current reliable deploy path is SOURCE_FILES via npm run deploy:apify. Schemas drift; the input/output below are examples, not eternal truth.

What this is

SUB price source for spain-multiplatform-price-scraper. Scrapes cashconverters.es by search query. Returns near-variants (e.g. 16e, pro, plus) before the exact base model unless IWAKY passes an exact productId — exact model/storage filtering still happens downstream, but deterministic per-grade routes can narrow to a single listing id.

Current authoritative truth (2026-05-30)

Use main.js, the live schema, and a fresh run as authority.

• This actor is a fetcher, not a final matcher.
• Search results can legitimately include sibling variants first; the orchestrator must enforce exact model/storage acceptance.
• condition is useful for per-grade narrowing, and productId is the deterministic exact-listing pin when IWAKY has a canonical route for that grade.
• A green run still needs row-level validation downstream.

Input schema

field	type	req	default	enum	description
search_query	string	✅	iphone		Product search query (e.g., 'iphone', 'ps5')
max_items	integer		10		Maximum number of products to scrape
condition	string		all	all, perfecto, bueno, usado, a_estrenar	Filter by product condition. IWAKY grade mapping: a_estrenar=NUEVO, perfecto=A, bueno=AB, usado=B.
productId	string				Optional exact Cash Converters product id such as CC102_E8952_0. When set, only that listing id is emitted.
min_price	number				Minimum price filter (EUR)
max_price	number				Maximum price filter (EUR)

Real input sample (2026-06-07)

{
  "search_query": "Samsung Galaxy S25 Ultra 256GB",
  "max_items": 5,
  "condition": "perfecto",
  "productId": "CC102_E8952_0"
}

Raw output (first dataset item, 2026-06-07)

{
  "title": "samsung galaxy s25 ultra 12gb 256gb",
  "price": "774,95 €",
  "condition": "Perfecto",
  "stock": "Check Availability",
  "url": "https://www.cashconverters.es/es/es/comprar/telefonos/moviles/samsung/galaxy-s25-ultra-12gb-256gb/?firstProduct=CC102_E8952_0",
  "search_query": "Samsung Galaxy S25 Ultra 256GB",
  "productId": "CC102_E8952_0"
}

Grade mapping (Cash Converters Spain Scraper → IWAKY)

Source condition	IWAKY grade
a_estrenar	NUEVO
perfecto	A
bueno	AB
usado	B

One unfiltered condition:all call returns every condition; grade is parsed from the per-row condition token. Per-grade child calls use the condition enum value above.

Deterministic route shape

IWAKY stores Cash Converters deterministic routes in product_platform_grade_routes.gradeDeterministicId using this shape:

<search_query>|condition=<condition>|productId=<cash_converters_id>

Examples:

• Samsung Galaxy S25 Ultra 256GB|condition=perfecto|productId=CC102_E8952_0
• Samsung Galaxy S25 Ultra 256GB|condition=bueno|productId=CC040_E560686_0
• Samsung Galaxy S25 Ultra 256GB|condition=a_estrenar
• Samsung Galaxy S25 Ultra 256GB|condition=usado

This means the schema does allow all 4 IWAKY grades. Whether a given product returns rows for every grade depends on current market inventory, not on schema support.

Role in the pipeline

Called by spain-multiplatform-price-scraper (the orchestrator) by actor id O9AcccmxDkRyiOyDL. This actor is a fetcher, not a final matcher — exact model/storage/grade validation and rejection-with-reason happen in the orchestrator's deterministic filter. A green SUCCEEDED only means the container exited; business-correct output requires row-level model/storage/grade checks downstream.

Deploy

• Current reliable deploy path is npm run deploy:apify with APIFY_API_TOKEN set.
• That script updates Apify version 1.0 from the local repo as SOURCE_FILES, builds it with tag latest, and forces the actor default run target to latest.
• This was added on 2026-06-07 after the previous GIT_REPO/webhook path kept producing stale builds and the actor default run settings were pinned to old build 1.0.13.
• A green build is still not enough: confirm a fresh run returns rows, and confirm exact-grade routes still honor productId before relying on the deploy.