usacoinbook.com APIusacoinbook.com ↗
Access US coin categories, series data, melt values, grade-based prices, and marketplace listings from usacoinbook.com via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/4bd6afb6-4ee0-4454-bb1d-d4cb11d8899d/list_coin_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get structured list of all coin denominations and series from the sidebar of usacoinbook.com. Returns denomination names, coin counts, and nested series with their URLs.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of denomination objects, each containing denomination name, count, url, and nested series array"
},
"sample": {
"data": {
"categories": [
{
"url": "https://www.usacoinbook.com/coins/half-cents/",
"count": 163,
"series": [
{
"url": "https://www.usacoinbook.com/coins/half-cents/liberty-cap/",
"name": "Liberty Cap",
"count": 2
}
],
"denomination": "Half Cents"
}
]
},
"status": "success"
}
}About the usacoinbook.com API
The USA Coin Book API exposes 7 endpoints covering US coin reference data and marketplace listings from usacoinbook.com. Starting with list_coin_categories, you can navigate the full denomination and series hierarchy, drill into individual series with get_coin_series_page to retrieve mintage figures and grade-based values, and pull active marketplace listings with search_coins. Melt values and spot prices for all major US coin metal types are available through a dedicated endpoint.
Coin Reference Data
list_coin_categories returns the full denomination tree from usacoinbook.com — each entry includes a denomination name, coin count, and a nested series array with names and URLs. These series URLs feed directly into get_coin_series_page, which returns a coins array where each object carries the year, mintage, grade-specific values, and a link to the detail page. The series response also includes a specifications object (e.g. metal composition, diameter, weight) and a plain-text description.
Coin Detail and Valuation
get_coin_detail_page accepts a URL from get_coin_series_page coins[*].url and returns structured fields: name, prices (a grade-to-price map), information (mintage, designer, metal composition, diameter, weight), and obverse/reverse image URLs. Note that in some cases prices appear embedded in the information text rather than in the prices object. get_coin_melt_values returns a coins array covering all major US coin types with fields for metal content composition, weight, denomination, and computed melt value, plus a spot_prices object keyed by metal name.
Marketplace and Discovery
search_coins queries the usacoinbook.com marketplace and returns an array of listing objects — each with a title, price, URL, and seller info string. Passing a listing URL to get_listing_detail retrieves structured listing_specs (seller, shipping, return policy) alongside the full description and price. If a listing has been removed, the endpoint returns stale_input.
Most Valuable Coins
get_most_valuable_coins returns a lists array where each entry has a title and an items array of coin name and estimated value pairs. These lists are categorized (e.g. by series or era) and sorted by value, useful for quick reference on high-value US coins.
- Build a coin collection tracker that pulls current grade-based values from
get_coin_series_pagefor a given series. - Calculate the melt floor for a batch of coins using metal composition and melt values from
get_coin_melt_values. - Monitor active marketplace listings for specific coins using
search_coinswith targeted queries like '1909 S VDB lincoln penny'. - Populate a coin catalog app with obverse and reverse images and technical specs from
get_coin_detail_page. - Identify high-value targets in a collection by cross-referencing holdings against the
get_most_valuable_coinslists. - Aggregate mintage data across a full denomination by iterating series URLs from
list_coin_categoriesintoget_coin_series_page. - Summarize marketplace listing terms — seller, shipping, and return policy — before directing buyers using
get_listing_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does usacoinbook.com offer an official developer API?+
What does `get_coin_series_page` return, and what input does it need?+
get_coin_series_page takes a url parameter — a series page URL from list_coin_categories series[*].url — and returns a coins array with year, mintage, and grade-based value columns per coin, plus a specifications object and series description. If the URL does not point to a valid series page, the endpoint returns stale_input.Are auction results or historical sale prices available?+
search_coins and get_listing_detail, and grade-based reference values from coin series and detail pages, but does not expose historical auction records or realized prices. You can fork this API on Parse and revise it to add an endpoint targeting usacoinbook.com auction history pages if that data is present on the site.Can I retrieve spot prices for metals through this API?+
get_coin_melt_values includes a spot_prices object keyed by metal name alongside the melt value data. The field is noted as potentially empty if the prices are not parseable from the page at request time, so downstream code should handle an empty object gracefully.Does the API support pagination for marketplace search results?+
search_coins returns a single results array for a given query string with no page or offset parameter exposed. You can fork this API on Parse and revise it to add pagination support if usacoinbook.com's search supports multiple result pages.