TCGplayer Pokemon Price & Stock Watchlist

Monitor current asking offers for up to 25 exact English Pokemon card variants. Choose each card's printing and condition, inspect available stock and one-card price plus disclosed US shipping, and optionally screen a before-tax cost target. Stable variant and listing IDs let a store or collector save repeated snapshots for repricing and procurement workflows.

Input

Supply exactly one of productIds or watchlist. productIds accepts 1–25 positive numeric TCGplayer Pokemon single-card product IDs and uses the common printing and condition. The compatible defaults remain Holofoil and Near Mint. watchlist accepts 1–25 objects with productId plus optional per-card printing, condition and maxKnownSubtotalUsd. Conditions are Near Mint, Lightly Played, Moderately Played, Heavily Played and Damaged; printings are Normal, Holofoil and Reverse Holofoil. These are TCGplayer labels, not grading certificates or equivalence to another marketplace.

{"watchlist":[{"productId":517044,"printing":"Holofoil","condition":"Near Mint","maxKnownSubtotalUsd":95},{"productId":517045,"printing":"Holofoil","condition":"Lightly Played","maxKnownSubtotalUsd":300}],"maxOffers":5}

The IDs identify Venusaur ex 198/165 and Charizard ex 199/165 from Scarlet & Violet 151. Product IDs are not seller, listing or SKU IDs. maxOffers returns 1–20 nested offers per variant from the first 50 source offers sorted by price plus shipping. English, standard ungraded singles, one priced card and a US destination are fixed. Unknown fields and arbitrary URLs are rejected. Duplicate product/printing/condition targets are acquired and billed once; duplicates with conflicting cost targets fail before requests.

Output and repeated use

One english_pokemon_procurement_screen row per distinct variant contains watchKey, exact card/set/number identity, requested condition and printing, original listing IDs, in-stock quantities, asking prices, explicit shipping, known one-card subtotals, sample counts, exclusions and observation time. The default view shows variant, condition, lowest observed cost, qualified sampled stock and the optional cost-target result.

Schedule the same watchlist and archive rows keyed by watchKey and checkedAt to compare observations. Listing IDs identify the same observed offer across runs. The Actor does not maintain a historical database, send alerts or infer that an offer omitted from its bounded sample was sold. Seller names, addresses and seller IDs/keys, descriptions, pictures and custom listings are discarded.

minimumObservedKnownSubtotalUsd is the lowest qualified observed one-card subtotal before tax. availableQuantityInQualifiedSample sums units across qualified sampled offers, including offers omitted by maxOffers; it is not total marketplace stock. observedOfferMeetsTarget screens only observed qualified offers against the user's cost ceiling. Missing offers return null; false is not proof that no qualifying offer exists outside the sample. Source totals, sampled/qualified/returned counts and truncation flags expose that distinction.

Shipping is the public website's US empty-cart quote; combining multiple cards or sellers can change shipping. Tax, checkout adjustments, confirmed bookability and source price-update time remain unknown. checkedAt records acquisition, not a verified price-update time. Prices are asking offers, not sales or market-price estimates. No European comparison or worldwide-delivery capability is claimed.

A properly parsed explicit zero or a sample with no qualified offer returns no_qualifying_offers, a null minimum and an explicit reason. This is observed procurement evidence, not entire-market sold out. Authentication, blocks, rate limits, malformed responses or failure of any requested source acquisition fail before dataset delivery or charging.

Charging and limits

Price: $0.002 per distinct product/printing/condition snapshot delivered ($2 per 1,000 snapshots). Up to 25 variants costs $0.05 in Actor events. Each complete snapshot, including explicit negative evidence, uses the sole procurement-screen-created event. Nested offers, cost-target checks and duplicates add no events. No actor-specific free trial is promised; platform credits may apply.

HTTP only, 256 MB, no required third-party API or paid dependency. At most 52 requests: two fresh robots checks, one product detail per distinct ID and one listing search per variant. Requests to the same origin are spaced at least ten seconds apart, respecting the observed crawl delay; 25 variants can therefore take about nine minutes with responsive sources. Each body is capped at 2 MiB, each request at 30 seconds, and the run at 900 seconds. There are no retries, proxies, login, cart mutations or transactions. Increased source crawl delay fails for review rather than being ignored. Validate the full watchlist and event allowance before I/O; acquire all variants before delivering any row.

Privacy and source terms

Only public product and necessary offer facts are returned. Requests reproduce the public website's read-only listing search without developer keys or account cookies. TCGplayer's terms restrict scraping and commercial combination/distribution; DR-0007 accepts grey contractual risk without asserting permission. Exact terms and current access evidence are in the dated scout. Cardmarket remains excluded while its access/robots requirements are unresolved.

Source availability can change between runs. A source failure is reported as an error before any row or event is delivered.