Competitive intelligence API

A competitive intelligence API measures how you stack up against rivals on the digital shelf — competitor price tracking, share-of-shelf, and assortment-gap analysis. ShopAPIS powers it by parsing marketplace search and category pages into structured rows, returning each competing listing’s seller, brand, price, rating, review_count and rank across 70+ marketplaces in 30+ countries. You query a keyword or category; ShopAPIS returns the ranked competitive set.

Share-of-shelf is the percentage of a category’s top results that belong to your brand — and it is only measurable if you can read every competing listing on the page, not just your own. That requires search-result parsing, not single-product lookups.

What the API returns

• Search-result rows — for a keyword or category: each listing’s position, title, brand, seller, price, rating and review count.
• Share-of-shelf — your listings as a share of the top N organic + sponsored results.
• Assortment coverage — which competitor SKUs exist in a category that you do not sell.
• Competitor price tracking — the same price/was_price fields as the price monitoring API, aggregated across a competitor’s catalog.

All of it is built on the 40+ field object documented on the product data API pillar.

Why an API beats DIY

Competitive intelligence needs breadth, not depth — you must read hundreds of listings per category, per marketplace, per day. That is exactly the workload marketplaces throttle hardest: search pagination is rate-limited, results are personalized and geo-priced, and sponsored slots are injected dynamically. With bots accounting for about 51% of internet traffic in 2024 (Imperva 2025 Bad Bot Report) , marketplaces defend these surfaces hardest, so a DIY crawler at that scale faces high block rates and constant parser drift across sites. ShopAPIS normalizes search results from every marketplace into one schema with consistent ranking and sponsored flags, so your analysts compare brands — not reverse-engineer each site’s DOM. The anti-bot reality is detailed on the marketplace scraping API pillar.

Sample request and response

GET /v1/search?marketplace=mercadolibre&country=MX&q=cafetera&category=home
Authorization: Bearer YOUR_API_KEY

{
  "marketplace": "mercadolibre",
  "country": "MX",
  "query": "cafetera",
  "result_count": 48,
  "your_brand_share_of_shelf": 0.18,
  "results": [
    { "rank": 1, "brand": "Oster",     "seller": "Oster Oficial", "price": 1299.0, "currency": "MXN", "rating": 4.6, "review_count": 2104, "sponsored": true },
    { "rank": 2, "brand": "Hamilton",  "seller": "MarketPro",     "price": 989.0,  "currency": "MXN", "rating": 4.4, "review_count": 877,  "sponsored": false },
    { "rank": 3, "brand": "Taurus",    "seller": "HomeStore",     "price": 1450.0, "currency": "MXN", "rating": 4.7, "review_count": 1320, "sponsored": false }
  ],
  "fetched_at": "2026-06-05T08:30:00Z"
}

Use cases

• Share-of-shelf tracking — measure brand presence in priority categories week over week.
• Assortment analysis — find competitor SKUs and sizes missing from your range.
• Competitor price tracking — benchmark a rival’s full catalog, not one hero SKU.
• Sponsored monitoring — see who is buying the top slots in your categories.

Marketplaces commonly tracked

Related solutions