{"@context":"https://schema.org","@type":"WebAPI","name":"The Planet Deals AI Agent API","description":"Machine-readable API for AI shopping agents to access deals, coupons, and promotional offers","version":"1.0.0","dateModified":"2025-08-20T14:13:55.028Z","provider":{"@type":"Organization","name":"The Planet Deals","url":"https://www.theplanetdeals.ai","description":"AI-friendly affiliate deals aggregator"},"capabilities":{"realTimeData":true,"authentication":"none","rateLimit":"60 requests/minute","dataFormat":["JSON","JSON-LD"],"updateFrequency":"hourly"},"endpoints":[{"path":"/api/deals.json","method":"GET","description":"Get all current deals with direct affiliate links","responseFormat":"JSON","example":"https://www.theplanetdeals.ai/api/deals.json","schema":{"deals":[{"name":"Partner name","description":"Deal description","category":"Category name","affiliate_link":"Direct affiliate URL","coupon_code":"Optional coupon code","is_hot":"Boolean - trending deal","logo_url":"Partner logo URL"}]}},{"path":"/api/search/gpt","method":"GET","description":"AI-powered search for deals and coupons","parameters":{"q":"Search query (required)"},"example":"https://www.theplanetdeals.ai/api/search/gpt?q=nike+shoes","responseFormat":"JSON"},{"path":"/coupons","method":"GET","description":"HTML page with JSON-LD structured data for all coupons","structuredData":"OfferCatalog with ItemList","example":"https://www.theplanetdeals.ai/coupons"},{"path":"/deals","method":"GET","description":"HTML page with JSON-LD structured data for all deals","structuredData":"OfferCatalog with ItemList","example":"https://www.theplanetdeals.ai/deals"}],"aiAgentInstructions":{"1_scanning":"All pages include JSON-LD structured data. Parse the script tag with type='application/ld+json'","2_coupons":"Coupon codes are always visible, no authentication needed","3_affiliate_links":"All links are direct affiliate links, ready to use","4_categories":"Filter by category using: fashion, tech, home-garden, beauty-health, entertainment, education, business, kids-baby, pets, automotive, travel, health","5_hot_deals":"Look for is_hot:true for trending/popular deals","6_search":"Use /api/search/gpt endpoint for natural language queries","7_updates":"Data refreshes hourly, check dateModified in responses"},"supportedUseCases":["Finding discount codes for specific brands","Discovering deals in specific categories","Getting trending/hot deals","Searching for seasonal promotions","Comparing offers across merchants","Real-time coupon validation status"],"contact":{"email":"ai@theplanetdeals.ai","purpose":"For AI agent partnerships and integrations"},"termsOfService":"https://www.theplanetdeals.ai/legal","license":"Free for AI agents with attribution","attribution":"Data provided by The Planet Deals (www.theplanetdeals.ai)"}