signals

Check which competitive signals RivalSweeper has for an eCommerce domain, with per-signal freshness. Free and non-billable - call this before any billable tool so you never pay for a domain we do not cover.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain, e.g. gymshark.com"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Active promotions/discount codes for a brand: code, discount type/value, min order, validity window. Freshness-stamped. 1 credit; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Price statistics (min/max/avg/median) plus recent product samples for a brand, optionally filtered by product-name query. Freshness-stamped. 1 credit; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain"
    },
    "query": {
      "type": "string",
      "description": "Optional product-name filter, e.g. \"leggings\""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Sample size, default 10"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The brand's last-known DNA competitor set: the closest competing brands RivalSweeper identified for a domain, each with name, website, country, home-market flag and match tier, plus the brand's own DNA profile. Freshness-stamped. 2 credits; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain, e.g. gymshark.com"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A brand's current homepage top links (up to 10) enriched from its catalog and grouped into Products, Categories and Content, in that order. Per link: title, vendor, price + compare-at/on-sale, currency, stock status, URL status (active/inactive), review rating, homepage position, anchor text and last update. A top-level 'comment' flags when pricing and/or stock status are not captured for the domain. 2 credits; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain, e.g. connox.com"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

RivalSweeper 6-pillar AI/agent-readiness score for a domain (schema.org, technical access, content quality, trust, AI-specific, entity recognition) with tier and highlights. Uniquely RivalSweeper data. 1 credit; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to score"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Bundle: all current signals for one brand-day - promotions, price stats + samples, AI-readiness - in one call. 15 credits; no data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Monthly time-series of price changes (drops/rises/avg delta) or stock-status flips for a brand. Depth-tiered: up to 3 months = 5 credits, 4-12 months = 8, 13-24 months = 13. No data = no charge.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "eCommerce domain"
    },
    "signal": {
      "type": "string",
      "enum": [
        "price",
        "stock_status"
      ],
      "description": "Which signal history, default price"
    },
    "months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "description": "Window in months, default 3"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Your own account status: current prepaid credit balance, plus call count and credits consumed - overall and per tool - over a look-back window (default 30 days), plus lifetime credits spent. Free and non-billable. Requires your API key; only ever returns your own usage.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Look-back window in days, default 30"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ask RivalSweeper to add a domain to monitoring. Free, but requires an account with a positive prepaid balance. First data typically lands within 24-72h.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to start monitoring"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}