{"uid":"cap_pj00uLG12oSGJTBRxrcU-","slug":"price-positioning-7f461c41","name":"Price Positioning","description":"Compare a brand's average price to the category average/median and classify positioning as premium, mid-range, or value.","url":"https://api.syntalic.com/v1/marketing/price-positioning","method":"GET","headers":{},"bodySchema":{"type":"object","required":["brand"],"properties":{"brand":{"type":"string","example":"Apple","minLength":1,"description":"Brand name (e.g., Sony, Samsung, Nike)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"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."}},"additionalProperties":false},"responseSchema":{"type":"object"},"example":{"request":{"brand":"Nike","country":"us","category":"footwear"},"response":{"meta":{"computed_at":"2026-06-18T05:48:37.678Z","served_from":"live","schema_version":"v3","freshness_seconds":81862},"brand":"Nike","country":"us","category":"footwear","currency":"USD","resolved":{"alternates":[],"category_id":null,"match_source":"slug","category_path":"footwear","match_confidence":1},"positioning":"unknown","price_index":null,"product_count":0,"brand_avg_price":null,"category_avg_price":null,"category_median_price":null}},"exampleRequest":{"brand":"Nike","country":"us","category":"footwear"},"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_L9_UYthx17b__vcvfNBNV","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":"Compares a brand's average price to its category average/median and classifies the brand as premium, mid-range, or value positioned.","exampleAgentPrompt":"Is Apple positioned as a premium, mid-range, or value brand in the US electronics category compared to the category average price?","exampleUseCases":null,"resultDescription":"Returns a pricing classification (premium, mid-range, or value) for the specified brand, along with the brand's average price versus the category average and median price, enabling quick benchmarking of a brand's price tier within its market.","failureModes":["Brand not found in the dataset — returns empty or null result","Category string cannot be resolved to a canonical category_id — fuzzy matching may fail for very niche or misspelled inputs","Country not supported (only 'us' and 'ca' are valid) — invalid country returns validation error","Insufficient pricing data for the brand/category combination — result may be unreliable or absent","Missing required 'brand' parameter — returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need to understand how a specific brand's pricing compares to its category peers and want a clear premium/mid-range/value classification. Prefer this over Brand Tracker (which tracks a single brand's price over time) or Competitive Landscape (which returns all products in a category) when the goal is a single, fast classification of brand positioning rather than trend data or full competitive product lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:45:16.226Z","isFirstParty":false}