{
  "openapi": "3.0.1",
  "info": {
    "title": "Cardmarket Scraper",
    "description": "Daily EU trading card market prices from Cardmarket for 20 games. Trend price, lowest listing, 1/7/30-day averages and foil variants for both single cards and sealed product, with real set names and price movement since your last run.",
    "version": "0.0",
    "x-build-id": "C2eYEEqF6erHSilen"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/unfenced-group~cardmarket-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-unfenced-group-cardmarket-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/unfenced-group~cardmarket-scraper/runs": {
      "post": {
        "operationId": "runs-sync-unfenced-group-cardmarket-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/unfenced-group~cardmarket-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-unfenced-group-cardmarket-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": {
          "game": {
            "title": "Trading card game",
            "enum": [
              "pokemon",
              "magic",
              "yugioh",
              "onepiece",
              "lorcana",
              "digimon",
              "fleshandblood",
              "starwarsunlimited",
              "dragonballsuper",
              "riftbound",
              "cyberpunk",
              "battlespiritssaga",
              "finalfantasy",
              "forceofwill",
              "cardfightvanguard",
              "weissschwarz",
              "starwarsdestiny",
              "worldofwarcraft",
              "mylittlepony",
              "dragoborne",
              "thespoils"
            ],
            "type": "string",
            "description": "Which trading card game to price. One run covers one game, and every filter below applies inside that game only. Example: pokemon.",
            "default": "pokemon"
          },
          "searchQuery": {
            "title": "Card name contains",
            "type": "string",
            "description": "Case-insensitive filter on the product name. Leave empty to return the whole game catalogue. Example: charizard.",
            "default": ""
          },
          "productType": {
            "title": "Product type",
            "enum": [
              "singles",
              "sealed",
              "all"
            ],
            "type": "string",
            "description": "Single cards, sealed product (booster boxes, displays, elite trainer boxes, tins, theme decks), or both. Example: singles.",
            "default": "singles"
          },
          "expansionNames": {
            "title": "Expansions",
            "type": "array",
            "description": "Keep only these expansions, named exactly as they appear in the chosen game. Accepts the resolved set name or, for Magic, the three-letter set code. Leave empty to search every expansion in the game. Example: [\"Base Set\", \"Jungle\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "priceMinEur": {
            "title": "Minimum trend price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep products whose trend price is at least this many euros. Leave empty for no lower bound. Example: 5."
          },
          "priceMaxEur": {
            "title": "Maximum trend price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep products whose trend price is at most this many euros. Leave empty for no upper bound. Example: 500."
          },
          "onlyPriced": {
            "title": "Only products with a price",
            "type": "boolean",
            "description": "Skip products that have no trend price in today's price guide. Turn off to include the full catalogue including unpriced products. Ignored for games Cardmarket lists but does not price yet. Example: true.",
            "default": true
          },
          "includeUsPrices": {
            "title": "Add US market comparison (Magic only)",
            "type": "boolean",
            "description": "Adds the US market price per card and the EU/US spread percentage, for arbitrage between Cardmarket and the US market. Available for Magic: The Gathering only and adds about a minute to the run. Example: false.",
            "default": false
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "trendDesc",
              "trendAsc",
              "momentum",
              "name"
            ],
            "type": "string",
            "description": "Order of the returned rows. Use momentum to surface the biggest short-term movers first. Example: trendDesc.",
            "default": "trendDesc"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of products to return. Controls your spend exactly. Example: 1000. Applies to price guide mode only.",
            "default": 1000
          },
          "startUrls": {
            "title": "Product URLs (live listing mode)",
            "type": "array",
            "description": "Cardmarket product pages to read live seller offers from. Adding at least one URL switches the run to live listing mode; the price guide fields above are then ignored. Filters already in the URL are kept. Example: https://www.cardmarket.com/en/Pokemon/Products/Singles/151/Charizard-ex-MEW199?language=1&minCondition=2.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxListingsPerUrl": {
            "title": "Max listings per product",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many offers to return per product URL, cheapest first as Cardmarket sorts them. Cardmarket shows up to 50 offers per page. Example: 3.",
            "default": 50
          },
          "maxItems": {
            "title": "Max listings in total",
            "minimum": 0,
            "type": "integer",
            "description": "Overall cap on listings across all product URLs. Leave empty or 0 for no overall cap. Example: 300."
          },
          "language": {
            "title": "Card language",
            "enum": [
              "any",
              "English",
              "French",
              "German",
              "Spanish",
              "Italian",
              "S-Chinese",
              "Japanese",
              "Portuguese",
              "Russian",
              "Korean",
              "T-Chinese"
            ],
            "type": "string",
            "description": "Only return offers in this print language. Example: English.",
            "default": "any"
          },
          "minCondition": {
            "title": "Minimum condition",
            "enum": [
              "any",
              "MT",
              "NM",
              "EX",
              "GD",
              "LP",
              "PL",
              "PO"
            ],
            "type": "string",
            "description": "Only return offers in this condition or better. Example: NM.",
            "default": "any"
          },
          "isReverseHolo": {
            "title": "Reverse holo only",
            "type": "boolean",
            "description": "Only return reverse holo offers (Pokémon). Example: false.",
            "default": false
          },
          "isFoil": {
            "title": "Foil only",
            "type": "boolean",
            "description": "Only return foil offers. Example: false.",
            "default": false
          },
          "isFirstEd": {
            "title": "First edition only",
            "type": "boolean",
            "description": "Only return first edition offers. Example: false.",
            "default": false
          },
          "isSigned": {
            "title": "Signed only",
            "type": "boolean",
            "description": "Only return signed cards. Example: false.",
            "default": false
          },
          "isAltered": {
            "title": "Altered only",
            "type": "boolean",
            "description": "Only return altered cards. Example: false.",
            "default": false
          },
          "isPlayset": {
            "title": "Playsets only",
            "type": "boolean",
            "description": "Only return playset offers. Example: false.",
            "default": false
          },
          "sellerCountry": {
            "title": "Seller country",
            "enum": [
              "any",
              "AT",
              "BE",
              "BG",
              "CH",
              "CY",
              "CZ",
              "DE",
              "DK",
              "EE",
              "ES",
              "FI",
              "FR",
              "GB",
              "GR",
              "HR",
              "HU",
              "IE",
              "IS",
              "IT",
              "LI",
              "LT",
              "LU",
              "LV",
              "MT",
              "NL",
              "NO",
              "PL",
              "PT",
              "RO",
              "SE",
              "SI",
              "SK"
            ],
            "type": "string",
            "description": "Only return offers shipped from this country, as an ISO code. Example: NL.",
            "default": "any"
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "any",
              "private",
              "commercial",
              "professional",
              "powerseller"
            ],
            "type": "string",
            "description": "Only return offers from this kind of seller. Example: private.",
            "default": "any"
          },
          "minPrice": {
            "title": "Minimum offer price (EUR)",
            "minimum": 0,
            "type": "number",
            "description": "Skip offers cheaper than this. Useful to ignore 0.02 EUR review-farming offers. Example: 0.05."
          },
          "maxPrice": {
            "title": "Maximum offer price (EUR)",
            "minimum": 0,
            "type": "number",
            "description": "Skip offers more expensive than this. Example: 50."
          },
          "excludeSellers": {
            "title": "Exclude sellers",
            "type": "array",
            "description": "Cardmarket usernames whose offers should be left out, for example your own shop. Usernames are never written to the output. Example: [\"MyShop\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includePriceGuide": {
            "title": "Add price guide figures",
            "type": "boolean",
            "description": "Attach Cardmarket's daily trend, low and 1/7/30-day averages for the offered printing (holo figures for reverse holo, foil figures for foil). Off uses the regular figures shown on the product page. Example: true.",
            "default": true
          },
          "includeSellerNames": {
            "title": "Include seller usernames",
            "type": "boolean",
            "description": "Add the seller's Cardmarket username and shop link to each offer, for buyers who want to know whom to order from. Off by default. Example: false.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}