Search live products across online retailers by keyword and price range

Search live products across online retailers by keyword and price range. Returns product names, prices, retailers, and direct purchase links. Use when an agent needs current shopping options or price-filtered product recommendations.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.402shelf.com/products/search

Our checks, last 30 days

We never call tools that send, buy, move money or file anything, not even without paying.

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "country": "US",
    "currency": "USD",
    "max_price": 100,
    "query": "wireless headphones",
    "result_limit": 1,
    "sort": "best_match"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$defs": {
    "codes0": {
      "enum": [
        "AE",
        "AI",
        "AR",
        "AT",
        "AU",
        "AW",
        "BE",
        "BM",
        "BR",
        "CA",
        "CC",
        "CH",
        "CL",
        "CO",
        "CX",
        "CZ",
        "DE",
        "DK",
        "ES",
        "FI",
        "FK",
        "FR",
        "GB",
        "GF",
        "GP",
        "GR",
        "GS",
        "HK",
        "HM",
        "HU",
        "ID",
        "IE",
        "IL",
        "IN",
        "IO",
        "IT",
        "JP",
        "KR",
        "KY",
        "MQ",
        "MS",
        "MX",
        "MY",
        "NC",
        "NF",
        "NL",
        "NO",
        "NZ",
        "PF",
        "PH",
        "PL",
        "PM",
        "PT",
        "RE",
        "RO",
        "RU",
        "SA",
        "SE",
        "SG",
        "SK",
        "TC",
        "TF",
        "TH",
        "TK",
        "TR",
        "TW",
        "UA",
        "US",
        "VG",
        "VN",
        "WF",
        "YT",
        "ZA"
      ]
    },
    "codes1": {
      "enum": [
        "AED",
        "AFN",
        "ALL",
        "AMD",
        "AOA",
        "ARS",
        "AUD",
        "AWG",
        "AZN",
        "BAM",
        "BBD",
        "BDT",
        "BHD",
        "BIF",
        "BMD",
        "BND",
        "BOB",
        "BOV",
        "BRL",
        "BSD",
        "BTN",
        "BWP",
        "BYN",
        "BZD",
        "CAD",
        "CDF",
        "CHE",
        "CHF",
        "CHW",
        "CLF",
        "CLP",
        "CNY",
        "COP",
        "COU",
        "CRC",
        "CUP",
        "CVE",
        "CZK",
        "DJF",
        "DKK",
        "DOP",
        "DZD",
        "EGP",
        "ERN",
        "ETB",
        "EUR",
        "FJD",
        "FKP",
        "GBP",
        "GEL",
        "GHS",
        "GIP",
        "GMD",
        "GNF",
        "GTQ",
        "GYD",
        "HKD",
        "HNL",
        "HTG",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "IQD",
        "IRR",
        "ISK",
        "JMD",
        "JOD",
        "JPY",
        "KES",
        "KGS",
        "KHR",
        "KMF",
        "KPW",
        "KRW",
        "KWD",
        "KYD",
        "KZT",
        "LAK",
        "LBP",
        "LKR",
        "LRD",
        "LSL",
        "LYD",
        "MAD",
        "MDL",
        "MGA",
        "MKD",
        "MMK",
        "MNT",
        "MOP",
        "MRU",
        "MUR",
        "MVR",
        "MWK",
        "MXN",
        "MXV",
        "MYR",
        "MZN",
        "NAD",
        "NGN",
        "NIO",
        "NOK",
        "NPR",
        "NZD",
        "OMR",
        "PAB",
        "PEN",
        "PGK",
        "PHP",
        "PKR",
        "PLN",
        "PYG",
        "QAR",
        "RON",
        "RSD",
        "RUB",
        "RWF",
        "SAR",
        "SBD",
        "SCR",
        "SDG",
        "SEK",
        "SGD",
        "SHP",
        "SLE",
        "SOS",
        "SRD",
        "SSP",
        "STN",
        "SVC",
        "SYP",
        "SZL",
        "THB",
        "TJS",
        "TMT",
        "TND",
        "TOP",
        "TRY",
        "TTD",
        "TWD",
        "TZS",
        "UAH",
        "UGX",
        "USD",
        "USN",
        "UYI",
        "UYU",
        "UYW",
        "UZS",
        "VED",
        "VES",
        "VND",
        "VUV",
        "WST",
        "XAD",
        "XAF",
        "XAG",
        "XAU",
        "XBA",
        "XBB",
        "XBC",
        "XBD",
        "XCD",
        "XCG",
        "XDR",
        "XOF",
        "XPD",
        "XPF",
        "XPT",
        "XSU",
        "XUA",
        "YER",
        "ZAR",
        "ZMW",
        "ZWG"
      ]
    },
    "priceFilter": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "applied_at": {
              "enum": [
                "local",
                "upstream_and_local"
              ]
            },
            "value": {
              "maximum": 1000000000,
              "minimum": 0,
              "type": "number"
            }
          },
          "required": [
            "value",
            "applied_at"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "condition": {
              "description": "Only used is supported. Omit for any condition; stock remains unverified.",
              "enum": [
                "used"
              ],
              "examples": [
                "used"
              ],
              "type": "string"
            },
            "country": {
              "$ref": "#/$defs/codes0",
              "description": "Required supported two-letter country code; selects Google Shopping location.",
              "examples": [
                "US"
              ],
              "type": "string"
            },
            "currency": {
              "$ref": "#/$defs/codes1",
              "description": "Optional ISO currency filter. No conversion; defaults to the country currency.",
              "examples": [
                "USD"
              ],
              "type": "string"
            },
            "max_price": {
              "description": "Inclusive maximum comparable product price; must be at least min_price.",
              "examples": [
                100
              ],
              "maximum": 1000000000,
              "minimum": 0,
              "type": "number"
            },
            "min_price": {
              "description": "Inclusive minimum comparable produ

This page as JSON