Cart API

Search and filter across millions of e-commerce stores.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "domain": "pawsome-pets.com",
      "name": "Pawsome Pets",
      "platform": "shopify",
      "language": "en",
      "currency": "USD",
      "biz_model": "dropshipping",
      "monthly_traffic": 45200,
      "product_count": 312,
      "has_ads": true,
      "status": "active",
      "created_at": "2024-03-15T00:00:00Z"
    }
  ],
  "meta": {
    "request_id": "req_s1a2b3",
    "page": 1,
    "per_page": 20,
    "total": 1483
  }
}

Retrieve full details for a single store by its domain.

Path Parameters

Example Response

JSONCopy
{
  "data": {
    "domain": "pawsome-pets.com",
    "name": "Pawsome Pets",
    "description": "Premium pet supplies and accessories",
    "platform": "shopify",
    "language": "en",
    "currency": "USD",
    "biz_model": "dropshipping",
    "monthly_traffic": 45200,
    "product_count": 312,
    "avg_price": 29.95,
    "has_ads": true,
    "status": "active",
    "social": {
      "facebook": "https://facebook.com/pawsomepets",
      "instagram": "https://instagram.com/pawsomepets"
    },
    "created_at": "2024-03-15T00:00:00Z",
    "last_checked": "2025-01-20T12:00:00Z"
  }
}

List all products from a specific store.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "id": "prod_8f3k2j",
      "title": "Organic Dog Treats - Chicken",
      "price": 14.99,
      "currency": "USD",
      "image_url": "https://cdn.pawsome-pets.com/treats.jpg",
      "url": "https://pawsome-pets.com/products/organic-dog-treats"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 312 }
}

Retrieve estimated traffic data and visitor sources for a store.

Example Response

JSONCopy
{
  "data": {
    "domain": "pawsome-pets.com",
    "monthly_visitors": 45200,
    "trend": "growing",
    "growth_pct": 12.5,
    "sources": {
      "organic": 0.45,
      "paid": 0.25,
      "social": 0.18,
      "direct": 0.08,
      "referral": 0.04
    },
    "top_countries": [
      { "code": "US", "share": 0.62 },
      { "code": "CA", "share": 0.15 },
      { "code": "GB", "share": 0.09 }
    ]
  }
}

Identify the technologies, apps, and integrations used by a store.

Example Response

JSONCopy
{
  "data": {
    "domain": "pawsome-pets.com",
    "platform": "shopify",
    "theme": "Dawn 12.0",
    "technologies": [
      { "name": "Klaviyo", "category": "email_marketing" },
      { "name": "Loox", "category": "reviews" },
      { "name": "Google Analytics", "category": "analytics" },
      { "name": "Meta Pixel", "category": "advertising" }
    ],
    "payment_processors": ["shopify_payments", "paypal"]
  }
}

Retrieve all tracked advertisements for a specific store.

Example Response

JSONCopy
{
  "data": [
    {
      "id": "ad_9x8k2m",
      "platform": "facebook",
      "type": "image",
      "headline": "Your Dog Deserves the Best",
      "cta": "Shop Now",
      "landing_url": "https://pawsome-pets.com/collections/premium",
      "first_seen": "2025-01-10T00:00:00Z",
      "last_seen": "2025-01-20T00:00:00Z",
      "days_running": 10
    }
  ]
}

Compare key metrics side-by-side for 2–10 stores.

Query Parameters

Example Request

Bash
curl "https://api.usecart.com/v1/stores/compare?domains=pawsome-pets.com,petco.com" \
  -H "Authorization: Bearer cart_sk_..."

Example Response

JSONCopy
{
  "data": [
    {
      "domain": "pawsome-pets.com",
      "monthly_traffic": 45200,
      "product_count": 312,
      "avg_price": 29.95,
      "platform": "shopify"
    },
    {
      "domain": "petco.com",
      "monthly_traffic": 8200000,
      "product_count": 14520,
      "avg_price": 22.50,
      "platform": "custom"
    }
  ]
}

Search across millions of products from tracked stores.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "id": "prod_8f3k2j",
      "title": "Organic Dog Treats - Chicken",
      "price": 14.99,
      "currency": "USD",
      "store_domain": "pawsome-pets.com",
      "image_url": "https://cdn.pawsome-pets.com/treats.jpg",
      "url": "https://pawsome-pets.com/products/organic-dog-treats"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 892 }
}

Retrieve full details for a single product.

Path Parameters

Example Response

JSONCopy
{
  "data": {
    "id": "prod_8f3k2j",
    "title": "Organic Dog Treats - Chicken",
    "description": "All-natural chicken treats for dogs of all sizes.",
    "price": 14.99,
    "compare_at_price": 19.99,
    "currency": "USD",
    "store_domain": "pawsome-pets.com",
    "images": [
      "https://cdn.pawsome-pets.com/treats-1.jpg",
      "https://cdn.pawsome-pets.com/treats-2.jpg"
    ],
    "variants": [
      { "title": "Small Bag", "price": 14.99 },
      { "title": "Large Bag", "price": 24.99 }
    ],
    "created_at": "2024-06-10T00:00:00Z"
  }
}

Discover products gaining momentum across tracked stores.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "id": "prod_t7m3x1",
      "title": "LED Pet Collar",
      "price": 12.99,
      "store_count": 48,
      "growth_pct": 340,
      "timeframe": "week"
    }
  ]
}

Search across tracked advertisements from e-commerce stores.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "id": "ad_9x8k2m",
      "store_domain": "pawsome-pets.com",
      "platform": "facebook",
      "type": "video",
      "headline": "Your Dog Deserves the Best",
      "body": "Premium organic treats, delivered to your door.",
      "cta": "Shop Now",
      "days_running": 10,
      "first_seen": "2025-01-10T00:00:00Z"
    }
  ]
}

Retrieve full details for a single advertisement.

Path Parameters

Example Response

JSONCopy
{
  "data": {
    "id": "ad_9x8k2m",
    "store_domain": "pawsome-pets.com",
    "platform": "facebook",
    "type": "video",
    "headline": "Your Dog Deserves the Best",
    "body": "Premium organic treats, delivered to your door.",
    "cta": "Shop Now",
    "landing_url": "https://pawsome-pets.com/collections/premium",
    "media_url": "https://cdn.usecart.com/ads/ad_9x8k2m.mp4",
    "first_seen": "2025-01-10T00:00:00Z",
    "last_seen": "2025-01-20T00:00:00Z",
    "days_running": 10,
    "is_active": true
  }
}

Search for product suppliers and manufacturers.

Query Parameters

Example Response

JSONCopy
{
  "data": [
    {
      "id": "sup_4f2a1x",
      "name": "PetGoods Direct",
      "product_count": 1240,
      "store_count": 89,
      "avg_price": 8.50,
      "categories": ["pet_supplies", "pet_food"]
    }
  ]
}

Get a comprehensive overview of a niche including competition, market size, and trends.

Path Parameters

Example Response

JSONCopy
{
  "data": {
    "keyword": "pet supplies",
    "store_count": 3420,
    "avg_monthly_traffic": 28500,
    "avg_product_count": 185,
    "avg_price": 24.99,
    "competition": "high",
    "trend": "growing",
    "top_platforms": [
      { "name": "shopify", "share": 0.68 },
      { "name": "woocommerce", "share": 0.22 }
    ],
    "top_biz_models": [
      { "name": "dropshipping", "share": 0.45 },
      { "name": "private_label", "share": 0.35 }
    ]
  }
}

Get a snapshot of what is trending globally across e-commerce—products, niches, and stores gaining momentum.

Example Response

JSONCopy
{
  "data": {
    "trending_products": [
      { "title": "LED Pet Collar", "growth_pct": 340 }
    ],
    "trending_niches": [
      { "keyword": "sustainable fashion", "growth_pct": 120 }
    ],
    "trending_stores": [
      { "domain": "eco-threads.com", "growth_pct": 85 }
    ]
  }
}

Retrieve your account details, current plan, and usage statistics.

Example Response

JSONCopy
{
  "data": {
    "email": "[email protected]",
    "plan": "pro",
    "requests_today": 42,
    "daily_limit": 10000,
    "key_prefix": "cart_sk_a1b2...",
    "created_at": "2024-11-01T00:00:00Z"
  }
}