BestPrice Agent Commerce · Schema
Bestprice Compare Offers Input
ShoppingPrice ComparisonE-CommerceRetailMCPWebMCPAgent CommerceGreece
Properties
| Name | Type | Description |
|---|---|---|
| product_id | string | Exact grouped BestPrice product id returned by search_products, in bp_ |
| postal_code | string | Five-digit Greek delivery postal code used to calculate shipping and total cost. |
| objective | string | How to rank offers. Prefer lowest_total_cost because it includes known shipping. |
| in_stock_only | boolean | When true, omit offers that are not currently available. |
| minimum_merchant_rating | number | Optional minimum merchant rating on a 0 to 5 scale. |
| limit | integer | Maximum number of current merchant offers to return, from 1 to 10. |
JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"product_id": {
"type": "string",
"description": "Exact grouped BestPrice product id returned by search_products, in bp_<id> form."
},
"postal_code": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "Five-digit Greek delivery postal code used to calculate shipping and total cost."
},
"objective": {
"default": "lowest_total_cost",
"description": "How to rank offers. Prefer lowest_total_cost because it includes known shipping.",
"type": "string",
"enum": [
"lowest_total_cost",
"lowest_item_price",
"merchant_rating"
]
},
"in_stock_only": {
"default": true,
"description": "When true, omit offers that are not currently available.",
"type": "boolean"
},
"minimum_merchant_rating": {
"default": 0,
"description": "Optional minimum merchant rating on a 0 to 5 scale.",
"type": "number",
"minimum": 0,
"maximum": 5
},
"limit": {
"default": 10,
"description": "Maximum number of current merchant offers to return, from 1 to 10.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"product_id",
"postal_code"
],
"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-compare-offers-input"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.