{ "openapi": "3.0.1", "info": { "title": "IKEA Scraper", "description": "Scrape IKEA products across 63 markets: prices, discounts, ratings, exact dimensions, variants and 3D model links. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "ZDWaAfCtjaaJMH2zR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~ikea-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-ikea-scraper", "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/parseforge~ikea-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-ikea-scraper", "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/parseforge~ikea-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-ikea-scraper", "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": { "startUrls": { "title": "IKEA URLs", "type": "array", "description": "IKEA product, category or search URLs to scrape. Works with any of the 63 markets, for example https://www.ikea.com/us/en/cat/desks-computer-desks-20649/ or https://www.ikea.com/gb/en/p/micke-desk-white-80213074/. Leave empty to use the search terms and category below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Keywords to search on IKEA, one per line. Each term is searched separately.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "21828", "700172", "57297", "700173", "700174", "21826", "21827", "47747", "18902", "10705", "700674", "49968", "700401", "50009", "48981", "700537", "700564", "50003", "48987", "55990", "18736", "700633", "700313", "49081", "10786", "11705", "42246", "14319", "700453", "700467", "700468", "700470", "700469", "10699", "700403", "50374", "48982", "50382", "48988", "18852", "19053", "24831", "10787", "700521", "700518", "700516", "700517", "700522", "700520", "20492", "700519", "18735", "700398", "700404", "700400", "700710", "47406", "47407", "47405", "700395", "18695", "18694", "45781", "16257", "18690", "18700", "18716", "19121", "16248", "16214", "20636", "33498", "20643", "20645", "22663", "20862", "16244", "20864", "47360", "23607", "16201", "20519", "20524", "20523", "700339", "10555", "700215", "16233", "30565", "20724", "10736", "20490", "20615", "20804", "20723", "20859", "20858", "700450", "48940", "20719", "55010", "20808", "700214", "700819", "57280", "16284", "25205", "24822", "10651", "20533", "10681", "24827", "54992", "20527", "700319", "700278", "700226", "55024", "12152", "12158", "55031", "12151", "55032", "55022", "55026", "55023", "46053", "15908", "12153", "55029", "25211", "700222", "700218", "20528", "46193", "47395", "47396", "47394", "700393", "700820", "16281", "10382", "18864", "25212", "42245", "10412", "10574", "19048", "46457", "24260", "23610", "10409", "16195", "19144", "19141", "19143", "59251", "10784", "10760", "39569", "700600", "18752", "18750", "40843", "700225", "33504", "16296", "25223", "20542", "700676", "57527", "59307", "45925", "45783", "18701", "40845", "20481", "18707", "49150", "24256", "20609", "10759", "58411", "16283", "10565", "20602", "20618", "10452", "10455", "42925", "16044", "20622", "16045", "10716", "20667", "700753", "700754", "11704", "42247", "14318", "18623", "700553", "20660", "25216", "47068", "700424", "54173", "16246", "20634", "15927", "33499", "20812", "50384", "31774", "46082", "43636", "33547", "700816", "50010", "18692", "45855", "18755", "55012", "55015", "18892", "700426", "18891", "18893", "18894", "10700", "700420", "15947", "19037", "14971", "24861", "700177", "10659", "16308", "18862", "53249", "10573", "20652", "20653", "700336", "20502", "20649", "20651", "59245", "34006", "25219", "25220", "700417", "19145", "47361", "36212", "36213", "30572", "21825", "18860", "31781", "700194", "700196", "20825", "50387", "15938", "10410", "16305", "39570", "10698", "700759", "700758", "20535", "20530", "24257", "700818", "47081", "10451", "20496", "18872", "18869", "18868", "10680", "20529", "700413", "59285", "59286", "59284", "59283", "700594", "35766", "59247", "10717", "700458", "700485", "700486", "700491", "48992", "48991", "48993", "50007", "48995", "700484", "49015", "700483", "700493", "700492", "700390", "46083", "21829", "10655", "10687", "14349", "700796", "42921", "700718", "10385", "47445", "25214", "43632", "39266", "18865", "55014", "10731", "10776", "700527", "24823", "25222", "20606", "15950", "15937", "700586", "57654", "49145", "23615", "20824", "700588", "50379", "50388", "700388", "20630", "49139", "20857", "20798", "10789", "55397", "47067", "56516", "47070", "55002", "700440", "700779", "20814", "700423", "700421", "22664", "700826", "700823", "59246", "700411", "48007", "16293", "20525", "39267", "10459", "59240", "700525", "700451", "700462", "700463", "700465", "700464", "700386", "19064", "700382", "700457", "700478", "700479", "700481", "700480", "45782", "48005", "49156", "49154", "49157", "49149", "49227", "49153", "49152", "39519", "42926", "16256", "16274", "700442", "47426", "47425", "47427", "47424", "700773", "54941", "10778", "700524", "20813", "700712", "700671", "20823", "16280", "20608", "33508", "11703", "700176", "45732", "45731", "45730", "45847", "45815", "20483", "18775", "18776", "24711", "18723", "20479", "18769", "20477", "24715", "24714", "18708", "31773", "18767", "18724", "18773", "37899", "18777", "18774", "45848", "45816", "18706", "700414", "18768", "18714", "19039", "18851", "24255", "700817", "700292", "700589", "24264", "700195", "700293", "24258", "10482", "10471", "15946", "16282", "18850", "15949", "20676", "20678", "24263", "24259", "20677", "18705", "10984", "18849", "15934", "16298", "48978", "49318", "48977", "700708", "700668", "700717", "700716", "700715", "33546", "10805", "10803", "10804", "20491", "24830", "24859", "55004", "20601", "48925", "10696", "20928", "20516", "54943", "20514", "20515", "36816", "57542", "11845", "700373", "700220", "55033", "50008", "50002", "10779", "30454", "19049", "53257", "700629", "10668", "700528", "10567", "20499", "20657", "700713", "24825", "24824", "24826", "700513", "700673", "25217", "20500", "10692", "20536", "27821", "50380", "33515", "50389", "20815", "48006", "20489", "700539", "700541", "700542", "700540", "700538", "700610", "15935", "20669", "11811", "22957", "21960", "21961", "31786", "46078", "57537", "20562", "20561", "20560", "43631", "20531", "57298", "700372", "20656", "700869", "700356", "700699", "45780", "18699", "31772", "700459", "700494", "700495", "700523", "20654", "47069", "47084", "14317", "700535", "700534", "700533", "43634", "47990", "20926", "42924", "24898", "47386", "59249", "46400", "21964", "21963", "700192", "17893", "21966", "700351", "21967", "21965", "700615", "34205", "24331", "700349", "55998", "700543", "700544", "54942", "700619", "17897", "21959", "34203", "21962", "700618", "46401", "30436", "17895", "34204", "700350", "21958", "700617", "700191", "21957", "17894", "17887", "700616", "20810", "50383", "15928", "55987", "23609", "16200", "10551", "16202", "700178", "25215", "19112", "40206", "19106", "20087", "19113", "19115", "42242", "19086", "24337", "19110", "18751", "41068", "700353", "18890", "18904", "700529", "18871", "20539", "31787", "20494", "24887", "10797", "18861", "20484", "10996", "20534", "33500", "46460", "35769", "35767", "18746", "20537", "58412", "45924", "700419", "22669", "18737", "20821", "20819", "50377", "50385", "20811", "50376", "20907", "20929", "700441", "41070", "700512", "47359", "34470", "20822", "700562", "700563", "700561", "700611", "700370", "700828", "700555", "700223", "700224", "700219", "46080", "59244", "24860", "10653", "10689", "18863", "700714", "12553", "20635", "22665", "10783", "49768", "20874", "10671", "700776", "23613", "49117", "23614", "49118", "23598", "700698", "20495", "16043", "20619", "16047", "18867", "14350", "20544", "700221", "20659", "20658", "47380", "10456", "10454", "16295", "10658", "18908", "40692", "40693", "40690", "49147", "35768", "18866", "700171", "700369", "24262", "20721", "700477", "50011", "48979", "700471", "700466", "700472", "55988", "55985", "55984", "700630", "10663", "55997", "43635", "700775", "36209", "700175", "56472", "42248", "59308", "36813", "36815", "36812", "36814", "49142", "49143", "49144", "49763", "49140", "46192", "10656", "22275", "57536", "10664", "700631", "31785", "700640", "47388", "700632", "46077", "15951", "20506", "700778", "24828", "700412", "55008", "700607", "20611", "22659", "59248", "10550", "10397", "11465", "46052", "700180", "18740", "700795", "48986", "48985", "700575", "47423", "24924", "10732", "700179", "20538", "11844", "20541", "700675", "700456", "700473", "700474", "700476", "700475", "20621", "700777", "18730", "700841", "10670", "18903", "700515", "48944", "47441", "16292", "48943", "20520", "700560", "20474", "18734", "18753", "25209", "16215", "16255", "16048", "700558", "700557", "700559", "700556", "700337", "55993", "55992", "55989", "10475", "14885", "10810", "16285", "20820", "19059", "10782", "49096", "25221", "20927", "700793", "50959", "40844", "20620", "700418", "20720", "54989", "59250", "20498", "49138", "10769", "700365", "700363", "25213", "700599", "47443", "700359", "43633", "20617", "700425", "10788", "23608", "10785", "10757", "20503", "24858", "33507", "20504", "10398", "20505", "37900", "25206", "700821", "700822", "49079", "20521", "16213", "700352", "20493", "46194", "700628", "10701", "18870", "15952", "49160", "49151", "46081", "40842", "41069", "20631", "42948", "18738", "25227" ], "type": "string", "description": "Browse a whole IKEA category instead of searching. All 887 category IDs are verified against the live API and are the same in every market, so the names come back translated.", "default": "" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "market": { "title": "Market", "enum": [ "us/en", "ca/en", "ca/fr", "gb/en", "ie/en", "au/en", "de/de", "at/de", "ch/de", "ch/fr", "ch/it", "fr/fr", "es/es", "it/it", "nl/nl", "be/nl", "be/fr", "pt/pt", "pl/pl", "cz/cs", "sk/sk", "hu/hu", "ro/ro", "hr/hr", "si/sl", "rs/sr", "ee/et", "lv/lv", "lt/lt", "se/sv", "dk/da", "no/no", "fi/fi", "jp/ja", "kr/ko", "cn/zh", "in/en", "sg/en", "my/en", "th/th", "ph/en", "il/he", "sa/en", "sa/ar", "ae/en", "ae/ar", "kw/en", "kw/ar", "qa/en", "qa/ar", "bh/en", "bh/ar", "om/en", "om/ar", "jo/en", "jo/ar", "eg/en", "eg/ar", "ma/fr", "ma/ar", "mx/es", "cl/es", "co/es" ], "type": "string", "description": "IKEA market to scrape. Each market has its own assortment, its own prices in local currency and its own language for product names and categories.", "default": "us/en" }, "sortBy": { "title": "Sort By", "enum": [ "RELEVANCE", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "NEWEST", "RATING", "MOST_POPULAR", "NAME_ASCENDING", "WIDTH", "HEIGHT", "DEPTH", "LENGTH" ], "type": "string", "description": "Sort order, taken from IKEA's own sort menu.", "default": "RELEVANCE" }, "zipCode": { "title": "ZIP / Postal Code", "type": "string", "description": "Optional. Supply a postal code for the chosen market and IKEA returns delivery availability for every product. Without it the availability column stays empty." }, "includeDetails": { "title": "Include Product Details", "type": "boolean", "description": "Fetch each product page for its full description, exact width/height/depth and 3D model URL. Adds roughly 5 seconds per 30 products.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "IKEA's API is open, so this Actor runs without a proxy by default. Turn it on for very large runs or if you scrape from a restricted network.", "default": { "useApifyProxy": 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 } } } } } } } } } }