{
  "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": "bhpVwvyRMSYSkWqSV"
  },
  "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": {
          "searchQueries": {
            "title": "Search by title",
            "type": "array",
            "description": "Series name, optionally with an issue number and year. Example: amazing spider-man 300, batman 1 2011, spawn. Without a number you get every issue of the series, up to the limit below.",
            "items": {
              "type": "string"
            }
          },
          "maxSeriesPerQuery": {
            "title": "Series read per search (1-20)",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many matching series each title search reads. Example: 3 reads the three best matches for \"batman\". An exact name match is used alone.",
            "default": 3
          },
          "series": {
            "title": "Whole series by name",
            "type": "array",
            "description": "Series names as PriceCharting lists them. Example: Amazing Spider-Man, X-Men, Spawn. Returns every issue of the best matching series.",
            "items": {
              "type": "string"
            }
          },
          "publishers": {
            "title": "Whole publishers",
            "type": "array",
            "description": "Pick one or more publishers. Series are read most popular first. Example: Marvel alone has about 2,000 series.",
            "items": {
              "type": "string",
              "enum": [
                "marvel",
                "dc",
                "image",
                "dark-horse",
                "dell",
                "other"
              ],
              "enumTitles": [
                "Marvel",
                "DC",
                "Image",
                "Dark Horse",
                "Dell",
                "Other publishers"
              ]
            }
          },
          "startUrls": {
            "title": "PriceCharting page links",
            "type": "array",
            "description": "Series pages, publisher pages or single issue pages. Example: https://www.pricecharting.com/console/comic-books-amazing-spider-man",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "productIds": {
            "title": "PriceCharting product IDs",
            "type": "array",
            "description": "Numeric ID of a single issue, shown on the issue page. Example: 2315040 (Amazing Spider-Man #300).",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max issues to return",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stops after this many issues. Free plan is capped at 10, paid up to 1,000,000. In monitor mode it counts every issue looked at, delivered or skipped. Example: 100.",
            "default": 10
          },
          "includePopulation": {
            "title": "Add CGC population (+1 event per issue)",
            "type": "boolean",
            "description": "Raw CGC graded-population count array for this issue.",
            "default": false
          },
          "includeIssueDetails": {
            "title": "Add issue details (+1 event per issue)",
            "type": "boolean",
            "description": "Genre, release date, publisher, and other series/issue attributes.",
            "default": false
          },
          "includePriceHistory": {
            "title": "Add price history (+1 event per issue)",
            "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": "Add eBay sold comps (+1 event per issue)",
            "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 repriced issues",
            "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",
            "type": "string",
            "description": "Optional label to run several independent monitors with the same settings. Example: weekly-spiderman. Leave empty to share state between runs of the same search.",
            "default": ""
          },
          "resetSeen": {
            "title": "Reset monitor memory 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}