{
  "openapi": "3.0.1",
  "info": {
    "title": "eBay Sold Listings Intelligence",
    "description": "Get real market prices from eBay sold listings. See what items ACTUALLY sold for, not asking prices. Includes pricing analytics, market velocity, demand levels, and recommended listing price. Perfect for resellers, collectors, estate sales, inheritance sales.",
    "version": "0.0",
    "x-build-id": "a9asOYnii19RgElcl"
  },
  "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": {
          "query": {
            "title": "Search Query",
            "type": "string",
            "description": "Required unless you paste an eBay URL below. Enter keywords like 'iPhone 13 Pro 128GB', 'Pokemon Charizard card', 'vintage Levi's 501'. The more specific, the better your results."
          },
          "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 will extract the item title and search for comparable sales."
          },
          "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 (days)",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "Only include items sold in the last N days (max 90). eBay's sold search always covers roughly 90 days, so this is applied to the sold dates after scraping: narrowing it returns fewer items rather than different ones.",
            "default": 30
          },
          "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)."
          },
          "listingType": {
            "title": "Listing type",
            "type": "array",
            "description": "Filter by listing type (leave empty for all types)",
            "items": {
              "type": "string",
              "enum": [
                "auction",
                "buy_it_now",
                "best_offer"
              ]
            },
            "default": []
          },
          "categoryId": {
            "title": "eBay Category ID",
            "type": "string",
            "description": "Optional narrowing filter for an existing search (e.g., '9355' for Cell Phones). This does not replace Search Query or eBay URL."
          },
          "maxItems": {
            "title": "Max items to return",
            "minimum": 10,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of sold items to scrape (affects runtime and cost)",
            "default": 50
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "date_desc",
              "date_asc",
              "price_desc",
              "price_asc"
            ],
            "type": "string",
            "description": "How to sort the results",
            "default": "date_desc"
          },
          "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"
          },
          "enrichFromItemPages": {
            "title": "Fetch real 'days to sell'",
            "type": "boolean",
            "description": "Opens a sample of item pages to read real listing start dates, bid counts and watcher counts. eBay's search results carry no listing date, so this is what 'days to sell' is derived from. A bounded sample is used rather than every item, so a slow or blocked item page can never sink an otherwise good run. Turn off for a faster, cheaper run that omits those fields.",
            "default": true
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "eBay blocks datacenter IP addresses, so residential proxies are required for reliable results. 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}