{"openapi":"3.1.0","info":{"title":"AgentShopping","version":"0.1.0","description":"Shopping data API for AI agents and people. Shop links are affiliate advertisements. Rows with sample=true are fictional and must not be presented as live prices. Ranking never uses commission. Operated by Fias Company AS.","contact":{"email":"privacy@agentshopping.net","name":"Fias Company AS"}},"servers":[{"url":"https://agentshopping.net"}],"paths":{"/api/search_offers":{"get":{"operationId":"search_offers","summary":"Search offers","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Free text, brand, category or GTIN"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 3166-1 alpha-2, or ALL"},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 4217"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"toys, kids-gear or football"},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"1 to 50"},{"name":"lang","in":"query","required":false,"schema":{"type":"string"},"description":"en or nb"}],"responses":{"200":{"description":"Ranked offers grouped by currency. Includes disclaimer when sample data is present."}}}},"/api/get_product":{"get":{"operationId":"get_product","summary":"Get one product","parameters":[{"name":"slug","in":"query","required":false,"schema":{"type":"string"},"description":"Product slug"},{"name":"gtin","in":"query","required":false,"schema":{"type":"string"},"description":"GTIN/EAN"},{"name":"id","in":"query","required":false,"schema":{"type":"string"},"description":"Product UUID"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Limit offers to this market"},{"name":"lang","in":"query","required":false,"schema":{"type":"string"},"description":"en or nb"}],"responses":{"200":{"description":"Product, ranked offers, coupons, price history."},"404":{"description":"Not found"}}}},"/api/list_coupons":{"get":{"operationId":"list_coupons","summary":"List coupons","parameters":[{"name":"merchant","in":"query","required":false,"schema":{"type":"string"},"description":"Merchant slug"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"ISO country"},{"name":"include_expired","in":"query","required":false,"schema":{"type":"string"},"description":"1 to include expired codes"}],"responses":{"200":{"description":"Coupons with valid_from and valid_until."}}}},"/api/list_merchants":{"get":{"operationId":"list_merchants","summary":"List stores","description":"Categories, markets, currencies, price band, coupons, affiliate network and /go/ links. sample=true is not a live feed.","responses":{"200":{"description":"Store directory."}}}},"/api/find_stores_for":{"get":{"operationId":"find_stores_for","summary":"Find stores for a category and country","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"toys, kids-gear or football"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 3166-1 alpha-2"}],"responses":{"200":{"description":"Stores that sell the category, with shop links."}}}},"/mcp":{"post":{"operationId":"mcp","summary":"Streamable HTTP MCP endpoint","description":"JSON-RPC 2.0. Tools: search_offers, get_product, list_coupons. Send Accept: application/json or text/event-stream.","responses":{"200":{"description":"JSON-RPC result, or an SSE message event."}}}}}}