BestPrice Agent Commerce · Schema
Bestprice Compare Offers Input
ShoppingPrice ComparisonE-CommerceRetailMCPWebMCPAgentic CommerceGreeceProduct RecommendationsShopping DecisionsDelivered Price
Properties
| Name | Type | Description |
|---|---|---|
| product_id | string | Exact grouped BestPrice product id returned by search_products, in bp_ |
| postal_code | string | Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost. Required for lowest_total_cost; optional for lowest_item_price and merchant_rating. |
| objective | string | How to rank offers. When omitted: lowest_total_cost if postal_code is given, otherwise lowest_item_price. lowest_total_cost includes known shipping and requires postal_code. |
| in_stock_only | boolean | false (default): every buyable offer, both immediately available and those that ship later with a delivery estimate (availability unknown stays marked unknown). true: only offers immediately 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",
"pattern": "^bp_[0-9]{10}$",
"description": "Exact grouped BestPrice product id returned by search_products, in bp_<id> form."
},
"postal_code": {
"description": "Greek delivery postcode (five digits, 10000 to 85999) used to calculate shipping and total cost. Required for lowest_total_cost; optional for lowest_item_price and merchant_rating.",
"type": "string",
"pattern": "^(?:[1-7][0-9]{4}|8[0-5][0-9]{3})$"
},
"objective": {
"description": "How to rank offers. When omitted: lowest_total_cost if postal_code is given, otherwise lowest_item_price. lowest_total_cost includes known shipping and requires postal_code.",
"type": "string",
"enum": [
"lowest_total_cost",
"lowest_item_price",
"merchant_rating"
]
},
"in_stock_only": {
"default": false,
"description": "false (default): every buyable offer, both immediately available and those that ship later with a delivery estimate (availability unknown stays marked unknown). true: only offers immediately available from stock. Out-of-stock offers are never returned.",
"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"
],
"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.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.