Social Signals

Receive key social platform signals associated with an individual to flag suspicious activities or validate identities.

Social Signals enables you to retrieve a list of all known social profiles of a given contact, returning data for each social platform such as any applicable usernames/handles, the URL of the platform, any bio that the user supplied, and more. Additionally, any profile pictures and URLs to other websites associated with the contact will be returned. These insights will be returned within the profiles, photos, and urls keys.

curl -X POST \ \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "[email protected]"
  "phones": [
  "location": {
    "addressLine1": "123 Main Street",
    "city": "Denver",
    "region": "Colorado",
    "regionCode": "CO",
    "postalCode": "80203"
  "name": {
    "given": "Sally",
    "family": "Smith"
  "profiles": [{
    "service": "twitter",
    "username": "smith"
    }, {
    "service": "twitter",
    "userid": "123456"
    }, {
    "service": "linkedin",
    "url": ""
    }, {
    "service": "github",
    "url": ""
  "maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
  "li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ",
  "panoramaId": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b"
"profiles": {
  "twitter": {
    "username": "bartlorang",
    "userid": "5998422",
    "url": "",
    "bio": "CEO & Co-Founder of @FullContact, Managing Director @v1vc_. Tech Entrepreneur, Investor. Husband to @parkerbenson and Father to Greyson Lorang",
    "service": "twitter",
    "followers": 5454,
    "following": 741
"photos": [
    "label": "avatar",
    "value": ""
"urls": [
    "label": "blog",
    "value": ""
Social Signals Properties
profiles.{platform}.username stringDisplayable username of the profile.
profiles.{platform}.userid stringUser ID associated with the profile.
profiles.{platform}.url stringURL to the profile on the social platform.
profiles.{platform}.bio stringBio of the profile form the social platform.
profiles.{platform}.service stringName of the social platform.
profiles.{platform}.followers integerNumber of follows of the profile, if applicable.
profiles.{platform}.following integerNumber of profiles or topics the user is following, if applicable.
photos[n].label stringThe type of photo.
photos[n].value stringThe URL to the photo.
urls[n].label stringThe type of URL/website.
urls[n].value stringThe URL of the website.

Response Codes & Errors

Response CodesMessage
200 - OKYour request was successful
204 - No ContentIndividual is not found within FullContact's Identity Graph
400 - Bad RequestYour request was invalid
500 - Server ErrorSomething is broken on FullContact's side. If you encounter this, please contact us at [email protected] for assistance.
503 - Service UnavailableThere is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again.