POST
/
beta
/
search
/
offers
Offer Search
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
    }
  }
}

Authorizations

Authorization
string
header
required

Note! Prefix your <api-key> with apiKey. Note the space after "apiKey ".

Query Parameters

client_id
integer

The client ID for the request. It's required if you have access to multiple clients with your API key. Otherwise, it's optional.

session-id
string

Optional session identifier of the user.

Body

application/json

Response

200
application/json

OK

The response is of type object.