POST
/
v2
/
profiles
/
contacts
/
search
Search contact profiles with structured filters
curl --request POST \
  --url https://api-v2.watchcollect.com/v2/profiles/contacts/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "q": "<string>",
  "country_prefixes_include": [
    "<string>"
  ],
  "country_prefixes_exclude": [
    "<string>"
  ],
  "has_selling": true,
  "has_buying": true,
  "group_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "last_seen_from_ms": 123,
  "last_seen_to_ms": 123,
  "sort": "last_seen",
  "page_size": 100,
  "cursor": "<string>"
}
'
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "raw_sender_id": "<string>",
      "resolution_status": "<string>",
      "first_seen_at_ms": 123,
      "last_seen_at_ms": 123,
      "message_count": 123,
      "classified_count": 123,
      "listing_count": 123,
      "selling_count": 123,
      "buying_count": 123,
      "reference_count": 123,
      "group_count": 123,
      "display_name": "<string>",
      "phone_number": "<string>",
      "lid": "<string>",
      "country_prefix": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

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

Body

application/json
q
string
country_prefixes_include
string[]
country_prefixes_exclude
string[]
has_selling
boolean
has_buying
boolean
group_ids
string<uuid>[]
last_seen_from_ms
integer<int64>
last_seen_to_ms
integer<int64>
sort
enum<string>
default:last_seen
Available options:
last_seen,
listings,
messages,
references
direction
enum<string>
Available options:
asc,
desc
page_size
integer
Required range: 1 <= x <= 200
cursor
string

Response

Cursor page of contacts.

items
object[]
required
has_more
boolean
required
next_cursor
string | null