Contract
{
"type": "object",
"required": [
"keyword",
"location_code",
"language_code",
"depth"
],
"properties": {
"depth": {
"enum": [
48
],
"type": "integer",
"default": 48,
"description": "The number of organic results to collect; only 48 is offered."
},
"keyword": {
"type": "string",
"minLength": 1,
"description": "The product search term, as a shopper would type it."
},
"language_code": {
"enum": [
"en_US"
],
"type": "string",
"description": "The results language; only en_US (English, United States) is offered."
},
"location_code": {
"enum": [
2840
],
"type": "integer",
"description": "The market searched; only 2840 (United States) is offered."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "amazon_paid (a sponsored listing), amazon_serp (an organic listing) or related_searches (a block of related search terms)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "A related search term."
}
}
},
"description": "On a related_searches entry, the related search terms."
},
"title": {
"type": "string",
"description": "The product title."
},
"rating": {
"type": "object",
"properties": {
"value": {
"type": "number",
"description": "Average star rating."
},
"rating_max": {
"type": "number",
"description": "Top of the rating scale (5)."
},
"votes_count": {
"type": "number",
"description": "Number of ratings."
}
}
},
"currency": {
"type": [
"string",
"null"
],
"description": "The price's currency code."
},
"data_asin": {
"type": "string",
"description": "The product's ASIN."
},
"price_from": {
"type": [
"number",
"null"
],
"description": "The listed price; null when the listing shows none."
},
"rank_group": {
"type": "number",
"description": "Position among entries of the same type."
},
"delivery_info": {
"type": "object",
"properties": {
"delivery_message": {
"type": "string",
"description": "The delivery text shown on the listing."
}
}
},
"rank_absolute": {
"type": "number",
"description": "Position on the whole page."
},
"is_best_seller": {
"type": "boolean",
"description": "Whether the listing carries the Best Seller badge."
},
"special_offers": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Offer text shown on the listing (coupons, discounts)."
},
"is_amazon_choice": {
"type": "boolean",
"description": "Whether the listing carries the Amazon's Choice badge."
},
"bought_past_month": {
"type": [
"number",
"null"
],
"description": "The listing's bought-in-past-month badge figure, a rounded lower bound and not an exact count; a value under 50 may be a truncated badge figure; null when the listing shows none."
}
}
},
"description": "The page's entries, in page order."
},
"keyword": {
"type": "string",
"description": "The search term, as sent."
},
"datetime": {
"type": "string",
"description": "When the page was retrieved (UTC)."
},
"items_count": {
"type": "number",
"description": "The number of entries in items."
},
"se_results_count": {
"type": "number",
"description": "The total number of results the store reported for the term."
}
}
},
"description": "One result for the call."
}
},
"description": "The call's result, wrapped as results."
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0045045 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Oct 11, 2026
