{
  "openapi": "3.0.1",
  "info": {
    "title": "Cardmarket Price Guide - MTG, Pokemon, Yu-Gi-Oh Card Prices",
    "description": "Cardmarket price guide for Magic, Pokemon, Yu-Gi-Oh, One Piece, Lorcana and 18 more card games: daily avg, low, trend and 1, 7, 30 day averages per card, foil or holo prices, joined with card names and expansion ids. Price change monitor mode. No login, no browser.",
    "version": "1.0",
    "x-build-id": "iFz7YmMVurYDc0ZnB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kamerozkan~cardmarket-price-guide/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kamerozkan-cardmarket-price-guide",
        "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/kamerozkan~cardmarket-price-guide/runs": {
      "post": {
        "operationId": "runs-sync-kamerozkan-cardmarket-price-guide",
        "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/kamerozkan~cardmarket-price-guide/run-sync": {
      "post": {
        "operationId": "run-sync-kamerozkan-cardmarket-price-guide",
        "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": [
          "games"
        ],
        "properties": {
          "games": {
            "title": "Games",
            "type": "array",
            "description": "Card games to read. Each game is one official Cardmarket price guide (refreshed daily). Names like Magic, MTG, Pokemon, Yu-Gi-Oh, One Piece, Lorcana, Flesh and Blood, Digimon, Dragon Ball Super, Star Wars Unlimited, Riftbound or Sorcery work, and so do Cardmarket game ids (1 = Magic, 3 = Yu-Gi-Oh, 6 = Pokemon, 18 = One Piece, 19 = Lorcana).",
            "default": [
              "Pokemon"
            ],
            "items": {
              "type": "string"
            }
          },
          "cardNames": {
            "title": "Card or product names",
            "type": "array",
            "description": "Keep only products whose name contains one of these words (case-insensitive), e.g. Charizard, Black Lotus, Blue-Eyes White Dragon, Booster Box. Leave empty for the whole price guide.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Cardmarket product ids (idProduct)",
            "type": "array",
            "description": "Your watchlist or inventory as Cardmarket idProduct numbers, e.g. 275404. Faster and exact for repricing a shop inventory.",
            "items": {
              "type": "string"
            }
          },
          "expansionNames": {
            "title": "Expansion names",
            "type": "array",
            "description": "Keep only products of expansions whose name contains one of these words, e.g. Base Set, Scarlet & Violet, Bloomburrow. Expansion names are taken from the sealed products of each expansion, so a few expansions without sealed products have no name; use expansion ids for those.",
            "items": {
              "type": "string"
            }
          },
          "expansionIds": {
            "title": "Expansion ids (idExpansion)",
            "type": "array",
            "description": "Keep only products of these Cardmarket expansion ids (idExpansion in the output).",
            "items": {
              "type": "string"
            }
          },
          "productType": {
            "title": "Product type",
            "enum": [
              "single",
              "sealed",
              "all"
            ],
            "type": "string",
            "description": "Singles (cards), sealed products (boosters, booster boxes, displays, tins, ETBs, decks) or both.",
            "default": "single"
          },
          "minTrendPrice": {
            "title": "Minimum trend price (EUR)",
            "type": "string",
            "description": "Skip products whose trend price is below this, e.g. 1 to skip bulk commons."
          },
          "maxTrendPrice": {
            "title": "Maximum trend price (EUR)",
            "type": "string",
            "description": "Skip products whose trend price is above this."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "trendDesc",
              "trendAsc",
              "risersFirst",
              "fallersFirst",
              "newestFirst",
              "none"
            ],
            "type": "string",
            "description": "Order of the rows. Risers first sorts by trend price against the 30-day average, which shows the cards that are moving up right now.",
            "default": "trendDesc"
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many rows. You are charged per row, so this also caps the cost of the run.",
            "default": 100
          },
          "onlyChangedPrices": {
            "title": "Price change monitor: only changed prices",
            "type": "boolean",
            "description": "Remember each product's trend price between runs and output (and charge) only products whose trend moved by at least the minimum change below. The first run outputs everything that matches as the baseline. Schedule it daily: the price guide refreshes once a day.",
            "default": false
          },
          "minChangePercent": {
            "title": "Minimum price change (%)",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Monitor mode: smallest trend price move, up or down, that counts as a change.",
            "default": 5
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Monitor mode: use a different name for each watchlist you track, so their remembered prices do not mix.",
            "default": "default"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}