{"uid":"cap_bvYm4g9N9IyG0mAZU3Mql","slug":"syntalic-competitive-landscape-55a804f8","name":"Syntalic Competitive Landscape","description":"View every product and its current pricing within a category across retailers. Sortable by price, rating, or review count for competitive benchmarking. Cursor-paginated.","url":"https://api.syntalic.com/v1/marketing/competitive-landscape","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category"],"properties":{"limit":{"type":"integer","default":20,"example":20,"maximum":50,"description":"Max results to return (default 20, max 50)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"sort_by":{"enum":["price_asc","price_desc","rating","reviews"],"type":"string","default":"price_asc","example":"price_asc","description":"Sort order"},"category":{"type":"string","example":"electronics","minLength":1,"description":"Product category (e.g., electronics, grocery, beauty). Fuzzy human-readable input — the resolver maps it through tier 1-4 (id → exact name → trigram → embedding kNN) to a canonical category_id. Pair with `category_id` if you have a deterministic id from a prior call."},"retailer":{"enum":["amazon","walmart","costco","homedepot","nordstrom","ikea"],"type":"string","example":"amazon","description":"Filter to a specific retailer"}},"additionalProperties":false},"responseSchema":{"type":"object"},"example":{"request":{"limit":20,"country":"us","sort_by":"price_asc","category":"electronics","retailer":"amazon"},"response":{"meta":{"computed_at":"2026-06-18T05:48:27.901Z","served_from":"live","schema_version":"v3","freshness_seconds":84871,"price_observed_at_max":"2026-06-17T06:13:56.861Z","price_observed_at_min":"2026-05-18T17:40:57.530Z"},"items":[{"brand":"SmoTecQ","price":5.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":6.99,"product_id":"amazon:B0FC5SM9RT","promo_flag":true,"scraped_at":"2026-06-17T06:13:56.861Z","star_rating":null,"product_name":"SmoTecQ Lens Cleaning Kit – 180 Pre-Moistened Wipes & 2 Ultra-Soft Microfiber Cloths, Individually Wrapped, Streak-Free & Scratch-Free, Safe for Eyeglasses, Screens & Camera Lenses","review_count":null},{"brand":"Maylit","price":7.99,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B074KFP426","promo_flag":false,"scraped_at":"2026-05-20T12:55:53.775Z","star_rating":null,"product_name":"Tv Led Backlight, Maylit 8.2ft Led Strip Lights for 40-60in Tv, USB Powered Tv Lights kit with Remote, RGB Bias Lighting for Room Decor","review_count":null},{"brand":"Skullcandy","price":8.88,"in_stock":true,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B075F6TB7F","promo_flag":false,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"Skullcandy Jib Wired Earbuds with 3.5mm AUX Plug, Noise Isolating Fit, in-Line Microphone Call and Track Control, Convenient for Travel - Black","review_count":null},{"brand":"kurdene","price":9.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0D635YLCT","promo_flag":false,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"kurdene Wireless Earbuds Bluetooth 5.3 in Ear Buds Light Weight Headphones,Deep Bass Sound,Built in Mics Headset,Clear Calls Earphones for Sports Workout","review_count":null},{"brand":"Sony","price":9.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":14.88,"product_id":"amazon:B00NJ2M43M","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"Sony MDRZX110 Over-Ear Headphones (White)","review_count":null},{"brand":"Sony","price":9.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":12.99,"product_id":"amazon:B00JG2WRUO","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"Sony MDREX15AP/B In-Ear Headphones With Microphone (Black)","review_count":null},{"brand":"Fhumsh","price":13.99,"in_stock":false,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0GR697BBB","promo_flag":false,"scraped_at":"2026-06-09T21:45:52.233Z","star_rating":null,"product_name":"Wireless Earbuds Bluetooth 5.4 Headphones HiFi Stereo 50H Playback (Oil White)","review_count":null},{"brand":"SUNLU","price":13.99,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B07XG3RM58","promo_flag":false,"scraped_at":"2026-05-20T13:51:57.125Z","star_rating":null,"product_name":"SUNLU PLA 3D Printer Filament PLA Filament 1.75mm, Neatly Wound 3D Printing Filament 1.75mm, Dimensional Accuracy +/- 0.02 mm, Fit Most FDM 3D Printers, 1kg Spool (2.2lbs), Black","review_count":null},{"brand":"Pyle","price":14.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":19.99,"product_id":"amazon:B07GLXZNNL","promo_flag":true,"scraped_at":"2026-06-17T06:13:56.861Z","star_rating":null,"product_name":"Pyle Megaphone PA Portable Speaker for Outdoor, Cheerleading, Sports and More, 20W Compact Bullhorn with Siren and Volume Control","review_count":null},{"brand":"Blink","price":14.99,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B07X6C9RMF","promo_flag":false,"scraped_at":"2026-05-20T13:20:53.763Z","star_rating":null,"product_name":"Blink Mini - Compact indoor plug-in smart security camera, 1080p HD video, night vision, motion detection, two-way audio, easy set up, Works with Alexa – 1 camera (White)","review_count":null},{"brand":"Xiaokeis","price":15.18,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0C9QYTT3R","promo_flag":false,"scraped_at":"2026-05-18T17:40:57.530Z","star_rating":null,"product_name":"Xiaokeis Virtual Reality VR Headset 3D Glasses, VR Headset Support 4.7-7 Inch Version Virtual Reality Glasses Stereo Headphones 3D Glasses, VR Glasses for TV, Movies, Video Games(Black)","review_count":null},{"brand":"Saycker","price":15.95,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0DHRQWLSL","promo_flag":false,"scraped_at":"2026-05-20T14:00:31.076Z","star_rating":null,"product_name":"Virtual Reality Goggles, 3D VR Glasses Adjustable VR Virtual Reality Headset with Wide Angle Lens, Universal 3D VR Headset for Kids Adults, HD Goggles for Phone Movies Games","review_count":null},{"brand":"Apple","price":15.98,"in_stock":true,"retailer":"amazon","condition":"new","list_price":19,"product_id":"amazon:B0D7FVQ1ZB","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"Apple EarPods (Lightning Connector)","review_count":null},{"brand":"KTGEE","price":16.12,"in_stock":true,"retailer":"amazon","condition":"new","list_price":25.99,"product_id":"amazon:B0D5HG7TC3","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"KTGEE Wireless Earbuds Bluetooth 5.3 Headphones, 40Hrs Playback Stereo Ear Buds with LED Display Charging Case IPX7 Waterproof in-Ear Earphones with Mic for Phone Tablet Laptop Sports, White","review_count":null},{"brand":"TOZO","price":16.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0DD2W1L24","promo_flag":false,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"TOZO Upgraded E1 Wireless Earbuds Build in Mic Clear Calls Ergonomic Light-Weight Bluetooth 5.3 in Ear Headphones IPX6 Waterproof Premium Stereo Sound Headset 30H Playtime with 32 EQs via APP","review_count":null},{"brand":"jaddsa","price":16.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0H1VJF95G","promo_flag":false,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"jaddsa Wireless Earbuds, 2026 ENC Noise Cancelling Ear Buds with Smart Touchscreen, Bluetooth 5.4 Headphones, Bass Stereo Sound Over-Ear Earbuds, 5 EQ Modes for Sports/Travel/Gym- Rose Gold","review_count":null},{"brand":"EVAPLUS","price":17.99,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0G2BHGJBD","promo_flag":false,"scraped_at":"2026-05-20T13:48:57.461Z","star_rating":null,"product_name":"EVAPLUS 54.6V Smart Charger for 48V Lithium Batteries - UL Certified, Fast Charging with Multi-Safety Protection, Compatible with Electric Bikes/Scooters, DC 5.5 * 2.5/2.1mm Connector","review_count":null},{"brand":"ATHONGL","price":17.99,"in_stock":true,"retailer":"amazon","condition":"new","list_price":19.99,"product_id":"amazon:B0G8V96L1X","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"Wireless Earbuds, 100H Bluetooth 5.4 Headphones, ENC+ ANC Noise Cancelling Touch Control True Wireless Bluetooth Ear Buds,Stereo Deep Bass Bluetooth Headset for Sports/Workout/Gym(White)","review_count":null},{"brand":"Saycker","price":19.04,"in_stock":null,"retailer":"amazon","condition":"new","list_price":null,"product_id":"amazon:B0DHRPH3C5","promo_flag":false,"scraped_at":"2026-05-20T14:46:46.207Z","star_rating":null,"product_name":"Virtual Reality Goggles, 3D VR Glasses Adjustable VR Virtual Reality Headset with Wide Angle Lens, Universal 3D VR Headset HD Goggles for Phone Movies Games","review_count":null},{"brand":"JLab","price":19.87,"in_stock":true,"retailer":"amazon","condition":"new","list_price":29.88,"product_id":"amazon:B0CYNFWD2R","promo_flag":true,"scraped_at":"2026-06-14T06:05:50.532Z","star_rating":null,"product_name":"JLab Go Air Sport+ wireless earbuds with crisp C3 connections, safe sports design with ear hooks, 32 hours of Bluetooth playback and 3 EQ sound settings","review_count":null}],"country":"us","category":"electronics","currency":"USD","has_more":true,"resolved":{"alternates":[],"category_id":null,"match_source":"slug","category_path":"electronics","match_confidence":1},"next_cursor":20}},"exampleRequest":{"limit":20,"country":"us","sort_by":"price_asc","category":"electronics","retailer":"amazon"},"tags":["x402","shopping"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cTfnjyVAK3WFWEx4CmY75","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all products and their current prices across retailers within a category, sortable by price, rating, or review count for competitive benchmarking.","exampleAgentPrompt":"Pull the full competitive landscape for the beauty category in the US across all retailers, sorted by rating, and give me up to 50 products so I can benchmark how brands are positioning on price and reviews.","exampleUseCases":null,"resultDescription":"A paginated list of products within the specified category, each with current pricing, ratings, and review counts across the filtered or all retailers, sortable by price (ascending/descending), rating, or review count. Includes a cursor for fetching subsequent pages.","failureModes":["Invalid or unrecognized category string that cannot be resolved to a canonical category_id — returns an error or empty results","Unsupported retailer enum value — returns a validation error","Limit exceeds maximum of 50 — returns a validation error","Country not in supported enum (us, ca) — returns a validation error","No products found for the given category/retailer combination — returns empty result set","Expired or invalid pagination cursor — returns an error or resets pagination"],"whenToPreferThis":"Use this endpoint when you need a broad, multi-product view of an entire category across retailers for competitive benchmarking. Prefer this over Best Price (single product) or Deal Finder (promotions only) when your goal is a comprehensive snapshot of all products and prices in a category, sortable for ranking analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:06.382Z","isFirstParty":false}