{ "openapi": "3.0.1", "info": { "title": "LigaPokemon Scraper: Batch Search for Pokémon TCG Prices in BRL", "description": "Scrape Pokemon TCG card and sealed-product prices from LigaPokemon, Brazil's largest marketplace. Batch up to 20 searches per run for aggregated BRL pricing, last-sale history, and per-seller offers, the only LigaPokemon scraper with batch search. Export via API or Sheets. From $0.005/result.", "version": "0.0", "x-build-id": "3FA8C9mT4vjod1jRb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ligapokemon-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ligapokemon-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/getascraper~ligapokemon-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ligapokemon-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/getascraper~ligapokemon-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ligapokemon-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": [ "queries" ], "properties": { "queries": { "title": "Card or Product Searches", "minItems": 1, "maxItems": 20, "type": "array", "description": "One or more card or product names to search for on LigaPokemon (e.g. \"Charizard ex\", \"Booster Box Escarlate e Purpura\"). The best-known LigaPokemon scraper on the Store only accepts a single query per run, which is why its own usage shows around 180 runs per user per month, one run per card looked up. Add every card you need here instead and get them all back from one run.", "default": [ "Charizard" ], "items": { "type": "string" } }, "maxProductsPerQuery": { "title": "Max Matched Items per Query", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matched card printings or products to return for each search term, counting from LigaPokemon's own best-match order. Kept low by default so a run with several queries still finishes quickly; raise it if a search term is ambiguous and you want more of its variants.", "default": 10 }, "condition": { "title": "Card Condition Filter", "enum": [ "any", "M", "NM", "SP", "MP", "HP", "D" ], "type": "string", "description": "Only keep seller offers in this condition. Only applies when \"Include individual seller offers\" below is turned on; it has no effect on the aggregated price summary. Uses LigaPokemon's own condition codes.", "default": "any" }, "language": { "title": "Card Language Filter", "enum": [ "any", "DE", "ES", "FR", "ID", "EN", "IT", "JP", "KO", "PT", "PTEN", "RU", "TH", "TW" ], "type": "string", "description": "Only keep seller offers whose card is printed in this language. Only applies when \"Include individual seller offers\" below is turned on.", "default": "any" }, "fetchDetails": { "title": "Fetch Item Detail Pages", "type": "boolean", "description": "Opens each matched card or product's own detail page to collect the last-sale snapshot and individual seller offers below. This is one extra request per matched item on top of the free search-results summary, so it defaults off to keep runs fast. Turn it on to get either of the two options below.", "default": false }, "includeLastSale": { "title": "Include Last Sale Snapshot", "type": "boolean", "description": "Adds the most recently completed sale for each item (date, quantity, and price band) straight from LigaPokemon's own product page data. No login is required to read it, and it costs nothing extra once \"Fetch item detail pages\" is on, since it comes from the same page fetch. This is data the best-known competing LigaPokemon scraper does not document at all. Has no effect unless \"Fetch item detail pages\" is enabled.", "default": true }, "includeOffers": { "title": "Include Individual Seller Offers", "type": "boolean", "description": "Emits one row per individual seller listing (seller name, city, state, verification and shipping-tracking flags, condition, language) instead of just the aggregated summary row. Has no effect unless \"Fetch item detail pages\" is enabled. Note: LigaPokemon renders each individual listing's exact price and exact quantity through CSS position codes that are reshuffled on every page load, so both fields are returned as null on offer rows rather than a guessed number; use the aggregated priceMin/priceAvg/priceMax fields for pricing, and use offer rows to see who sells the item and in what condition or language.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "LigaPokemon blocks non-Brazilian IP addresses behind a Cloudflare managed challenge (confirmed with live requests: any non-Brazilian IP gets a 403 challenge page, while a Brazilian residential IP reaches real content). Brazilian residential proxy is required, not optional; leave the default as is.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } } } }, "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 } } } } } } } } } }