Social

Social Contact Expand API

Social Contact Expand takes a batch of contact identifiers, phone numbers, email addresses or social media profile URLs, and for each one surfaces the additional phone numbers and email addresses associated with that person, first from a social check and then from lookups in the Global Data Universe.

Two stages per identifier: a social check, then a universe lookup for every phone and email known, each producing its own block of additional contacts
Up to 50 identifiers per call, with a search ID echoed on each result and invalid inputs reported per item and not billed

Get API access Talk to us

For developers

After the technical detail?

For the technical detail, go to the API documentation. It holds the request and response schema, the integration guides and the error codes for this endpoint.

Request and response schema
Result blocks and supported inputs

View developer documentation

Endpoints that return personal information require a privacy policy and PII handling processes before access is granted.

Encrypted in transit and at rest Handled under the Australian Privacy Principles

What the check gives you

Finding the other ways to reach a person from the one you hold

A single email or phone number is often all a record contains, and it may be stale. Social Contact Expand starts from that one identifier and returns the other phones and emails linked to the person, gathered from a social check and from lookups in the Global Data Universe for every contact found along the way. Only the stages that found something are returned.

Contacts from the social check

A social search block lists the phones and emails the social check returned for the identifier.

Contacts from the universe

One universe search block per lookup that found related people, listing the additional phones and emails discovered for them. The lookups run on the original input and on every phone or email the social check found.

Only what was found

Blocks that returned nothing are omitted, with no fixed number or order. An identifier with nothing anywhere returns an empty records array and the message No match.

What is excluded

Suppressed phones and emails are left out. A profile URL cannot itself be searched in the universe, so it only yields universe matches through the contacts the social check finds.

What it costs

A monthly subscription, drawn down as you run checks

Your subscription is credited to your account each month and each check consumes credits from it. If you go past the included amount, further checks are charged at a per-check rate. The rate depends on the volume you commit to, so the sales team is the fastest way to find where your business lands.

Pay as you go available
No lock-in contract

How billing works

Subscribe monthly, spend it as credits

The monthly subscription arrives as credits on your account.
Each check draws down credits as it runs.
Checks beyond the included credits are billed per check.
Higher monthly volume moves you to a lower rate.

Talk to sales about volume

Related checks

Others in Social

Social Check returns the full public footprint for an identifier. Phone Contact Lookup and Address Lookup by Contact resolve a single number or email in the universe.

Social Check API

All Social endpoints

Questions

Questions we get asked about Social Contact Expand

Do we need a developer to implement this?

Yes. Social Contact Expand is a REST endpoint that takes a JSON array of identifiers and returns a JSON array of results, so a developer connects it to your enrichment or tracing process. A sandbox with a deterministic test dataset is provided at no usage cost, so the integration can be built and tested before production keys are issued.

What does our system need to send?

A requests array of 1 to 50 items, each with a search value of up to 200 characters, an email address, a phone number in E.164 or 0NSN format, or a social profile URL, which the API detects automatically, and an optional search ID of up to 50 characters.

What comes back for each identifier?

The search ID, a message of Ok or No match, and a records array of blocks. Each block carries a type, social search or universe search, and the phones and emails found. Iterate over the blocks and read the type; their number and order are not fixed.

Which items are billed?

Invalid inputs return a per-item Error: Invalid search value message and are not billed.

Where does the data come from?

A social check against public social media sources, then lookups in the Global Data Universe for each phone and email known for the contact.

What are our obligations when using this endpoint?

This endpoint returns personally identifiable information. Access to endpoints that return PII requires an appropriate privacy policy and PII handling processes, and use is subject to the Global Data privacy policy and terms of service. On Global Data's side, PII sent in a request is not retained, data is encrypted in transit and at rest, and retention follows the Australian Privacy Act and the Australian Privacy Principles.

Getting started

The first step to access is a conversation

Endpoints that return personal information are opened only to accounts with a privacy policy and PII handling processes in place, and production API keys are issued once the account has been commercially approved.

Get API access Talk to us

Call 03 9948 4089, 9am–5pm AEST Monday to Friday

Encrypted in transit and at rest

Handled under the Australian Privacy Principles

ISO 27001 Certified