JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/ikea/product with Content-Type: application/json and your Authorization: Bearer header.
{
"url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/",
"store_id": "170"
}// request reference
IKEA Product parameters
Send query parameters with GET /api/ikea/product. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
urlPublic HTTPS product URL on this retailer's site.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 4096
store_idRetailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 8
- Pattern: ^[0-9]{1,8}$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, product, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_metadata": {
"retailer": "IKEA",
"provider_url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/",
"total_time_taken": 0.706,
"store_id": "170",
"postal_code": "60440",
"store_name": "IKEA Chicago - Bolingbrook"
},
"search_parameters": {
"url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/",
"store_id": "170"
},
"product": {
"product_id": "20522046",
"title": "BILLY Bookcase - white 31 1/2x11x79 1/2 \"",
"url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/",
"brand": "IKEA",
"description": "BILLY Bookcase - white 31 1/2x11x79 1/2 \". Adjustable shelves can be arranged according to your needs. A simple unit can be enough storage for a limited space or the foundation for a larger storage solution if your needs change. 1 stationary shelf and 4 adjustable shelves included.",
"image": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590272_pe1038911_s5.jpg",
"images": [
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590272_pe1038911_s5.jpg",
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237507_pe917999_s5.jpg",
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__1424760_pe979354_s5.jpg",
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237435_pe917974_s5.jpg",
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237565_pe918022_s5.jpg",
"https://www.ikea.com/us/en/images/products/billy-bookcase-white__0723342_pe733920_s5.jpg"
],
"price": {
"amount": 79,
"currency": "USD"
},
"availability": "HIGH_IN_STOCK",
"rating": 4.5,
"review_count": 2096,
"sku": "205.220.46",
"store_availability": {
"store_id": "170",
"status": "HIGH_IN_STOCK",
"quantity": 89,
"in_stock": true,
"pickup_available": true
}
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}