# Beckett Scraper - BGS Population Report & Online Price Guide (`jungle_synthesizer/beckett-bgs-population-price-guide-scraper`) Actor Scrape Beckett.com for BGS population report data. Get per-card grade-by-grade BGS counts (Pristine 10, Gem Mint 9.5, Mint 9, NM-Mint+...). Cert-lookup mode verifies BGS/BVG/BCCG slabs. Filter by sport, set, player. Built for slab investors and collectors. - **URL**: https://apify.com/jungle\_synthesizer/beckett-bgs-population-price-guide-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** E-commerce, Other - **Stats:** 3 total users, 1 monthly users, 87.5% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Beckett BGS Population Report Scraper Scrapes [Beckett.com](https://www.beckett.com/grading/pop-report) for BGS graded-card population data. Returns per-card grade counts — Pristine 10, Gem Mint 9.5, Mint 9, NM-Mint+ 8.5, and so on down to lower grades — plus cert-lookup mode for verifying individual BGS, BVG, or BCCG slabs by serial number. --- ### Beckett BGS Population Report Scraper Features - Extracts the full BGS population table: grade-by-grade counts from Pristine 10 to lower grades for every card in a set - Filters by sport (Baseball, Basketball, Football, Hockey, Pokemon, and 30+ other categories), set name, and player - Returns the BGS-exclusive grade bands most scrapers ignore: 7, 7.5, 8, 8.5, 9, 9.5, Pristine 10, and Black Label 10 - Cert Lookup mode verifies individual BGS / BVG / BCCG slabs by serial number - Respects `maxItems` so test runs stay cheap - No browser required. Beckett's pop-report serves results as server-rendered HTML — CheerioCrawler handles it --- ### Who Uses BGS Population Data? - **Slab investors** — Track how many Pristine 10s exist for a specific parallel before bidding - **Card dealers** — Price slabs against the full grade distribution, not just the PSA pop equivalent - **Set registry collectors** — Identify low-pop cards in a set that are harder to complete than the checklist suggests - **Market researchers** — Compare BGS populations across years to find sets with constrained supply at high grades - **Data aggregators** — Join BGS pop data with PSA APR and CGC census for a complete graded-card supply picture --- ### How Beckett BGS Population Report Scraper Works 1. Submit the Beckett pop-report search form with your sport and set or player filter. The server returns a list of matching set pages. 2. Cap the seed to a manageable number of sets based on your `maxItems` limit. No point crawling 3,000 sets when you want 50 records. 3. Fetch each set's detail page. Each page contains the full population table — every card, every grade band, with first/last graded dates. 4. Parse and save each card row as a structured record. Done. --- ### Input ```json { "mode": "pop_report", "sport": "Baseball", "setName": "Topps Chrome", "playerName": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["DATACENTER"] } } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | string | `pop_report` | `pop_report` for population data, `cert_lookup` for slab verification | | `sport` | string | `Baseball` | Sport filter — Baseball, Basketball, Football, Hockey, Pokemon, etc. Required for pop\_report | | `sportId` | string | ``| Numeric Beckett sport ID (e.g. 185223 for Baseball). Overrides `sport` when set | | `setName` | string |`` | Keyword search for set name (Topps Chrome, Prizm, Pokemon Base) | | `playerName` | string | ``| Keyword search for player or card subject | | `certNumbers` | array |`` | List of cert serial numbers for cert\_lookup mode | | `certType` | string | `BGS` | Grader for cert lookup: BGS, BVG, or BCCG | | `maxItems` | integer | `10` | Maximum card records to return. 0 = unlimited | | `proxyConfiguration` | object | Datacenter | Proxy settings — datacenter is sufficient | **Cert Lookup mode:** ```json { "mode": "cert_lookup", "certNumbers": ["0009876543", "0001234567"], "certType": "BGS", "maxItems": 0 } ``` *** ### Beckett BGS Population Report Scraper Output Fields #### Population Report Mode ```json { "sport": "Baseball", "set_name": "2021 Topps Chrome", "set_year": 2021, "set_id": "5823401", "card_name": "Fernando Tatis Jr.", "card_number": "1", "player_or_subject": "Fernando Tatis Jr.", "total_graded": 482, "count_pristine_10": 4, "count_black_label_10": 0, "count_gem_mint_9_5": 187, "count_mint_9": 201, "count_nm_mint_plus_8_5": 63, "count_nm_mint_8": 19, "count_nm_plus_7_5": 5, "count_nm_7": 2, "count_lower_grades": 1, "first_graded_at": "October 12, 2021", "last_graded_at": "April 3, 2026", "pop_report_url": "https://www.beckett.com/grading/set_match/5823401" } ``` | Field | Type | Description | |-------|------|-------------| | `sport` | string | Sport category | | `set_name` | string | Full set name including year | | `set_year` | number | Year of the set | | `set_id` | string | Beckett internal set identifier | | `card_name` | string | Card title as listed in pop report | | `card_number` | string | Card number within the set | | `player_or_subject` | string | Player or card subject name | | `total_graded` | number | Total BGS-graded copies across all grades | | `count_pristine_10` | number | Count graded BGS Pristine 10 | | `count_black_label_10` | number | Count graded BGS Black Label 10 (all sub-grades 10) | | `count_gem_mint_9_5` | number | Count graded BGS Gem Mint 9.5 | | `count_mint_9` | number | Count graded BGS Mint 9 | | `count_nm_mint_plus_8_5` | number | Count graded BGS NM-Mint+ 8.5 | | `count_nm_mint_8` | number | Count graded BGS NM-Mint 8 | | `count_nm_plus_7_5` | number | Count graded BGS NM+ 7.5 | | `count_nm_7` | number | Count graded BGS NM 7 | | `count_lower_grades` | number | Count graded BGS 6.5 and below combined | | `first_graded_at` | string | Date first copy was graded by BGS | | `last_graded_at` | string | Date most recent copy was graded by BGS | | `pop_report_url` | string | Beckett pop-report URL for this set | *** ### 🔍 FAQ #### How do I scrape the Beckett BGS population report? Beckett BGS Population Report Scraper handles it. Set `sport` and `setName` (e.g. "Football" + "Prizm"), configure `maxItems` for the number of card records you want, and run. No account or subscription required — the pop report is public. #### How much does Beckett BGS Population Report Scraper cost to run? It charges $0.10 per actor start plus $0.0015 per card record. A run pulling 1,000 card records costs around $1.60. Large sweeps across a full set catalog run more but are still affordable relative to the data value. #### Does the scraper require proxies? Beckett BGS Population Report Scraper uses Apify datacenter proxies by default. Residential proxies are not needed — Beckett's pop-report runs on a standard Apache/PHP stack without Cloudflare protection. #### Can I filter by both sport and player at the same time? Yes. Set `sport`, `setName`, and/or `playerName` — they combine. Beckett requires a sport to return results, so always include `sport`. Adding a player or set name narrows the result list. #### How is BGS population data different from PSA APR data? BGS and PSA are separate grading services with separate populations. A card graded BGS 9.5 appears in the Beckett pop report; the same card graded PSA 10 appears in the PSA APR. They don't overlap. The BGS pop report covers 10M+ slabs — a different universe from PSA's dataset. Both are worth tracking. *** ### Need More Features? Need additional modes, more grade bands, or OPG pricing data? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use Beckett BGS Population Report Scraper? - **First BGS pop report actor on Apify** — PSA has competition; Beckett has this one - **Full grade breakdown** — Returns all grade bands including Black Label 10, not just the top-grade headline count that most manual lookups surface - **Affordable** — ~$0.0015/record, which is less than the time it takes to copy a number out of a browser # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `mode` (type: `string`): BGS Population Report or Cert Lookup by serial number. ## `sport` (type: `string`): Sport filter (Baseball / Basketball / Football / Hockey / Pokemon / etc). Required for pop\_report searches. ## `sportId` (type: `string`): Numeric sport\_id from Beckett form (e.g. 185223 for Baseball). Overrides sport field when set. ## `setName` (type: `string`): Keyword search for set name (e.g. Topps Chrome, Prizm, Pokemon Base). ## `playerName` (type: `string`): Keyword search for player or card subject. ## `certNumbers` (type: `array`): When mode=cert\_lookup, list of BGS/BVG/BCCG cert numbers to verify. ## `certType` (type: `string`): Grader brand for cert lookup. ## `maxItems` (type: `integer`): Maximum card records to return (0 = unlimited). Keep low for test runs. ## `proxyConfiguration` (type: `object`): No description ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "pop_report", "sport": "Baseball", "sportId": "", "setName": "Topps Chrome", "playerName": "", "certType": "BGS", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "pop_report", "sport": "Baseball", "sportId": "", "setName": "Topps Chrome", "playerName": "", "certType": "BGS", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/beckett-bgs-population-price-guide-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "pop_report", "sport": "Baseball", "sportId": "", "setName": "Topps Chrome", "playerName": "", "certType": "BGS", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/beckett-bgs-population-price-guide-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "pop_report", "sport": "Baseball", "sportId": "", "setName": "Topps Chrome", "playerName": "", "certType": "BGS", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call jungle_synthesizer/beckett-bgs-population-price-guide-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/beckett-bgs-population-price-guide-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Beckett Scraper - BGS Population Report & Online Price Guide", "description": "Scrape Beckett.com for BGS population report data. Get per-card grade-by-grade BGS counts (Pristine 10, Gem Mint 9.5, Mint 9, NM-Mint+...). Cert-lookup mode verifies BGS/BVG/BCCG slabs. Filter by sport, set, player. Built for slab investors and collectors.", "version": "0.1", "x-build-id": "hsvWfgMFv5atEApep" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~beckett-bgs-population-price-guide-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-beckett-bgs-population-price-guide-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~beckett-bgs-population-price-guide-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-beckett-bgs-population-price-guide-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~beckett-bgs-population-price-guide-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-beckett-bgs-population-price-guide-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Mode", "enum": [ "pop_report", "cert_lookup" ], "type": "string", "description": "BGS Population Report or Cert Lookup by serial number.", "default": "pop_report" }, "sport": { "title": "Sport", "type": "string", "description": "Sport filter (Baseball / Basketball / Football / Hockey / Pokemon / etc). Required for pop_report searches.", "default": "Baseball" }, "sportId": { "title": "Sport ID (advanced)", "type": "string", "description": "Numeric sport_id from Beckett form (e.g. 185223 for Baseball). Overrides sport field when set.", "default": "" }, "setName": { "title": "Set Name", "type": "string", "description": "Keyword search for set name (e.g. Topps Chrome, Prizm, Pokemon Base).", "default": "" }, "playerName": { "title": "Player / Subject", "type": "string", "description": "Keyword search for player or card subject.", "default": "" }, "certNumbers": { "title": "Cert Numbers", "type": "array", "description": "When mode=cert_lookup, list of BGS/BVG/BCCG cert numbers to verify.", "items": { "type": "string" } }, "certType": { "title": "Cert Type", "enum": [ "BGS", "BVG", "BCCG" ], "type": "string", "description": "Grader brand for cert lookup.", "default": "BGS" }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum card records to return (0 = unlimited). Keep low for test runs.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```