{
  "openapi": "3.0.1",
  "info": {
    "title": "eBay Sold Price Checker: Real Sold Listings & Comps",
    "description": "What did it actually sell for on eBay? Verified mode runs eBay's own sold search on managed accounts: exact sale dates, final prices, shipping, auction or Buy It Now. Standard mode needs no account and reads sellers' public feedback. Recommended price, range, demand and a pricing report.",
    "version": "0.0",
    "x-build-id": "WYQZjcdnjfZlQMk06"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/marielise.dev~ebay-sold-listings-intelligence/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-marielise.dev-ebay-sold-listings-intelligence",
        "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/marielise.dev~ebay-sold-listings-intelligence/runs": {
      "post": {
        "operationId": "runs-sync-marielise.dev-ebay-sold-listings-intelligence",
        "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/marielise.dev~ebay-sold-listings-intelligence/run-sync": {
      "post": {
        "operationId": "run-sync-marielise.dev-ebay-sold-listings-intelligence",
        "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": {
          "dataSource": {
            "title": "Data source",
            "enum": [
              "standard",
              "verified"
            ],
            "type": "string",
            "description": "Verified runs eBay's real sold search (Sold Items filter) on our managed, logged-in eBay accounts: every sold listing with its exact sale date, final price, shipping, auction or Buy It Now, and bids. Standard needs no account: it reads the public feedback of sellers listing your item. If Verified is unavailable for a run, it falls back to Standard and is charged the Standard price.",
            "default": "standard"
          },
          "query": {
            "title": "Search Query",
            "type": "string",
            "description": "Item keywords, for example \"iPhone 13 Pro 128GB\" or \"Nintendo Switch OLED\". Be as specific as a buyer would be: model, capacity, edition."
          },
          "ebayUrl": {
            "title": "Or Paste eBay URL",
            "type": "string",
            "description": "Required unless you fill Search Query above. Paste a full eBay listing URL to find similar sold items. The Actor extracts the item title from the URL and searches for comparable sales, so the URL needs to contain the title (an /itm/Some-Item-Title/123456789 style link), not just the numeric item ID."
          },
          "ebaySite": {
            "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": "Which eBay marketplace to search. Auto-detected from URL if provided.",
            "default": "ebay.com"
          },
          "soldWithinDays": {
            "title": "Sold within",
            "minimum": 30,
            "maximum": 365,
            "type": "integer",
            "description": "How far back to look. Verified uses exact sale dates; Standard rounds to eBay's feedback bands: past month (30), past 6 months (180), past year (365).",
            "default": 180
          },
          "condition": {
            "title": "Condition filter",
            "type": "array",
            "description": "Filter by item condition (leave empty for all conditions)",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "open_box",
                "certified_refurbished",
                "like_new",
                "very_good",
                "good",
                "acceptable",
                "for_parts"
              ]
            },
            "default": []
          },
          "priceMin": {
            "title": "Min price",
            "minimum": 0,
            "type": "number",
            "description": "Minimum sold price, in the marketplace's own currency (USD on ebay.com, GBP on ebay.co.uk, EUR on ebay.de)."
          },
          "priceMax": {
            "title": "Max price",
            "minimum": 0,
            "type": "number",
            "description": "Maximum sold price, in the marketplace's own currency (USD on ebay.com, GBP on ebay.co.uk, EUR on ebay.de)."
          },
          "maxItems": {
            "title": "Max items to return",
            "minimum": 10,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum sold comps to return. Each comp is billed as one result; a run that finds fewer bills fewer.",
            "default": 50
          },
          "maxSellers": {
            "title": "Sellers to read",
            "minimum": 5,
            "maximum": 60,
            "type": "integer",
            "description": "Standard source only. How many sellers' public feedback profiles to read, ranked by how many listings they have for your query and how large their store is. More sellers, more comps, slower run.",
            "default": 20
          },
          "includeAnalytics": {
            "title": "Include Pricing Analytics",
            "type": "boolean",
            "description": "Generate pricing intelligence summary (avg/median price, condition impact, days to sell)",
            "default": true
          },
          "outputFormat": {
            "title": "Output format",
            "enum": [
              "full",
              "summary_only",
              "items_only"
            ],
            "type": "string",
            "description": "How much detail to return",
            "default": "full"
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Standard source only (Verified uses our own proxies). eBay blocks datacenter IP addresses, so residential proxies are required. Changing this away from RESIDENTIAL will very likely cause the run to be blocked.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}