iwant.fyi · Schema
Want
Structured purchase intent (iwant.fyi demand-side protocol v1.1 §4).
Agentic CommerceMarketplaceAI AgentsPurchase IntentShoppingAutomotiveMCPA2AOpen Protocolx402Agent-Native
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Implementation-assigned UUID. |
| protocol_version | string | |
| title | string | |
| description | string | |
| category | string | |
| vertical | string | |
| mode | string | |
| price_cents | integer | |
| price_currency | string | ISO 4217 code. |
| location | object | |
| constraints | object | |
| origin | object | |
| client_token | string | |
| expires_at | string | |
| created_at | string | |
| updated_at | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://iwant.fyi/.well-known/iwantfyi/schemas/1.1/want.json",
"title": "Want",
"description": "Structured purchase intent (iwant.fyi demand-side protocol v1.1 §4).",
"type": "object",
"required": ["id", "protocol_version", "title", "price_cents", "price_currency"],
"properties": {
"id": { "type": "string", "description": "Implementation-assigned UUID." },
"protocol_version": { "type": "string", "enum": ["1.0", "1.1"] },
"title": { "type": "string", "minLength": 5, "maxLength": 200 },
"description": { "type": "string", "maxLength": 2000 },
"category": { "type": "string", "enum": ["goods", "services", "other"] },
"vertical": { "type": "string" },
"mode": { "type": "string", "enum": ["new", "used", "any"] },
"price_cents": { "type": "integer", "minimum": 0 },
"price_currency": { "type": "string", "description": "ISO 4217 code." },
"location": {
"type": "object",
"properties": {
"text": { "type": "string" },
"lat": { "type": "number" },
"lng": { "type": "number" },
"radius_km": { "type": "number" }
}
},
"constraints": {
"type": "object",
"properties": {
"rules": { "type": "object" },
"negotiable": { "type": "array", "items": { "type": "string" } },
"auto_accept": { "type": ["object", "null"] }
}
},
"origin": {
"type": "object",
"properties": {
"agent_id": { "type": "string" },
"agent_name": { "type": "string" },
"session_id": { "type": "string" }
}
},
"client_token": { "type": "string", "maxLength": 128 },
"expires_at": { "type": "string", "format": "date-time" },
"created_at": { "type": "string", "format": "date-time" },
"updated_at": { "type": "string", "format": "date-time" }
}
}
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/iwant-fyi-want"
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.