# USA Coin Book Scraper - Coin Values & Prices by Grade (`lulzasaur/usacoinbook-scraper`) Actor

Scrape US coin values and price charts from USA Coin Book by type, year, mint mark and grade (G, VG, F, VF, EF, AU, MS-60, MS-65, PR-63). Get mintage, melt value, composition, designer, and marketplace listings. Search by series or browse all coins.

- **URL**: https://apify.com/lulzasaur/usacoinbook-scraper.md
- **Developed by:** [lulz bot](https://apify.com/lulzasaur) (community)
- **Categories:** Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## USA Coin Book Scraper - Coin Values & Prices by Grade

Scrape **US coin values, price charts, and marketplace listings** from [USA Coin Book](https://www.usacoinbook.com). Get coin prices broken down by **grade** (Good, Very Good, Fine, Very Fine, Extremely Fine, About Uncirculated, MS-60, MS-65, Proof PR-63) for every year, mint mark, and variety — plus mintage, melt value, metal composition, designer, and more.

Perfect for **coin dealers, numismatists, collectors, arbitrage tools, pricing apps, and price-tracking dashboards**.

### What it does

Two modes:

#### 1. Coin Values (default)

Scrapes the price-by-grade charts for entire coin series. One series page (e.g. Morgan Dollars) yields every year/mint with full grade pricing in a single pass.

Returns per coin:

- Denomination, series, year, mint mark, variety
- Mintage
- **Values by grade**: G-4, VG-8, F-12, VF-20, EF-40, AU-50, MS-60, MS-65, PR-63 (USD)
- Number of items currently for sale
- Coin page URL

With **Scrape Coin Detail Pages** enabled, each coin is enriched with:

- Metal composition, designer/engraver, diameter, weight
- Melt value (live metal value)
- Coin image
- Estimated-value summary text

#### 2. Marketplace Listings

Set **Scrape Marketplace Listings** to ON to scrape coins for sale matching your search queries: title, price, seller, condition, certification agency (PCGS/NGC/raw), best-offer / free-shipping flags, image, and listing URL.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `searchQueries` | array | Series names (coin-values mode) e.g. `["morgan","peace dollar","mercury dime"]`, or free-text searches (listings mode) e.g. `["morgan dollar 1921"]`. Empty = all series. |
| `listings` | boolean | OFF = scrape coin values (default). ON = scrape marketplace listings. |
| `scrapeDetails` | boolean | Coin-values mode only. Visit each coin page for composition, designer, melt value, image. |
| `maxResults` | integer | Max records (0 = unlimited). Default 200. |
| `proxyConfiguration` | object | Optional proxy. The site has no anti-bot, so a proxy is not required. |

#### Example — coin values

```json
{
  "searchQueries": ["morgan dollar", "peace dollar"],
  "scrapeDetails": false,
  "maxResults": 200
}
```

#### Example — all coin values with full detail

```json
{
  "searchQueries": [],
  "scrapeDetails": true,
  "maxResults": 0
}
```

#### Example — marketplace listings

```json
{
  "searchQueries": ["morgan dollar 1921"],
  "listings": true,
  "maxResults": 100
}
```

### Output sample (coin value)

```json
{
  "recordType": "coin_value",
  "coinId": "3192",
  "denomination": "dollars",
  "series": "morgan",
  "year": 1879,
  "mintMark": "P",
  "variety": null,
  "mintage": 14807100,
  "valuesByGrade": {
    "G-4": 70, "VG-8": 76, "F-12": 82, "VF-20": 89,
    "EF-40": 94, "AU-50": 102, "MS-60": 124, "MS-65": 725, "PR-63": 4704
  },
  "estimatedValueAvg": 76,
  "estimatedValueUncMin": 124,
  "estimatedValueUncMax": 725,
  "proofValue": 4704,
  "itemsForSale": 38,
  "coinUrl": "https://www.usacoinbook.com/coins/3192/dollars/morgan/1879-P/",
  "scrapedAt": "2026-06-24T12:00:00.000Z"
}
```

### Notes

- Series names supported: morgan, peace, lincoln cents, mercury dime, buffalo nickel, walking liberty, barber, seated liberty, and many more across all 22 US denominations.
- Prices reflect USA Coin Book's estimated values (numismatic + live precious-metal portion).
- Data is for research/informational purposes. Respect USA Coin Book's terms of use.

# Actor input Schema

## `searchQueries` (type: `array`):

Coin series / types to scrape. In coin-values mode, each query matches a series by name, e.g. 'morgan', 'peace dollar', 'lincoln cents', 'mercury dime', 'buffalo nickel'. Leave empty to scrape ALL series. In marketplace listings mode, each query is a free-text search, e.g. 'morgan dollar 1921'.

## `listings` (type: `boolean`):

When OFF (default), scrapes coin VALUE price charts (prices by grade G/VG/F/VF/EF/AU/MS/PR, mintage, melt value). When ON, scrapes marketplace listings for sale matching your search queries (title, price, seller, condition, certification).

## `scrapeDetails` (type: `boolean`):

Coin-values mode only. When ON, visits each individual coin page to add composition, designer, diameter, weight, melt value, image, and estimated-value text. Slower but richer. When OFF, uses the fast series price-chart table.

## `maxResults` (type: `integer`):

Maximum number of records to scrape. Set to 0 for unlimited (all available). Default is 200.

## `proxyConfiguration` (type: `object`):

Proxy settings. USA Coin Book serves data without anti-bot, so a proxy is optional; recommended for large-scale runs.

## Actor input object example

```json
{
  "searchQueries": [
    "morgan dollar"
  ],
  "listings": false,
  "scrapeDetails": false,
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "morgan dollar"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("lulzasaur/usacoinbook-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": ["morgan dollar"] }

# Run the Actor and wait for it to finish
run = client.actor("lulzasaur/usacoinbook-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "morgan dollar"
  ]
}' |
apify call lulzasaur/usacoinbook-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lulzasaur/usacoinbook-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/X8IK2hfBsLHKXhI16/builds/Y7ggfUQqpfc3awsdR/openapi.json