---
title: "Search stores"
method: POST
path: "/stores/search"
tags: ["stores"]
---

# Search stores

`POST /stores/search`

## Request

- Base URL: `https://storeinspect.com/api/v1`
- URL: `https://storeinspect.com/api/v1/stores/search`
- Auth: HTTP bearer

Searches Shopify stores by focused ICP filters with stable sorting, cursor pagination, broad-search guardrails, monthly search-row quotas, and a unique-store export allowance for returned stores.

## Request body

- StoreSearchRequest
  - `filters` StoreSearchFilters, required
    - `categories` string[]
    - `countries` string[]
    - `traffic_tiers` string[]
    - `revenue_tiers` string[]
    - `shopify_plus` boolean
    - `apps` StoreTechnologyFilter
      - `any` string[]
      - `all` string[]
      - `none` string[]
    - `pixels` StoreTechnologyFilter
      - `any` string[]
      - `all` string[]
      - `none` string[]
    - `themes` object
      - `types` string[]
      - `outdated` true: Only stores on a vintage Shopify theme, or a Dawn-family theme two or more major versions behind the latest.
    - `has_ios_app` true: Only stores whose homepage shows their own iOS app.
    - `checkout` object
      - `offers_shop_pay_installments` true: Only stores whose /meta.json offers Shop Pay Installments.
      - `ships_to_any` string[]: ISO 3166-1 alpha-2 codes. Matches listed countries and stores with Shopify's rest-of-world shipping zone.
    - `meta_ads` object
      - `active_ads_min` integer
    - `store_created_at` DateRangeFilter
      - `from` string, date-time
      - `to` string, date-time
    - `first_discovered_at` DateRangeFilter
      - `from` string, date-time
      - `to` string, date-time
    - `contacts` object
      - `has_revealable_contacts` boolean
      - `roles_any` string[]
  - `limit` integer
  - `cursor` string, nullable

## Response `200`

A cursor-paginated list of stores matching the supplied filters.

- StoreListResponse
  - `object` 'list', required
  - `data` Store[], required
    - `id` string
    - `object` 'store'
    - `domain` string
    - `name` string
    - `category` string, nullable
    - `country` string, nullable
    - `traffic_tier` string, nullable
    - `revenue_tier` string, nullable
    - `shopify_plus` boolean
    - `lead_fit_score` number, nullable
    - `store_created_at` object, nullable
      - `estimate` string, date-time, nullable
      - `resolution` 'exact' | 'month' | 'year' | 'null', nullable
      - `source` string, nullable
      - `confidence` 'high' | 'medium' | 'low' | 'null', nullable
    - `first_discovered_at` string, date-time, nullable
    - `technologies` object
      - `apps` string[]
      - `pixels` string[]
      - `theme` object
        - `name` string, nullable
        - `type` string, nullable
        - `version` string, nullable: Shopify.theme schema_version, as published by the theme.
        - `theme_store_id` integer, nullable: Shopify Theme Store id; null for custom themes.
        - `outdated` boolean, nullable: true for vintage Shopify themes or Dawn-family themes two or more major versions behind; false for current Dawn-family themes; null when no rule applies.
    - `ios_app` object, nullable: The store's own iOS app, from its Smart App Banner or a single App Store link on the homepage.
      - `app_id` string
      - `url` string, uri
    - `checkout` object: From the store's public /meta.json. null means not checked yet.
      - `ships_to_countries` string[], nullable: ISO 3166-1 alpha-2 codes; "*" is Shopify's rest-of-world shipping zone.
      - `offers_shop_pay_installments` boolean, nullable
      - `shopify_pay_enabled_card_brands` string[], nullable
    - `contacts_summary` object
      - `total` integer
      - `has_revealable_contacts` boolean
      - `verified_email_count` integer
      - `roles` string[]
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `request_id` string, required

## Other responses

- `400`: Invalid filters, limit, or cursor.
- `401`: Missing or invalid API key.
- `403`: The account does not have API access.

---

[API](https://skmtc.dev/storeinspect/apis/storeinspect-api.md) · [All operations](https://skmtc.dev/storeinspect/apis/storeinspect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storeinspect/apis/storeinspect-api/revisions/e9477dd90cf9?raw)