Social Contact Expand API

POST
/social_contact_expand
LIVE

Take a contact identifier (phone, email, or social profile URL) and surface additional phones and emails associated with the same person. Each input runs through a two-stage process: a social media check on the original input, plus a universe lookup for each phone or email known for that contact. The response keeps social_search and universe_search blocks separate so you can see which lookup found what. Suppressed phones and emails are excluded.

calendar_today Request a Demo Contact Sales

Example Request

POST
request.json
key Auth: BearerAuth 
{
  "requests": [
    {
      "search_id": "abc-1",
      "search": "john@example.com"
    }
  ]
}

Request Schema

requests
Required
array · (1 to 50)

Up to 50 records to expand per call.

requests[].search_id
Optional
string · (≤50 chars)

Optional correlation ID.

requests[].search
Required
string · (≤200 chars)

Phone (0NSN or E.164), email, or social profile URL.

Available Response Data

5 Data Points
01
monitor_heart

results array

one item per input

02
data_object

Per-item

search_id, original search value, and message Ok if any block returned data, No match otherwise, or Error: Invalid search value

03
data_object

records array

sequence of blocks

04
data_object

Each block has a type

social_search or universe_search, the search_for value, plus emails and phones arrays of additional contacts discovered

05
fact_check

Blocks for searches that returned no match are left out entirely

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

contacts

Contact universe expansion

Take a single phone or email and surface every other contact channel known for that person. Useful for skip tracing, customer support and re-engagement campaigns.

compare_arrows

Cross-channel contact reconciliation

Reconcile contact records held in different parts of your business. Two records with different emails turn out to belong to the same person via a shared phone.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

rocket_launch Implementation

What does the two-stage process look like in the response?

add

For each input, a social_search block runs the social media check on the original identifier. Then a universe_search block runs for each phone or email known for that contact, including the original input and any phones or emails returned by the social check. Only blocks that actually returned phones or emails appear in the response.

rocket_launch Implementation

What input types are supported?

add

Three, auto-detected. Emails (any RFC-compliant address), phones (E.164 or 0NSN format), or social profile URLs from the supported networks. Profile-only URLs only yield universe matches if the social check returns associated phones or emails.

help_center General

What's the max batch size?

add

50 requests per call. Invalid inputs return a per-item Error: Invalid search value and aren’t billed.

Try it Live

API Testing Sandbox tag

Test the Social Contact Expand API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.

(03) 9948 4089
Request a Demo