> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopsniffer.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Store directory API

Browse the public directory of analyzed Shopify stores. No authentication required.

## Overview

Every completed job for a public Shopify store is listed in the public store directory. Use these endpoints to browse analyzed stores, search by domain, and fetch rich per-store page data (SEO content, featured products, related stores). Useful for building "Shopify competitive intelligence" or "stores-in-a-niche" features.

Base URL: `https://shopsniffer.com/api`

**Auth:** None.

## `GET /stores` Stable

Paginated directory of public stores.

Page number.
Results per page (max 100).
Filter stores by domain substring.

**Search for sustainable stores**

```bash
curl "https://shopsniffer.com/api/stores?page=1&limit=24&search=sustainable"
```

**Store list**

```json
{
  "stores": [
    {
      "slug": "allbirds-com",
      "domain": "allbirds.com",
      "shop_name": "Allbirds",
      "product_count": 156,
      "theme_name": "Custom Theme",
      "last_analyzed": "2026-04-12T10:33:42Z"
    },
    {
      "slug": "gymshark-com",
      "domain": "gymshark.com",
      "shop_name": "Gymshark",
      "product_count": 892,
      "theme_name": "Prestige",
      "last_analyzed": "2026-04-12T08:12:30Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 24,
    "total": 1847
  }
}
```

---

## `GET /stores/:slug` Stable

Full public store page data: SEO content, counts, featured products, collections, and related stores. Backs the `https://shopsniffer.com/stores/:slug` public pages.

Store slug (e.g. `allbirds-com`).

**Store page data**

```json
{
  "store": {
    "slug": "allbirds-com",
    "domain": "allbirds.com",
    "shop_name": "Allbirds",
    "product_count": 156,
    "collection_count": 24,
    "page_count": 18,
    "theme_name": "Custom Theme",
    "detected_apps": ["Klaviyo", "Judge.me"]
  },
  "seoContent": {
    "meta_title": "Allbirds Shopify Store Analysis",
    "meta_description": "Full analysis of allbirds.com…",
    "content_html": "<p>Allbirds is a sustainable footwear brand…</p>"
  },
  "counts": { "products": 156, "collections": 24, "pages": 18 },
  "products": [],
  "collections": [],
  "relatedStores": [
    { "slug": "bombas-com", "domain": "bombas.com", "product_count": 245 }
  ]
}
```

```json title="404 Not Found"
{ "error": "Store not found" }
```

## Next steps

**[Reports API](/api/reports)**

Fetch the underlying report for any listed store.
  **[Monitoring API](/api/monitoring)**

Track stores from the directory for daily change detection.