{ "openapi": "3.0.1", "info": { "title": "Comic Books Scraper - PriceCharting", "description": "Scrape comic book prices from PriceCharting.com by series or issue URL: Ungraded, 4.0, 6.0, 8.0, 9.2 and 9.8 grades, a 14-point price guide, CGC population, price history and eBay sold comps. Export CSV, Excel, JSON. No login or API key. $0.02 per issue.", "version": "0.1", "x-build-id": "xQeCkCdamf00EPzF4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~comics-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-comics-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/recordsdata~comics-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-comics-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/recordsdata~comics-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-comics-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Comic book series listing pages (e.g. pricecharting.com/console/comic-books-amazing-spider-man), single issue pages, or a publisher page (pricecharting.com/brand/comic-books/marvel) from pricecharting.com. Optional when you use a search, product IDs, series or publishers below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search by title", "type": "array", "description": "Series name, optionally followed by an issue number and a year: \"amazing spider-man 300\", \"batman 1 2011\", \"spawn\". The name is matched against PriceCharting's index of comic series (all publishers) and the best matching series are read. Without a number you get every issue of the series, up to Max Items.", "items": { "type": "string" } }, "maxSeriesPerQuery": { "title": "Series per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many matching series each title search reads. An exact name match (for example \"batman\") is used alone; otherwise the series that start with or contain every word, most popular first.", "default": 3 }, "productIds": { "title": "PriceCharting product IDs", "type": "array", "description": "Numeric PriceCharting IDs of single issues, as shown in the productId column or in the Details table of an issue page (for example 2315040 for Amazing Spider-Man #300).", "items": { "type": "string" } }, "series": { "title": "Whole series by name", "type": "array", "description": "Series names as PriceCharting lists them (\"Amazing Spider-Man\", \"X-Men\", \"Spawn\"). Every issue of the best matching series, up to Max Items.", "items": { "type": "string" } }, "publishers": { "title": "Whole publishers", "type": "array", "description": "Walk every series of a publisher, most popular series first, up to Max Items. Marvel alone has about 2,000 series, so set Max Items.", "items": { "type": "string", "enum": [ "marvel", "dc", "image", "dark-horse", "dell", "other" ], "enumTitles": [ "Marvel", "DC", "Image", "Dark Horse", "Dell", "Other publishers" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: limited to 10 items (preview). Paid users: optional, max 1,000,000. In monitor mode it is the number of issues looked at, whether delivered or skipped.", "default": 10 }, "includePopulation": { "title": "CGC population", "type": "boolean", "description": "Raw CGC graded-population count array for this issue.", "default": false }, "includeIssueDetails": { "title": "Issue details", "type": "boolean", "description": "Genre, release date, publisher, and other series/issue attributes.", "default": false }, "includePriceHistory": { "title": "Price history", "type": "boolean", "description": "Full historical monthly price series for every grade (Ungraded, 4.0/VG, 6.0/Fine, 8.0/VF, 9.2/NM-, 9.8).", "default": false }, "includeSoldComps": { "title": "Sold comps", "type": "boolean", "description": "Recent eBay sold listings, tagged with the grade they sold at (Ungraded through 10.0) — all 14 grade tabs, not just one.", "default": false }, "onlyChanged": { "title": "Only new or price-changed issues (monitor mode)", "type": "boolean", "description": "Deliver only issues this same search did not return before, or whose price in any of the six grades moved since. Unchanged issues are skipped and not billed. Max Items is the number of issues looked at. Off by default.", "default": false }, "stateKey": { "title": "Monitor name (optional)", "type": "string", "description": "Optional label for the monitor state. Use a different label to run several independent monitors with identical settings. Leave empty to share state between runs of the same search.", "default": "" }, "resetSeen": { "title": "Reset seen issues before this run", "type": "boolean", "description": "Clear the stored list of already-seen issues and prices for this search (and Monitor name) before the run starts, so everything counts as new again.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }