# ShopSniffer — Complete Documentation

> Analyze, export, and monitor any Shopify store.

ShopSniffer lets you enter any Shopify store URL and get a full analysis: products, collections, pages, installed apps, theme info, and PageSpeed scores. Export data as CSV (compatible with Shopify's bulk import) or JSON. Monitor stores daily for changes.

Website: https://shopsniffer.com
API Base URL: https://shopsniffer.com/api
OpenAPI Spec: https://shopsniffer.com/api/openapi.json

---

Source: https://shopsniffer.com/docs/how-it-works

## How It Works

ShopSniffer uses a multi-step analysis pipeline:

1. **Domain Validation** — Verifies the URL is a valid, reachable Shopify store.
2. **Sitemap Extraction** — Fetches the store's sitemap to discover all products, collections, and pages.
3. **Product Scraping** — Downloads full product data including variants, images, prices, and SEO metadata via Shopify's public JSON endpoints.
4. **Browser Analysis** — Renders the store in a headless browser to detect installed apps and identify the active theme.
5. **PageSpeed Audit** — Runs a Google Lighthouse audit for performance, accessibility, best practices, and SEO scores.
6. **Export Compilation** — Packages all data into downloadable CSV and JSON files.

The entire process takes 30-90 seconds for most stores. Large stores with 10,000+ products may take a few minutes.

---

Source: https://shopsniffer.com/docs/product-export

## Product Export

Export any Shopify store's product catalog as CSV or JSON.

**CSV Export:**
- 100% compatible with Shopify's bulk import tool
- Upload directly via Shopify Admin > Products > Import
- Includes all variants, images, prices, inventory, SEO fields
- One row per variant (Shopify standard format)

**JSON Export:**
- Raw product data with full variant and image arrays
- Includes metafields, tags, and collection assignments
- Suitable for custom integrations and data analysis

**Data Included:**
- Product title, description (HTML), vendor, product type
- Variant: SKU, price, compare-at price, weight, inventory quantity, barcode
- Images: all image URLs with alt text
- SEO: page title, meta description, URL handle
- Tags, status, published date

---

Source: https://shopsniffer.com/docs/apps-themes

## App & Theme Detection

ShopSniffer detects installed Shopify apps and the active theme by rendering the store in a real browser.

**App Detection:**
- Renders the storefront in a headless Chromium browser
- Matches loaded scripts, stylesheets, and DOM elements against 200+ known app signatures
- Returns app name, category, and Theme Store/App Store link when available

**Theme Detection:**
- Identifies the active Shopify theme name and version
- Detects whether it's a free or premium theme
- Provides a direct link to the Shopify Theme Store listing

---

Source: https://shopsniffer.com/docs/pagespeed

## PageSpeed Audit

Runs a Google PageSpeed Insights / Lighthouse audit on the store.

**Scores Returned:**
- Performance (0-100)
- Accessibility (0-100)
- Best Practices (0-100)
- SEO (0-100)

**Core Web Vitals:**
- First Contentful Paint (FCP)
- Largest Contentful Paint (LCP)
- Total Blocking Time (TBT)
- Cumulative Layout Shift (CLS)
- Speed Index

---

Source: https://shopsniffer.com/docs/monitoring

## Store Monitoring

Track any Shopify store daily and get notified of changes.

**What's Tracked:**
- New products added
- Products removed
- Price changes (increases and decreases)
- Title and description changes
- Inventory changes
- New collections

**How It Works:**
- ShopSniffer takes a daily snapshot of the store's catalog
- Compares each snapshot against the previous one
- Generates a changelog of all detected changes
- Available via the dashboard and API

---

Source: https://shopsniffer.com/docs/store-reports

## Store Reports

A ShopSniffer report includes:

- **Products** — Full catalog with all variants, images, and pricing
- **Collections** — All collections with product assignments
- **Pages** — Static pages (About, Contact, etc.)
- **Apps** — Detected Shopify apps with categories
- **Theme** — Active theme name, version, and type
- **PageSpeed** — Lighthouse performance audit
- **Downloads** — CSV and JSON export files
- **Insights** — Average price, price range, product count by type

---

Source: https://shopsniffer.com/docs/authentication

## Authentication

ShopSniffer supports three authentication methods:

**1. API Key (recommended for server-to-server)**
- Create keys in Dashboard > Settings > API Keys
- Pass via `X-API-Key` header
- Each key can be named and revoked independently

**2. Clerk JWT (for browser-based apps)**
- Used by the ShopSniffer dashboard
- Pass via `Authorization: Bearer <token>` header
- Tokens are short-lived and auto-refreshed

**3. x402 Payment (for AI agents / no account)**
- Send a POST request, receive 402 with payment details
- Pay with USDC on Base chain
- Include payment receipt in retry request
- No account or API key needed

---

Source: https://shopsniffer.com/docs/api-reference

## API Reference

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

### Create Analysis Job
`POST /api/jobs`
Body: `{ "domain": "example.myshopify.com" }`
Returns: `{ "id": "job-id", "status": "pending" }`

### Get Job Status
`GET /api/jobs/{id}/status`
Returns: `{ "status": "completed", "progress": 100 }`

### Get Full Report
`GET /api/reports/{id}`
Returns: Full report data with products, apps, theme, PageSpeed.

### Free Export (no auth required)
`GET /api/free-export?domain=example.com`
Returns: First 100 products as JSON.

### Download Files
`GET /api/downloads?key=exports/{id}/products.csv&jobId={id}`
Returns: CSV or JSON file download.

### Store Directory
`GET /api/stores?page=1&limit=20&search=keyword`
Returns: Paginated list of public store analyses.

### Store Detail
`GET /api/stores/{slug}`
Returns: Full public store page data with SEO content.

### PageSpeed Audit
`GET /api/pagespeed/{jobId}`
Returns: Lighthouse scores and Core Web Vitals.

See the full OpenAPI spec at: https://shopsniffer.com/api/openapi.json

---

Source: https://shopsniffer.com/docs/x402-payment

## x402 Payment Protocol

ShopSniffer supports the x402 payment protocol for pay-per-request API access.

**How It Works:**
1. POST to `/api/jobs` without auth headers
2. Receive HTTP 402 with payment details (amount, token, chain, recipient)
3. Pay the specified amount (USDC on Base chain)
4. Retry the request with payment receipt headers
5. Job is created — no account needed

**Price:** $9.99 per full store analysis

---

Source: https://shopsniffer.com/docs/webhooks

## Webhooks

Pass a `webhook_url` when creating a job to receive a POST callback when the report is ready.

**Request:**
`POST /api/jobs`
`{ "domain": "store.com", "webhook_url": "https://your-server.com/callback" }`

**Callback Payload:**
```json
{
  "event": "job.completed",
  "job_id": "abc123",
  "domain": "store.com",
  "status": "completed",
  "report_url": "https://shopsniffer.com/report/abc123"
}
```

---

Source: https://shopsniffer.com/docs/agent-integration

## AI Agent Integration

ShopSniffer is designed for AI agent consumption.

**Discovery Files:**
- `/.well-known/ai-plugin.json` — OpenAI plugin manifest
- `/.well-known/agents.json` — Agent capabilities and pricing
- `/api/openapi.json` — Full OpenAPI 3.1.0 spec

**Recommended Workflow for AI Agents:**
1. Read `/api/openapi.json` to discover available endpoints
2. Use x402 payment protocol (no account setup needed)
3. POST to `/api/jobs` with the store domain
4. Poll `/api/jobs/{id}/status` until complete
5. GET `/api/reports/{id}` for full results

---

Source: https://shopsniffer.com/docs/free-export

## Free Export

Export the first 100 products from any Shopify store for free.

- No account or sign-up required
- Returns product title, price, images, variants, and SEO data
- Available via the web UI at shopsniffer.com/free-export or the API

**API:**
`GET /api/free-export?domain=example.myshopify.com`

---

Source: https://shopsniffer.com/docs/buying-a-report

## Buying a Report

A full ShopSniffer report costs $9.99 and includes:
- Complete product catalog (unlimited products)
- App and theme detection
- PageSpeed audit
- CSV and JSON downloads
- 30 days of monitoring

**Payment Methods:**
- Credit card (Visa, Mastercard) via Stripe
- Any cryptocurrency via x402 protocol (USDC on Base, ETH, BTC, etc.)

---

Source: https://shopsniffer.com/docs/downloads

## Downloads

After a report is complete, download exported files:

- **products.csv** — Shopify bulk import compatible CSV
- **products.json** — Raw JSON with full product data
- **collections.json** — All collections with handles
- **pages.json** — Static pages content

Files are stored for 30 days after report completion.

---

Source: https://shopsniffer.com/docs/faq

## FAQ

**What is ShopSniffer?**
ShopSniffer lets you download any Shopify store's products, collections, and pages. Export them as CSV files compatible with Shopify's bulk import tool, or as JSON for custom integrations.

**Is this legal?**
Yes. ShopSniffer only accesses publicly available data through Shopify's standard product endpoints. No passwords or private data are accessed.

**How fast is the export?**
Most stores complete in under 60 seconds. Large stores with 10,000+ products may take a few minutes.

**Do I need a Shopify account?**
No. ShopSniffer works with any public Shopify store. You don't need access to the store's admin.

**What export formats are available?**
CSV (100% compatible with Shopify's bulk import tool) and JSON. Both include all product data, variants, images, SEO metadata, and collection assignments.

**Can I import the CSV into my own Shopify store?**
Yes. The CSV export follows Shopify's official bulk import format. You can upload it directly through Shopify Admin > Products > Import.

**Is there an API?**
Yes. We offer a full REST API with API key authentication, webhook callbacks, and x402 crypto payments (USDC on Base).

**How much does it cost?**
The free tier exports the first 100 products. A full report is $9.99 and includes unlimited products, app/theme detection, PageSpeed audit, and 30 days of monitoring.