Skip to main content
POST
/
contacts
/
search
Search contacts
curl --request POST \
  --url https://storeinspect.com/api/v1/contacts/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "person": {
    "roles_any": [
      "<string>"
    ],
    "seniority_any": [
      "<string>"
    ],
    "has_verified_email": true,
    "has_phone": true,
    "has_linkedin": true
  },
  "store": {
    "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
    }
  },
  "max_contacts_per_store": 1,
  "limit": 25,
  "cursor": null
}
'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "first_name": "<string>",
      "last_name_obfuscated": "<string>",
      "role": "<string>",
      "title": "<string>",
      "has_verified_email": true,
      "has_phone": true,
      "has_linkedin": true,
      "revealed": true,
      "store": {
        "id": "<string>",
        "domain": "<string>",
        "name": "<string>",
        "category": "<string>",
        "traffic_tier": "<string>",
        "technologies": {
          "apps": [
            "<string>"
          ],
          "pixels": [
            "<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
person
object
store
object
max_contacts_per_store
integer
default:1
Required range: 1 <= x <= 10
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string | null
Pattern: ^cur_[A-Za-z0-9_-]+$

Response

A cursor-paginated list of contact previews 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