Skip to main content
POST
/
stores
/
search
Search stores
curl --request POST \
  --url https://storeinspect.com/api/v1/stores/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "categories": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ],
    "traffic_tiers": [
      "<string>"
    ],
    "revenue_tiers": [
      "<string>"
    ],
    "shopify_plus": true,
    "apps": {
      "any": [
        "<string>"
      ],
      "none": [
        "<string>"
      ]
    },
    "pixels": {
      "any": [
        "<string>"
      ],
      "none": [
        "<string>"
      ]
    },
    "themes": {
      "types": []
    },
    "meta_ads": {
      "active_ads_min": 50000
    },
    "contacts": {
      "has_revealable_contacts": true,
      "roles_any": [
        "<string>"
      ]
    }
  },
  "limit": 25,
  "cursor": null
}
'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "domain": "<string>",
      "name": "<string>",
      "category": "<string>",
      "country": "<string>",
      "traffic_tier": "<string>",
      "revenue_tier": "<string>",
      "shopify_plus": true,
      "lead_fit_score": 123,
      "technologies": {
        "apps": [
          "<string>"
        ],
        "pixels": [
          "<string>"
        ],
        "theme": {
          "name": "<string>",
          "type": "<string>"
        }
      },
      "contacts_summary": {
        "total": 123,
        "has_revealable_contacts": true,
        "verified_email_count": 123,
        "roles": [
          "<string>"
        ]
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
object
required
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string | null
Pattern: ^cur_[A-Za-z0-9_-]+$

Response

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

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
next_cursor
string | null
required
request_id
string
required