{"openapi": "3.0.3", "info": {"title": "Beat This Price — 3-Gate Social Offer Verifier (DirectFeed + IsOfferLegit + SocialXRay)", "version": "2.0.0", "description": "Verifies product offers across 3 deterministic gates: Gate 1 DirectFeed (Shopify .js, Shoptet dataLayer, WooCommerce Store API, Schema.org Product JSON-LD), Gate 2 IsOfferLegit (RDAP domain age, TLS, EU VIES, CZ ARES+ADIS), and Gate 3 SocialXRay (brand social handles, scam template-icon traps, review stack, AggregateRating, community voucher tips, dynamic OpenGraph cards, and Hunter/Agent Leaderboard)."}, "servers": [{"url": "https://alertviz.com/api/btp"}], "paths": {"/health": {"get": {"summary": "Service health check", "responses": {"200": {"description": "OK"}}}}, "/v1/directfeed": {"get": {"summary": "Object-exact native JSON extractor (Product offer, HN item, or exact-slug WP post)", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Extracted native object or fail-closed error"}}}}, "/v1/verify": {"get": {"summary": "Run Gate 1 (DirectFeed) + Gate 2 (IsOfferLegit) + Gate 3 (SocialXRay)", "responses": {"200": {"description": "3-Gate verdict"}}}, "post": {"summary": "Run 3-Gate verification with JSON payload", "responses": {"200": {"description": "OK"}}}}, "/v1/challenges": {"get": {"summary": "List active public Beat This Price challenges", "responses": {"200": {"description": "OK"}}}, "post": {"summary": "Create a new public social challenge from a verified offer URL", "responses": {"201": {"description": "Created"}}}}, "/v1/challenges/{slug}": {"get": {"summary": "Get public challenge details, leader, rejected bait log, and community tips", "responses": {"200": {"description": "OK"}}}}, "/v1/challenges/{slug}/submit": {"post": {"summary": "Submit a challenger retailer URL with @handle / agent attribution", "responses": {"200": {"description": "OK"}}}}, "/v1/challenges/{slug}/tips": {"post": {"summary": "Post a community voucher code, stock confirmation, shipping note, or seller warning", "responses": {"201": {"description": "Added"}}}}, "/v1/tips/{id}/upvote": {"post": {"summary": "Upvote a helpful community deal tip (1 vote per IP)", "responses": {"200": {"description": "OK"}}}}, "/v1/challenges/{slug}/card.png": {"get": {"summary": "Dynamic PNG social scoreboard card for Slack/Discord/X/WhatsApp/Reddit OpenGraph", "responses": {"200": {"description": "image/png"}}}}, "/v1/challenges/{slug}/card.svg": {"get": {"summary": "Dynamic vector SVG scoreboard card", "responses": {"200": {"description": "image/svg+xml"}}}}, "/v1/challenges/{slug}/badge.svg": {"get": {"summary": "Compact Shields-style live challenge badge for forums & READMEs", "responses": {"200": {"description": "image/svg+xml"}}}}, "/v1/leaderboard": {"get": {"summary": "Live Deal-Hunter & AI-Agent Leaderboard", "responses": {"200": {"description": "OK"}}}}, "/v1/watchlist/diff": {"post": {"summary": "Run B2B competitor watchlist diff enriched with IsOfferLegit + SocialXRay", "responses": {"200": {"description": "OK"}}}}, "/v1/benchmark/summary": {"get": {"summary": "Return measured 100-URL benchmark scorecard", "responses": {"200": {"description": "OK"}}}}, "/mcp": {"post": {"summary": "Streamable HTTP JSON-RPC 2.0 MCP endpoint for AI agents", "responses": {"200": {"description": "JSON-RPC response"}}}}}}