Pricing

from $1.60 / 1,000 matched pairs

Try for free

Go to Apify Store

Catalog Matcher: Competitor Product Matching & Price Gaps

Try for free

Match your product catalogue against competitors' by barcode (GTIN/UPC/EAN), MPN, SKU, model number or title, with match method and confidence per pair, price gap %, and the products only one side sells. Reads Shopify, any-store and Amazon datasets or your own rows.

Pricing

from $1.60 / 1,000 matched pairs

Rating

0.0

(0)

Developer

CleanPull

Actor stats

Bookmarked

Total users

Monthly active users

10 hours ago

Last modified

Categories

E-commerce

Automation

You can access the Catalog Matcher: Competitor Product Matching & Price Gaps programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "DiSzxO8n6JZF5xZhq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cleanpull~catalog-matcher/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cleanpull-catalog-matcher",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/cleanpull~catalog-matcher/runs": {
      "post": {
        "operationId": "runs-sync-cleanpull-catalog-matcher",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/cleanpull~catalog-matcher/run-sync": {
      "post": {
        "operationId": "run-sync-cleanpull-catalog-matcher",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "yourDatasetId": {
            "title": "Your products (dataset)",
            "type": "string",
            "description": "A dataset of your products: a run of Shopify Store Scraper, Any Store Product Monitor or Amazon Product Scraper, or any dataset with title, brand, price and (best) barcode, MPN or SKU fields. Pick it here so this actor is given read access to it; it never sees your other storages."
          },
          "yourItems": {
            "title": "Your products (rows)",
            "type": "array",
            "description": "Or give your products as rows: title, brand, price, currency, url, and where you have them gtin (UPC/EAN), mpn and sku. Used together with Your products (dataset) if both are given."
          },
          "yourStore": {
            "title": "Your store",
            "type": "string",
            "description": "Optional. Your store's domain, for example mystore.com. With Competitor stores and no other catalogue of yours, your store is read with Shopify Store Scraper in this run too. When your products are in a competitor dataset (one Shopify Store Scraper run over your store and theirs), it tells yours apart. Without any catalogue of yours, the first store in the first competitor dataset counts as yours."
          },
          "competitorStores": {
            "title": "Competitor stores (Shopify)",
            "maxItems": 10,
            "type": "array",
            "description": "Optional. Up to 10 Shopify stores by domain or URL, for example rival.com. Each is read in this run by Shopify Store Scraper, started in your account and billed at its own prices ($0.80 per 1,000 products on the Free tier), then compared with your catalogue. With a cost limit, each read gets its share of it. A store that cannot be read in full is reported and left out; the others still compare.",
            "items": {
              "type": "string"
            }
          },
          "competitorDatasetIds": {
            "title": "Competitor products (datasets)",
            "type": "array",
            "description": "One or more datasets of competitor products from the same actors. Each store in them is matched as its own catalogue (a dataset of three stores gives three comparisons)."
          },
          "competitorItems": {
            "title": "Competitor products (rows)",
            "type": "array",
            "description": "Or competitor products as rows, with the same fields plus store (rows of one store are one catalogue; without it, the URL's domain)."
          },
          "titleMatching": {
            "title": "Match by title",
            "type": "boolean",
            "description": "After barcode, part number, SKU and model number: match the remaining products by title within the same brand (token-set ratio). Off: only code matches.",
            "default": true
          },
          "minTitleScore": {
            "title": "Title score threshold",
            "minimum": 50,
            "maximum": 100,
            "type": "integer",
            "description": "Lowest token-set ratio (0–100) for a title match. 90 kept false matches at 2.7% of 146 hand-checked pairs, all below 0.85 confidence; lower finds more and risks more.",
            "default": 90
          },
          "titleWithoutBrand": {
            "title": "Title match without a brand",
            "type": "boolean",
            "description": "Also match by title when one side gives no brand (needs a score of 95 or more; confidence at most 0.75).",
            "default": false
          },
          "minConfidence": {
            "title": "Lowest confidence",
            "minimum": 0,
            "maximum": 1,
            "type": "number",
            "description": "Pairs below this confidence (0–1) are not matches. Barcodes are 1, part numbers 0.95, SKUs 0.9, model numbers 0.8–0.95, titles up to 0.9.",
            "default": 0.6
          },
          "gaps": {
            "title": "Gaps",
            "enum": [
              "both",
              "they-sell",
              "you-sell",
              "none"
            ],
            "type": "string",
            "description": "Which unmatched products to return as gap rows (each one billed).",
            "default": "both"
          },
          "gapsInYourBrandsOnly": {
            "title": "Gaps in your brands only",
            "type": "boolean",
            "description": "Only return products they sell and you don't from brands you already carry: the ranges you could add first, and far fewer rows than every product of a large store. Off: every product they sell that you don't.",
            "default": true
          },
          "monitorName": {
            "title": "Watchlist name",
            "type": "string",
            "description": "Optional. Runs with the same name compare with each other: each row says what changed since the last run (new match, price moves, new gap), and pairs or gaps gone for two runs in a row are reported once."
          },
          "changesOnly": {
            "title": "Changes only",
            "type": "boolean",
            "description": "With a watchlist name: return only rows that changed since the last run. Unchanged pairs and gaps are billed as the small checked event.",
            "default": false
          },
          "minPriceChangePercent": {
            "title": "Smallest price change (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Ignore price moves smaller than this percentage.",
            "default": 0
          },
          "alertUndercutPercent": {
            "title": "Undercut alert (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Optional. Mark pairs where the competitor is at least this much cheaper than you (0: any amount) with undercut: true. With a watchlist name, a pair that newly crosses it gets an undercut change (also with Changes only), and each summary counts undercuts and new undercuts. Off by default."
          },
          "maxItemsPerCatalogue": {
            "title": "Max products per catalogue",
            "minimum": 1,
            "maximum": 200000,
            "type": "integer",
            "description": "At most this many products read from your catalogue and from each competitor's (default 50,000, which runs in the default 256 MB). For up to 200,000 a side, give 1 GB. A catalogue cut short gives no gap rows, since products not read would show as gaps.",
            "default": 50000
          },
          "maxRunCostUsd": {
            "title": "Max cost per run (USD)",
            "minimum": 0.01,
            "maximum": 1000,
            "type": "number",
            "description": "Optional. The most one run may charge in all. Use it for scheduled runs, which may have no spending limit of their own. With a run spending limit too, the lower one applies. With Competitor stores it covers their Shopify Store Scraper runs too. Your store is read first, with all but this actor's reserve; the rivals then share the rest equally. For 250-product stores, about $2 for one rival, $3 for two and $4 for three covers the first (dearest) run."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Catalog Matcher: Product Matching & Price Gaps OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Catalog Matcher: Competitor Product Matching & Price Gaps from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Catalog Matcher: Competitor Product Matching & Price Gaps API in Python

Catalog Matcher: Competitor Product Matching & Price Gaps API in JavaScript

Catalog Matcher: Competitor Product Matching & Price Gaps API through CLI

Catalog Matcher: Competitor Product Matching & Price Gaps API

📦 Amazon Movers & Shakers Sales Rank Gainers Radar

unrivaled_fortress/amazon-movers-and-shakers-sales-rank-radar

Track Amazon biggest sales rank gainers (% gainers past 24h) across categories, price drops, BSR rank shifts, and seller arbitrage signals.

David A

eBay Market Analyser: Prices, Competition & Profit

best_actors/ebay-market-analyser

Keywords in, the live eBay market out: price range with postage, seller concentration, China competition, optional real sold data and your profit per sale. 8 eBay sites. Pay only for keywords with real data.

Lewis O'Rorke

Shopify Products Scraper - Prices, Variants, Stock & Changes

alex9080/shopify-products-scraper

Scrape all products of any Shopify store: title, vendor, type, tags, price range, compare-at price and discount, every variant with SKU, options and availability, images and description, plus store info. Whole store or a collection. Track price and stock changes between runs.

Alex

Amazon Best Sellers & Price Drop Monitor

litezero/amazon-bestsellers-monitor

Extract Amazon Best Sellers and Movers & Shakers rankings with historical price drop tracking, ratings, and stock status across top retail categories.

LiteZero

Shopify Store Products & Price Monitor: Prices, Stock, Variants

charlesmarkette/shopify-store-products-price-monitor

Get every product, price, variant and stock flag from any Shopify store's public catalog, or run it on a schedule to see only what changed: new products, price drops, price rises, out of stock, back in stock and removed items. No login, no browser.

Charles Markette

Amazon Search Scraper

solarg/amazon-search-scraper

Scrape Amazon search results by keyword: title, ASIN, price, list price, unit price, currency, rating, review count, 'bought in past month', badges and images. US, Canada, Mexico and Brazil.

Solar G

Marketplace Trending Radar

apt_marble/marketplace-trending-radar

Track what is rising for any product search term across Amazon, eBay, Walmart, AliExpress, Alibaba and Taobao: rerun the same terms over time and get every product marked new, rising, falling or steady, with a 0-100 trend score, rank changes and a cross-marketplace breakout flag.

Hamza

Amazon Real Deal Finder: Today's Price vs Its Price History

wellbuilt_zythem/amazon-real-deals

Amazon.com products by search or ASIN with today's price, the discount Amazon claims, and the real price history from the Internet Archive: lowest, highest and average over the years. A verdict per product: real deal, good price, usual price or above usual. Schedule it to catch drops.

Carlos Escanez

Stadium Goods Product Scraper & Sneaker Price Tracker

superslowsloth/stadiumgoods-products

Stadium Goods scraper: sneakers, streetwear and accessories newest first, filtered by brand (NIKE, JORDAN, NEW BALANCE...) and publish time. One row per product with USD price range, per-size stock and SKU, type, tags, photo and timestamps. For sneaker resale price and new-drop watch.

Superslow Sloth

CTM South Africa Tiles & Sanitaryware Scraper

lonwabo/ctm-scraper

Fast scraper for CTM South Africa (ctm.co.za). Extract live porcelain tiles, ceramic tiles, bathroom vanities, taps, toilets, mosaics, adhesives, and grout with VAT breakdown.