{
  "openapi": "3.0.1",
  "info": {
    "title": "eBay Trading Card Comps",
    "description": "Sold eBay comps for sports cards and Pokémon/TCG cards, split by grade. Reads PSA, BGS, SGC, CGC and other grades from every sold listing, separates raw from graded, and summarizes median, average and range per grade. No login.",
    "version": "0.1",
    "x-build-id": "kwpW2Xel0aTJDswYR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~ebay-trading-card-comps/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-ebay-trading-card-comps",
        "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/epicscrapers~ebay-trading-card-comps/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-ebay-trading-card-comps",
        "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/epicscrapers~ebay-trading-card-comps/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-ebay-trading-card-comps",
        "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": "Cards to search",
            "type": "array",
            "description": "One card per entry, written the way you would search eBay: year, set, player or character, card number, e.g. 2018 Prizm Luka Doncic #280 or Charizard Base Set 4/102. Leave the grade out to get every grade in one run, split into raw, PSA 10, PSA 9, BGS 9.5 and so on.",
            "items": {
              "type": "string"
            }
          },
          "site": {
            "title": "eBay site",
            "enum": [
              "ebay.com",
              "ebay.co.uk",
              "ebay.de",
              "ebay.fr",
              "ebay.it",
              "ebay.es",
              "ebay.ca",
              "ebay.com.au"
            ],
            "type": "string",
            "description": "eBay marketplace to search. Prices are in its currency.",
            "default": "ebay.com"
          },
          "days": {
            "title": "Sold in the last (days)",
            "minimum": 1,
            "type": "integer",
            "description": "Only sales from the last N days. eBay keeps about 90 days of sold listings. Ignored when you set a sold-from date.",
            "default": 90
          },
          "maxItems": {
            "title": "Max sales per card",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum sold listings saved for each card. Each saved sale is one result.",
            "default": 100
          },
          "gradeFilter": {
            "title": "Graded or raw",
            "enum": [
              "all",
              "raw",
              "graded"
            ],
            "type": "string",
            "description": "Raw only keeps cards without a grading company in the title. You don't need words like raw or ungraded in your query.",
            "default": "all"
          },
          "graders": {
            "title": "Grading companies",
            "type": "array",
            "description": "Only slabs from these companies. Selecting one also selects graded cards only.",
            "items": {
              "type": "string",
              "enum": [
                "PSA",
                "BGS",
                "SGC",
                "CGC",
                "TAG",
                "CSG",
                "HGA",
                "ACE",
                "BVG",
                "BCCG",
                "GMA",
                "KSA",
                "MNT",
                "ISA",
                "AGS",
                "PCA",
                "ARS"
              ],
              "enumTitles": [
                "PSA",
                "BGS (Beckett)",
                "SGC",
                "CGC",
                "TAG",
                "CSG",
                "HGA",
                "ACE",
                "BVG (Beckett Vintage)",
                "BCCG",
                "GMA",
                "KSA",
                "MNT",
                "ISA",
                "AGS",
                "PCA",
                "ARS"
              ]
            },
            "default": []
          },
          "minGrade": {
            "title": "Min grade",
            "minimum": 1,
            "maximum": 10,
            "type": "number",
            "description": "Only graded cards with at least this numeric grade (1 to 10, half grades allowed, e.g. 9.5)."
          },
          "maxGrade": {
            "title": "Max grade",
            "minimum": 1,
            "maximum": 10,
            "type": "number",
            "description": "Only graded cards with at most this numeric grade (1 to 10)."
          },
          "excludeLots": {
            "title": "Exclude lots and bundles",
            "type": "boolean",
            "description": "Leave out lots, bundles, multi-card listings and \"you pick\" listings, whose price is not the price of one card.",
            "default": true
          },
          "excludeParallels": {
            "title": "Base cards only",
            "type": "boolean",
            "description": "Leave out parallels and numbered cards (Silver, Refractor, Gold /10…) so the comps compare the base card only. Uses the parallel and print run read from the title.",
            "default": false
          },
          "matchCardNumber": {
            "title": "Same card number only",
            "type": "boolean",
            "description": "When your query has a card number (#US175, #280, 4/102), leave out sales whose title names a different card number, e.g. Jered Weaver #US26 for \"2011 Topps Update Mike Trout #US175\". Titles without a card number are kept. \"175\", \"US-175\" and \"US175\" count as the same number.",
            "default": true
          },
          "excludeKeywords": {
            "title": "Exclude titles containing",
            "type": "array",
            "description": "Leave out sales whose title contains any of these words or phrases (not case-sensitive), e.g. reprint, custom, proxy.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "number",
            "description": "Only sales at or above this price, in the site's currency."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "number",
            "description": "Only sales at or below this price, in the site's currency."
          },
          "soldFrom": {
            "title": "Sold from",
            "type": "string",
            "description": "Only sales on or after this date. Overrides \"Sold in the last (days)\"."
          },
          "soldTo": {
            "title": "Sold to",
            "type": "string",
            "description": "Only sales on or before this date."
          },
          "category": {
            "title": "Card category",
            "enum": [
              "auto",
              "sports",
              "tcg",
              "nonSport",
              "all"
            ],
            "type": "string",
            "description": "Automatic searches card game singles (Pokémon, Magic, One Piece…) for card game queries and sports card singles for everything else, and falls back to all categories when that finds nothing.",
            "default": "auto"
          },
          "categoryId": {
            "title": "Custom eBay category ID",
            "pattern": "^\\d*$",
            "type": "string",
            "description": "Search this eBay category instead, e.g. 261328. Overrides \"Card category\"."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}