{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Search", "description": "Get confirmed eBay sold prices — not asking prices. Search by keyword across 8 marketplaces, filter by date range, and export clean structured data for comps, resale pricing, and market research.", "version": "1.11", "x-build-id": "OcNPPU18xdB9cOgMC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/caffein.dev~ebay-sold-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-caffein.dev-ebay-sold-listings", "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/caffein.dev~ebay-sold-listings/runs": { "post": { "operationId": "runs-sync-caffein.dev-ebay-sold-listings", "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/caffein.dev~ebay-sold-listings/run-sync": { "post": { "operationId": "run-sync-caffein.dev-ebay-sold-listings", "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": { "keywords": { "title": "Keywords", "minItems": 1, "maxItems": 6, "uniqueItems": true, "type": "array", "description": "One or more search keywords. Each keyword runs as a separate search with the same filters applied to all.", "items": { "type": "string" } }, "keyword": { "title": "Keyword (deprecated — use Keywords)", "type": "string", "description": "Single search keyword. Deprecated: use the 'keywords' array field instead." }, "daysToScrape": { "title": "Days to Scrape", "minimum": 1, "maximum": 90, "type": "integer", "description": "Number of days back to scrape sold listings (default: 30)", "default": 30 }, "count": { "title": "Count", "minimum": 1, "type": "integer", "description": "Number of listings to scrape (default: 100)", "default": 100 }, "categoryId": { "title": "Category", "enum": [ "0", "20081", "550", "2984", "267", "12576", "625", "15032", "11450", "11116", "1", "58058", "293", "14339", "237", "45100", "99", "172008", "26395", "11700", "281", "11232", "11233", "619", "1281", "870", "10542", "316", "888", "64482", "260", "1305", "220", "3252", "1249" ], "type": "string", "description": "eBay category filter", "default": "0" }, "subcategoryId": { "title": "Subcategory", "enum": [ "", "261068", "261070", "49018", "261071", "261069", "261943", "183780", "109475", "184304", "183746", "159685", "45013", "61787", "46526", "1269", "20091", "1217", "37978", "4707", "20082", "2207", "22422", "23048", "37958", "37965", "163091", "181726", "12", "261755", "20094", "156323", "20096", "261588", "36098", "181307", "181293", "181296", "52480", "1291", "552", "262051", "551", "2211", "28009", "360", "553", "554", "20158", "156196", "47127", "50342", "47128", "45208", "47129", "165993", "43985", "179469", "179474", "43990", "183745", "179443", "260019", "163222", "147285", "20413", "117034", "117032", "2988", "2990", "134282", "162183", "184343", "20435", "184339", "117029", "73470", "261761", "158963", "21196", "31626", "64642", "21208", "180924", "31753", "31754", "29580", "180918", "74994", "182100", "260556", "260590", "176991", "260560", "260565", "260575", "113814", "100221", "117016", "82563", "45453", "20398", "45452", "45454", "19205", "19206", "7111", "437", "49021", "439", "1620", "49020", "19203", "20445", "20460", "175750", "262977", "37644", "20416", "54257", "175749", "46289", "46290", "46292", "46291", "20736", "3211", "166096", "2883", "166101", "1294", "63723", "26434", "31269", "63728", "29223", "29792", "261186", "118254", "280", "184644", "45110", "117104", "117106", "117107", "101691", "179775", "179784", "73980", "31633", "30102", "97042", "179792", "16044", "180972", "41976", "180983", "259207", "180981", "260851", "260908", "46544", "260901", "1268", "116996", "263016", "183447", "46534", "159693", "26261", "11759", "258061", "185130", "45033", "182941", "259031", "185133", "11724", "179697", "78997", "4684", "15200", "31388", "150044", "69323", "64353", "30078", "45089", "27432", "182074", "30090", "21162", "3326", "28179", "181378", "181405", "75232", "106983", "181381", "181404", "181403", "16102", "46782", "20552", "66693", "66694", "66695", "66696", "16708", "21255", "102325", "4256", "3144", "102328", "6049", "63073", "20740", "116363", "100411", "20738", "20741", "43304", "9394", "9355", "136699", "45065", "175744", "38331", "146492", "15052", "182064", "178893", "182073", "259327", "66741", "66725", "259328", "259329", "259330", "261974", "98476", "98478", "84607", "98477", "19019", "19027", "58799", "2663", "259621", "259338", "300", "39482", "4733", "3377", "18466", "169305", "3444", "253", "3412", "179197", "256", "3411", "58507", "178078", "83274", "58520", "3452", "183455", "183460", "34", "1404", "966", "593", "183459", "183454", "261044", "261045", "183457", "183456", "1335", "13658", "66502", "14429", "261595", "66503", "156277", "29797", "562", "898", "263076", "1401", "63", "1462", "3913", "13777", "137", "262050", "10860", "259135", "907", "261650", "13905", "261716", "1430", "13956", "262344", "182982", "124", "14005", "60811", "262413", "39507", "914", "29832", "1446", "3213", "412", "152", "113", "165800", "13849", "417", "597", "69851", "45058", "183062", "182094", "175673", "165", "162497", "171957", "175698", "11176", "3676", "31530", "175672", "3516", "259696", "162", "86722", "171961", "18793", "180235", "176970", "171485", "11189", "3286", "259701", "175837", "178894", "11783", "31723", "28162", "183118", "163778", "71183", "160667", "116652", "28131", "28102", "75576", "11788", "183302", "160737", "3122", "45074", "160706", "109125", "57261", "21558", "101689", "27391", "109124", "103458", "50348", "50344", "50345", "50346", "50347", "47130", "177832", "185023", "57262", "22679", "177831", "158990", "74469", "158999", "72576", "72577", "72578", "117102", "2907", "48080", "260781", "66674", "146531", "15559", "45456", "15558", "20397", "180268", "180273", "180274", "180275", "171127", "171138", "180276", "180278", "177796", "63057", "177792", "177791", "116381", "178061", "1202", "238", "2440", "262353", "11732", "11735", "2518", "11736", "83756", "184588", "181815", "181917", "182412", "181845", "181929", "73136", "19072", "1082", "19073", "19075", "48446", "14969", "1500", "185066", "183077", "261976", "261975", "261977", "104412", "196", "2329", "57", "2312", "1424", "2362", "45101", "261978", "261979", "261980", "261981", "261982", "261983", "261984", "261985", "11730", "183810", "57017", "183868", "183970", "183853", "183887", "261987", "50677", "50647", "50692", "155101", "67681", "19078", "767", "1196", "183949", "183905", "42904", "119111", "26217", "42905", "20408", "20404", "184344", "157325", "2986", "32872", "23590", "162032", "101437", "261988", "261989", "261990", "261992", "261993", "261994", "177797", "66789", "46310", "46314", "20755", "20759", "29723", "179961", "179985", "261030", "261028", "179973", "180001", "28059", "158913", "28064", "44075", "28066", "158927", "179836", "62706", "185035", "258026", "79631", "257942", "258859", "159719", "29585", "11848", "112661", "179692", "88741", "88742", "179691", "88740", "88744", "32254", "3199", "54235", "175754", "88057", "38208", "38204", "2550", "180350", "40852", "2540", "16486", "2543", "20928", "116098", "116099", "116100", "20929", "102363", "100979", "100980", "100981", "32871", "181128", "181130", "47323", "181153", "260373", "181129", "83041", "16091", "102378", "170098", "170115", "3205", "177761", "66996", "260068", "53295", "260499", "260062", "42912", "31412", "182101", "31413", "260773", "11860", "177661", "261996", "152807", "110645", "34071", "110655", "110666", "72873", "260818", "180931", "36431", "30115", "75036", "75041", "82593", "185155", "184520", "184500", "185284", "184512", "3179", "177641", "177647", "41489", "156813", "170091", "117414", "117413", "166725", "38229", "181076", "16092", "11827", "31605", "38250", "262984", "258031", "20580", "31587", "159889", "41511", "15069", "15088", "3187", "259482", "30565", "20601", "41968", "160038", "170050", "170052", "170056", "170059", "170055", "170060", "41969", "112601", "41970", "115945", "260549", "75395", "159909", "48638", "115940", "185048", "185053", "259345", "43502", "20620", "79656", "42146", "20614", "73943", "36239", "36249", "262433", "22701", "7306", "31710", "383", "177904", "71131", "183979", "183997", "184027", "184037", "184062", "184112", "36275", "21567", "26328", "36276", "36278", "97072", "181784", "57516", "78186", "181730", "50924", "181736", "102481", "47103", "102487", "175817", "175816", "175818", "175815", "262017", "67720", "262018", "262019", "262020", "262021", "117389", "162037", "117390", "117392", "117391", "162038", "113372", "170171", "146532", "260013", "260015", "260988", "260017", "259154", "260621", "85879", "29508", "260624", "260611", "259322", "36027", "20637", "71237", "20652", "20667", "20696", "20635", "176937", "117503", "112581", "20706", "116022", "116880", "185136", "46573", "42294", "106437", "46576", "184042", "20702", "10285", "262026", "262027", "16085", "166244", "16081", "16084", "98978", "11236", "116023", "260308", "20715", "43563", "71258", "42231", "172020", "172025", "172027", "36413", "107956", "36409", "36449", "36448", "36453", "101972", "67661", "36454", "184161", "109551", "19273", "57004", "184149", "184174", "50356", "50358", "50357", "182118", "182113", "28175", "182132", "4250", "1059", "10290", "93427", "14085", "10292", "261999", "137843", "137839", "137856", "10298", "102493", "102502", "102518", "102513", "102520", "116109", "9047", "180339", "114299", "262301", "165991", "262319", "262320", "262321", "262324", "262323", "262327", "262325", "49974", "49992", "49998", "50014", "50025", "50041", "617", "381", "63821", "262053", "41676", "132975", "309", "52554", "52473", "176984", "176983", "262054", "618", "176985", "16212", "48458", "180008", "3858", "182150", "175696", "308", "180012", "180014", "180015", "12922", "181162", "52555", "10181", "180010", "180016", "260764", "260762", "36430", "260772", "260758", "47940", "121469", "19258", "180954", "159879", "159881", "11777", "159882", "1279", "180907", "100989", "180908", "162040", "3081", "180909", "20428", "37632", "20429", "121153", "33235", "37633", "20431", "98473", "94931", "66690", "20423", "20424", "117035", "2985", "61673", "50203", "11828", "58271", "25319", "11907", "159758", "260774", "180266", "67421", "113913", "67422", "63676", "63732", "80765", "50054", "98060", "66468", "178886", "31680", "20835", "3153", "184381", "16262", "19017", "158749", "19021", "145986", "2569", "19023", "145995", "181055", "137897", "11742", "137887", "11745", "178069", "43962", "6030", "38635", "10063", "107057", "6029", "102330", "102331", "3149", "102332", "3204", "102538", "79849", "102542", "79850", "102543", "182098", "111694", "112529", "73839", "15054", "15053", "96954", "56169", "48626", "262364", "262384", "262365", "262359", "262410", "170129", "14737", "6723", "1295", "90983", "6720", "42595", "173665", "2524", "150925", "19181", "19854", "2576", "158746", "153401", "19180", "1197", "26240", "97232", "46743", "46723", "57058", "46727", "47112", "47107", "20947", "171530", "20946", "47118", "19182", "19188", "34054", "168247", "182187", "182181", "171145", "84912", "102548", "102546", "116118", "102547", "102549", "102551", "25362", "25367", "25375", "46589", "67145", "259270", "50336", "47121", "50422", "47122", "47125", "45210", "73175", "257915", "71465", "109415", "109430", "71479", "19193", "19197", "19200", "262983", "136820", "20573", "91421", "262982", "20574", "175517", "180136", "180141", "134761", "117338", "177736", "177734", "177733", "177739", "177740", "177737", "101915", "96428", "177738", "47349", "11329", "75211", "11331", "11332", "184593", "149891", "149883", "149816", "149854", "149860", "260783", "47925", "179841", "168191", "31763", "67416", "82565", "16265", "159073", "23825", "50883", "47357", "16264", "29618", "33164", "177764", "36870", "21205", "177765", "29582", "21022", "164789", "164791", "164793", "164787", "776", "164785", "137902", "73260", "73263", "4779", "149074", "63108", "63112", "63113", "63116", "100417", "185054", "185044", "185058", "260672", "20863", "159178", "159180", "6093", "166235", "159181", "163147", "112425", "179310", "28015", "175759", "3259", "155240", "50115", "262343", "50116", "51", "24409", "212", "50123", "56080", "261332", "261331", "261329", "183436", "261893", "181423", "181416", "3468", "65174", "3478", "179377", "181417", "4742", "3499", "181422", "170137", "181424", "181421", "7898", "4752", "261", "181420", "2989", "180911", "121634", "66700", "2598", "158786", "74985", "230", "165956", "158769", "74996", "180921", "31773", "31774", "50101", "180919", "31776", "2916", "151563", "71164", "166201", "39989", "48633", "185065", "185061", "185034", "184973", "168058", "163829", "184972", "14961", "71582", "177896", "177900", "177899", "102537", "177891", "177901", "33916", "16705", "57589", "33917", "179276", "260797", "260799", "16021", "20846", "261245", "261242", "20862", "261247", "106460", "159135", "62168", "62166", "62229", "13340", "20869", "20870", "70898", "13343", "20871", "62230", "181940", "42297", "181992", "181968", "181948", "181998", "173634", "1306", "178892", "170591", "173633", "173635", "170594", "3253", "3244", "29523", "260176", "3247", "130140", "42622", "2638", "734", "40149", "106002", "150594", "100225", "131082", "131081", "100226", "100227", "131084", "164802", "147399", "16078", "164803", "1310", "98982", "93838", "16123", "173520", "29578", "183477", "19315", "113015", "98972", "164800", "98968", "58730", "32806", "175716", "60207", "156955", "14935", "168105", "33739", "6747", "3944", "182174", "260000", "182175", "156597", "54968", "139971", "38583", "171833", "156595", "139973", "262003", "262004", "262016", "262008", "262013", "262014", "30", "721", "19252", "727", "735", "74986", "719", "1184", "723", "229", "183073", "183069", "184645", "183070", "183071", "183068", "122773", "116183", "180957", "31287", "67678", "67670", "31416", "97033", "180960", "1278", "19262", "11776", "31817", "260328", "173696", "260325", "51020", "36121", "114262", "16052", "159137", "23806", "159149", "3767", "45209", "50334", "47105", "47106", "1468", "1467", "1469", "51005", "107000", "40147", "40148", "40968", "42307", "31822", "26423", "47258", "40967", "103459", "20585", "260060", "45515", "175757", "66799", "21225", "1303", "260696", "260717", "21233", "260376", "4251", "169291", "15724", "3034", "177017", "29521", "43560", "149242", "42154", "29518", "25863", "181003", "20727", "50354", "50350", "50351", "50352", "50353", "152950", "177602", "177601", "177603" ], "type": "string", "description": "Optional subcategory filter. Displayed as \"Category -> Subcategory\" for easier selection. If set, subcategory takes priority over the Category field (overrides _sacat). The output record will reflect the effective category ID and label used.", "default": "" }, "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": "eBay site to scrape from", "default": "ebay.com" }, "sortOrder": { "title": "Sort order", "enum": [ "endedRecently", "timeNewlyListed", "pricePlusPostageLowest", "pricePlusPostageHighest", "distanceNearest" ], "type": "string", "description": "Sort order for the sold search results page.", "default": "endedRecently" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "number", "description": "Minimum sold price filter (search-page filter)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "number", "description": "Maximum sold price filter (search-page filter)." }, "itemLocation": { "title": "Item location", "enum": [ "default", "domestic", "worldwide" ], "type": "string", "description": "Search-page item location filter.", "default": "default" }, "itemCondition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Search-page condition filter.", "default": "any" }, "detailedSearch": { "title": "Detailed search (visit item pages)", "type": "boolean", "description": "If enabled, visits each item detail page to extract item specifics, product details, breadcrumbs, condition, and other fields. Increases runtime and proxy usage.", "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 } } }, "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 } } } } } } } } } }