VCoins Scraper — Ancient, World & US Coins Marketplace

Scrape coin listings from VCoins.com, the online marketplace of 100+ trusted numismatic dealers selling ancient, world, and US coins. Search any keyword and get structured data: title, dealer, category, price with currency, attribution details, image, and listing URL.

What it does

• Searches VCoins across all dealer stores by keyword (e.g. denarius, thaler, morgan dollar, athens tetradrachm)
• Optional category filter: Ancient Coins, US Coins, or World Coins
• Optional min/max price filters
• Paginates automatically (100 results per page)
• Optional detail-page enrichment: full attribution description, complete category breadcrumb, ISO currency code, availability
• Handles multi-currency dealers (USD, EUR, GBP, NOK, and more)

Output example

{
  "title": "TRAJAN. AR Denarius, Rome mint, struck 98-99 AD. Concordia",
  "dealer": "Musa Numismatic Art",
  "dealerUrl": "https://www.vcoins.com/en/stores/musa_numismatic_art-193/ancient-coins/Default.aspx",
  "category": "Ancient Coins",
  "categoryPath": "Trajan - The Adoptive Emperors - Roman Imperial Coins - Ancient Coins",
  "price": 172,
  "currency": "USD",
  "priceText": "US$ 172.00",
  "attribution": "Roman Imperial TRAJAN, 98-117 AD AR Denarius Rome mint, struck 98-99 AD Laureate head right / Concordia seated left",
  "availability": "InStock",
  "productId": "2404761",
  "imageUrl": "https://images.vcoins.com/product_image/193/R/3/R3k4wB2cXiL6tK3oC5aFAy8ps9fYzH.jpg",
  "url": "https://www.vcoins.com/en/stores/musa_numismatic_art/193/product/trajan__ar_denarius_rome_mint_struck_9899_ad__concordia/2404761/Default.aspx",
  "searchQuery": "denarius",
  "scrapedAt": "2026-08-09T20:30:00.000Z"
}

categoryPath, attribution, and availability are filled when Scrape Detail Pages is enabled; otherwise category comes from the dealer's store section.

Input

Field	Type	Default	Description
searchQueries	array	["denarius"]	Keywords to search
category	string	all	all, ancient, us, or world
minPrice / maxPrice	integer	0	Price filters (0 = off)
maxItems	integer	100	Max listings across all queries (0 = unlimited)
scrapeDetails	boolean	false	Fetch each product page for attribution + full category
proxyConfiguration	object	none	Not needed — VCoins serves direct requests

Use cases

• Numismatic price research — compare asking prices for the same coin type across 100+ dealers
• Collection management — track market availability of coins on your want list
• Dealer inventory monitoring — watch new listings in a category or price band
• Market analytics — build price datasets for ancient, world, and US coins

Notes

• No proxy required; the actor scrapes server-rendered pages politely with capped retries and timeouts
• Prices are returned in each dealer's listing currency with an ISO code where recognized
• If a search returns no results, the actor writes a DIAGNOSTIC record to the key-value store instead of failing