{
  "openapi": "3.0.1",
  "info": {
    "title": "Pokemon Cards Scraper - Prices, Population & Grades",
    "description": "Scrape Pokemon card prices by grade (Ungraded, Grade 7 to PSA 10) from PriceCharting.com, plus PSA/CGC population reports, card details, price history and sold comps. Export CSV, Excel, JSON. No login or API key. Maps all 6 real grade prices for every card.",
    "version": "0.1",
    "x-build-id": "3ewoAEMlnZJQtcOev"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~pokemon-cards-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-pokemon-cards-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~pokemon-cards-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-pokemon-cards-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~pokemon-cards-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-pokemon-cards-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 card name",
            "type": "array",
            "description": "Card names or keywords, one per line, for example \"charizard\", \"pikachu promo\" or \"booster box base set\". Add a set name to narrow it (\"charizard base set\"). Pokemon only. Searches that name no set read the sets most popular first and can take a few minutes for a rare name; use Sets below to make it take seconds.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sets": {
            "title": "Whole sets (optional)",
            "type": "array",
            "description": "Pokemon sets to read in full, by name or slug, for example \"Base Set\", \"Jungle\", \"pokemon-fossil\" or \"Scarlet & Violet 151\". Type \"all\" for every set (about 300 sets, tens of thousands of cards: raise Max cards first). If you also fill Search by card name, the searches only look inside these sets.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "PriceCharting product IDs (optional)",
            "type": "array",
            "description": "Numeric IDs of single cards or sealed products, one per line, for example 630417 (Charizard #4, Base Set). Find the ID in the productId column of a previous run or in the Details table of a card page. IDs of other categories give an error row and are not charged.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Paste PriceCharting links (optional)",
            "type": "array",
            "description": "Set pages (pricecharting.com/console/pokemon-base-set), single card pages (pricecharting.com/game/pokemon-base-set/charizard-4) or the set index (pricecharting.com/category/pokemon-cards). Set pages are read card by card across all pages.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max cards (whole run)",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of cards returned across all sources above. Free plan: capped at 10 cards (preview). Paid plans: up to 1,000,000. In monitor mode it counts cards looked at, delivered or skipped.",
            "default": 10
          },
          "maxResultsPerQuery": {
            "title": "Cards per name search",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many cards each name search may return, for example 10. A search stops reading sets once it reaches this number. Max cards still caps the whole run.",
            "default": 10
          },
          "maxScanSeconds": {
            "title": "Max search time (seconds)",
            "minimum": 10,
            "maximum": 230,
            "type": "integer",
            "description": "Time limit for name searches that have to scan set pages, 10 to 230 seconds, for example 180. Each delivered card adds 60 seconds, so a productive search is not cut short. When the limit is hit the run keeps the cards already found. For a rare name, fill Whole sets instead. Product IDs, links and Whole sets alone are not affected.",
            "default": 180
          },
          "includeCardDetails": {
            "title": "Card details (billed separately)",
            "type": "boolean",
            "description": "Adds genre, release date, publisher, card number, print run and eBay/TCGPlayer reference IDs to each card.",
            "default": false
          },
          "includePopulation": {
            "title": "Grading population report (billed separately)",
            "type": "boolean",
            "description": "Adds the PSA/CGC population count and market price at every grade (1 to 10), taken from the card population-report page.",
            "default": false
          },
          "includePriceHistory": {
            "title": "Price history (billed separately)",
            "type": "boolean",
            "description": "Adds the monthly price series for every grade, from Ungraded to PSA 10.",
            "default": false
          },
          "includeSoldComps": {
            "title": "Sold comps (billed per listing)",
            "type": "boolean",
            "description": "Adds recent eBay/TCGPlayer sold listings for the 6 headline grades, each with grade, sale price and link. Billed as one sold-comps event per listing returned.",
            "default": false
          },
          "includeAllGradeSoldComps": {
            "title": "Sold comps for every grade (needs Sold comps)",
            "type": "boolean",
            "description": "Only works together with Sold comps. Also returns sold listings of up to 13 more grade tabs (Grade 1 to 6, BGS 10, BGS 10 Black, CGC 10, CGC 10 Pristine, SGC 10, TAG 10, ACE 10), often 100+ extra listings per card. Billed per listing returned.",
            "default": false
          },
          "onlyChanged": {
            "title": "Only new or changed cards",
            "type": "boolean",
            "description": "Return a card only if this same search has not returned it before or a price at any grade moved since. Unchanged cards are skipped and not billed. Schedule the actor (daily or weekly) to track price changes.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Label for the monitor memory, for example \"my-binder\". Use different labels to run several independent monitors with identical settings. Leave empty to share the memory between runs of the same search.",
            "default": ""
          },
          "resetSeen": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Clears the stored list of already-seen cards and prices for this search and Monitor name before the run, so every card 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}