{"uid":"cap_2n01VSyG_Nb8G0X5TvDiT","slug":"syntalic-category-concentration-analysis-13561989","name":"Syntalic Category Concentration Analysis","description":"Analyst/market-level query - $0.02 per request","url":"https://api.syntalic.com/v1/analyst/category-concentration?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["category"],"properties":{"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 in the Shopify product taxonomy. Accepts a display path (e.g. 'Electronics > Computers > Laptops'), its slug form (e.g. 'electronics/computers/laptops'), a single path segment (e.g. 'laptops', 'headphones'), or an everyday shelf name (e.g. 'apparel', 'beauty', 'grocery'); matched against the catalog's category tree (exact node, subtree, or whole path segment). Also accepts a GS1 GPC code (exactly 8 digits, e.g. '10001159') to filter by PRODUCT TYPE instead of by shelf placement — the same product type is shelved under different categories by different retailers, so a category filter answers from a fraction of the data while a GPC code spans them. Coarser codes (class/family/segment) match every brick beneath them. Resolve a phrase to a code with /v1/reference/classify?q=... ; when a code is used, resolved.match_source is 'gpc'."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v1NemYu4wrPbibDjy177S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns market concentration metrics for a product category, showing how sales or shelf presence is distributed across brands and retailers","exampleAgentPrompt":"How concentrated is the electronics category in the US right now — are a few brands dominating most of the shelf, or is it fragmented across many players?","exampleUseCases":[{"title":"CPG brand competitive landscape audit","prompt":"How concentrated is the beauty category in the US? I want to know if a handful of brands control most of the shelf space or if it's spread across many players."},{"title":"Canadian grocery market structure check","prompt":"Can you analyze the concentration of the grocery category in Canada — are there dominant brands hoarding shelf presence or is it fairly distributed?"},{"title":"GPC-based product type concentration lookup","prompt":"Use GPC code 10001159 to analyze category concentration for that product type in the US — I need to see how fragmented or monopolized that segment is across retailers."}],"resultDescription":"Returns concentration metrics for the specified product category or GPC product type, including how brand and retailer presence is distributed — enabling analysis of market dominance, fragmentation, or competitive balance within a category.","failureModes":["Missing or invalid category parameter returns a 400 error","Unrecognized category string that cannot be matched to the taxonomy returns empty or error","Invalid GPC code format (not exactly 8 digits) may fail to match","Unsupported country code outside 'us' or 'ca' returns validation error","Payment failure or missing x402 payment header results in 402 response"],"whenToPreferThis":"Use this endpoint when you need to understand the competitive structure of a product category — specifically how concentrated or fragmented brand and retailer presence is. Prefer this over Category Summary when your goal is market power analysis rather than simple counts or pricing statistics. Use GPC code input when a product type spans multiple shelf categories across retailers for broader coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:18:51.147Z","isFirstParty":false,"canonicalSlug":"syntalic-category-concentration-analysis-13561989"}