curl --request POST \
--url https://api.valuechecker.net/beta/search/offers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"query": "<string>",
"image_urls": [
"<string>"
],
"images": [
"<string>"
],
"claimed_amount": 123,
"price_min": 123,
"price_max": 123
}'
{
"claimed_product": {
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"in_stock": true
},
"recommended_offer": {
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"offer_id": null,
"offer_url": "",
"master_name": "iphone 15",
"unmatched_specs": [],
"price": {
"currency": "GBP",
"price": 1299,
"price_date": "",
"is_refurbished": false,
"in_stock": true,
"blocked": false,
"shop": {
"shop_name": "medium",
"shop_status": 0,
"shop_score": 0
},
"item_quantity": 1,
"country_code": "uk",
"filtered_price": false
},
"offer_type": "clustered_product"
},
"indexed_products": {
"products": []
},
"clustered_products": {
"products": [
{
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"price_clusters": {
"low": {
"group": "low",
"price": 699,
"count": 2,
"percentage": 0.4,
"price_min": 699,
"price_max": 699
},
"medium": {
"group": "medium",
"price": 1299,
"count": 5,
"percentage": 1,
"price_min": 699,
"price_max": 1449
},
"high": {
"group": "high",
"price": 1449,
"count": 1,
"percentage": 0.2,
"price_min": 1449,
"price_max": 1449
}
}
}
]
},
"replacement_offers": {
"offer_groups": [
{
"metadata": {
"offer_count": 1
},
"offers": [
{
"pid": 2331632376,
"product_name": "APPLE iPhone 15 - 256 GB, Blue",
"brand": "APPLE",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"offer_id": null,
"offer_url": "https://www.google.com/shopping/product/1?gl=uk&hl=en&prds=pid:1455722616064547730",
"master_name": "APPLE iPhone 15 - 256 GB, Blue",
"unmatched_specs": [],
"price": {
"currency": "GBP",
"price": 699,
"price_date": "2025-04-30 10:24:53",
"is_refurbished": false,
"in_stock": true,
"blocked": false,
"shop": {
"shop_name": "Currys Business",
"shop_status": 0,
"shop_score": 0
},
"item_quantity": 1,
"country_code": "uk",
"filtered_price": false
}
}
]
}
]
},
"metadata": {
"category": {
"predicted_client_category_id": 2740,
"predicted_client_category": "Mobile Phones",
"prediction_certainty": 1
},
"query": {
"used_query": "iphone 15",
"original_query": "iphone 15",
"predicted_query": null
},
"price_filters": {
"price_min": null,
"price_max": null
}
}
}
curl --request POST \
--url https://api.valuechecker.net/beta/search/offers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"query": "<string>",
"image_urls": [
"<string>"
],
"images": [
"<string>"
],
"claimed_amount": 123,
"price_min": 123,
"price_max": 123
}'
{
"claimed_product": {
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"in_stock": true
},
"recommended_offer": {
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"offer_id": null,
"offer_url": "",
"master_name": "iphone 15",
"unmatched_specs": [],
"price": {
"currency": "GBP",
"price": 1299,
"price_date": "",
"is_refurbished": false,
"in_stock": true,
"blocked": false,
"shop": {
"shop_name": "medium",
"shop_status": 0,
"shop_score": 0
},
"item_quantity": 1,
"country_code": "uk",
"filtered_price": false
},
"offer_type": "clustered_product"
},
"indexed_products": {
"products": []
},
"clustered_products": {
"products": [
{
"pid": 1996341732,
"product_name": "iphone 15",
"brand": "",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"price_clusters": {
"low": {
"group": "low",
"price": 699,
"count": 2,
"percentage": 0.4,
"price_min": 699,
"price_max": 699
},
"medium": {
"group": "medium",
"price": 1299,
"count": 5,
"percentage": 1,
"price_min": 699,
"price_max": 1449
},
"high": {
"group": "high",
"price": 1449,
"count": 1,
"percentage": 0.2,
"price_min": 1449,
"price_max": 1449
}
}
}
]
},
"replacement_offers": {
"offer_groups": [
{
"metadata": {
"offer_count": 1
},
"offers": [
{
"pid": 2331632376,
"product_name": "APPLE iPhone 15 - 256 GB, Blue",
"brand": "APPLE",
"pic_url": "https://img.valuechecker.net/,---.jpg",
"specs": [],
"client_category_id": 2740,
"client_category": "Mobile Phones",
"offer_id": null,
"offer_url": "https://www.google.com/shopping/product/1?gl=uk&hl=en&prds=pid:1455722616064547730",
"master_name": "APPLE iPhone 15 - 256 GB, Blue",
"unmatched_specs": [],
"price": {
"currency": "GBP",
"price": 699,
"price_date": "2025-04-30 10:24:53",
"is_refurbished": false,
"in_stock": true,
"blocked": false,
"shop": {
"shop_name": "Currys Business",
"shop_status": 0,
"shop_score": 0
},
"item_quantity": 1,
"country_code": "uk",
"filtered_price": false
}
}
]
}
]
},
"metadata": {
"category": {
"predicted_client_category_id": 2740,
"predicted_client_category": "Mobile Phones",
"prediction_certainty": 1
},
"query": {
"used_query": "iphone 15",
"original_query": "iphone 15",
"predicted_query": null
},
"price_filters": {
"price_min": null,
"price_max": null
}
}
}
Note! Prefix your <api-key> with apiKey
. Note the space after "apiKey ".
The client ID for the request. It's required if you have access to multiple clients with your API key. Otherwise, it's optional.
Optional session identifier of the user.
OK
The response is of type object
.