Bestprice Search Products Input

ShoppingPrice ComparisonE-CommerceRetailMCPWebMCPAgent CommerceGreece

Properties

Name Type Description
query string Product name, model, category, or natural-language shopping need. Greek and English are accepted.
locale string Response locale. The current service supports el-GR.
country string Shopping market. The current service supports Greece (GR).
price_min number Optional minimum product price in EUR, before shipping.
price_max number Optional maximum product price in EUR, before shipping.
required_features array Optional relevance hints such as OLED, Wi-Fi, or noise cancellation. They are not independently verified for every result; confirm them on the product page.
sort string Result order. Use relevance unless the user explicitly asks for cheapest or most expensive first.
limit integer Maximum number of grouped products to return, from 1 to 8.
View JSON Schema on GitHub

JSON Schema

bestprice-search-products-input.json Raw ↑
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Product name, model, category, or natural-language shopping need. Greek and English are accepted."
    },
    "locale": {
      "default": "el-GR",
      "description": "Response locale. The current service supports el-GR.",
      "type": "string",
      "const": "el-GR"
    },
    "country": {
      "default": "GR",
      "description": "Shopping market. The current service supports Greece (GR).",
      "type": "string",
      "const": "GR"
    },
    "price_min": {
      "description": "Optional minimum product price in EUR, before shipping.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "price_max": {
      "description": "Optional maximum product price in EUR, before shipping.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "required_features": {
      "default": [],
      "description": "Optional relevance hints such as OLED, Wi-Fi, or noise cancellation. They are not independently verified for every result; confirm them on the product page.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 50
      }
    },
    "sort": {
      "default": "relevance",
      "description": "Result order. Use relevance unless the user explicitly asks for cheapest or most expensive first.",
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc"
      ]
    },
    "limit": {
      "default": 8,
      "description": "Maximum number of grouped products to return, from 1 to 8.",
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bestprice-search-products-input"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.