Social

Social Contact Expand API

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

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.

Q: What's the max batch size?

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

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.

Request a Demo Contact Sales

Home
API
Endpoints
Social
Social Contact Expand API

Social Contact Expand API

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

inventory_2 What You Receive

monitor_heart

results array

one item per input

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

data_object

records array

sequence of blocks

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

fact_check

Blocks for searches that returned no match are left out entirely

lock Full API documentation provided after vetting from our compliance team. Request sample response arrow_forward

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.

Filter by topic

help

Compliance Team

Global Data Support

Need help planning your custom integration or understanding our compliance coverage? Our team is here to assist.

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.

Enquire now

Ready to integrate Social Contact Expand API?

Talk to our team about credentials, sandbox access and the right combination of endpoints for your workflow.

Call 03 9948 4089 · sales@globaldata.net.au

Request a Demo Contact Sales