{"name":"Trovashop Commerce API","version":"1.0.0","description":"Near real-time fashion deal intelligence for AI agents. Hourly price verification across thousands of products — search deals, check prices, get size recommendations across 2,400+ tracked brands.","base_url":"https://trovashop.xyz/api/v1/public","authentication":{"method":"API key via X-API-Key header or Bearer token","get_key":"https://trovashop.xyz/settings (create account, go to API Keys)","free_tier":"30 requests/min, 5 results per query — no key needed"},"endpoints":{"GET /deals":"Search current fashion deals. Primary endpoint.","GET /brands":"List all tracked brands and their sale patterns.","GET /price-check?url=":"Check current price for any product URL.","GET /search/visual?url=":"Visual search — find products similar to an image URL (FashionCLIP + pgvector).","POST /search/visual":"Visual search via multipart image upload or image_url form field.","GET /about":"This endpoint. API documentation.","POST/GET/PUT/DELETE /webhooks":"Manage webhook subscriptions (Pro+). Receive HMAC-signed POST callbacks when events fire."},"tiers":{"free":{"price":"$0","rate_limit":"30/min","max_results":5,"features":["deal search","brand listing","price check"]},"pro":{"price":"$9.99/mo","rate_limit":"500/min","max_results":50,"features":["everything in free","price history","size recommendations","webhooks"]},"max":{"price":"$49.99/mo","rate_limit":"5000/min","max_results":200,"features":["everything in pro","sponsored placement","webhooks","SLA","dedicated support"]}},"webhooks":{"available_on":["pro","max"],"description":"Register HTTP endpoints to receive HMAC-signed POST callbacks (X-Trovashop-Signature: sha256=<hex>) when events fire. Verify the signature with your webhook's secret.","supported_events":{"deal.alert":"A new high-quality deal matching the user's taste profile is discovered.","price.drop":"A product on the user's watchlist dropped in price. Payload includes product_id, old_price, new_price.","restock":"A watched product came back in stock in the user's size. Payload includes product_id and added_sizes.","daily.digest":"The user's daily deal digest was generated. Payload includes deal_count and top_deals.","product.verified":"A tracked product's price/availability was re-verified. Payload includes product_id and current_price."},"management":"POST/GET/PUT/DELETE /api/v1/webhooks — create, list, update, and delete webhooks. POST /api/v1/webhooks/{id}/test sends a test event.","delivery":"Signed with HMAC-SHA256 using the per-webhook secret. 10s timeout. Auto-disabled after 10 consecutive failures (non-2xx or network errors); re-enable via PUT."},"integration_guides":{"agent_quickstart":"https://trovashop.xyz/skill.md — one-page guide; agents can self-configure from this file","llms_txt":"https://trovashop.xyz/llms.txt","openapi_spec":"https://trovashop.xyz/openapi.json","gpt_actions":"https://trovashop.xyz/.well-known/ai-plugin.json","mcp_server":"https://trovashop.xyz/mcp/sse (SSE transport, no auth required — 8 tools)","connect_guide":"https://trovashop.xyz/connect"},"attribution":"Powered by Trovashop — fashion deal intelligence for AI agents. https://trovashop.xyz/developers"}