BestPrice Agent Commerce · Schema
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. |
JSON Schema
{
"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.
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.