Social Signals

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 \
  https://api.fullcontact.com/v3/verify.signals \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "[email protected]"
  ],
  "phones": [
    "+15552227799"
  ],
  "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": "https://www.linkedin.com/in/sallysmi"
    }, {
    "service": "github",
    "url": "https://www.github.com/smith"
    }],
  "maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
  "li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ",
  "panoramaId": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b"
  }'

{
"profiles": {
  "twitter": {
    "username": "bartlorang",
    "userid": "5998422",
    "url": "https://twitter.com/bartlorang",
    "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": "https://d2ojpxxtu63wzl.cloudfront.net/static/a7e6a5aba590d4933e35eaadabd97fd2_44e00e968ac57725a15b32f9ca714827aff8e4818d290cb0c611f2e2585253b3"
  }
],
"urls": [
  {
    "label": "blog",
    "value": "http://sample.blog.com"
  }
]
}

Social Signals Properties
profiles.{platform}.username string	Displayable username of the profile.
profiles.{platform}.userid string	User ID associated with the profile.
profiles.{platform}.url string	URL to the profile on the social platform.
profiles.{platform}.bio string	Bio of the profile form the social platform.
profiles.{platform}.service string	Name of the social platform.
profiles.{platform}.followers integer	Number of follows of the profile, if applicable.
profiles.{platform}.following integer	Number of profiles or topics the user is following, if applicable.
photos[n].label string	The type of photo.
photos[n].value string	The URL to the photo.
urls[n].label string	The type of URL/website.
urls[n].value string	The URL of the website.

Response Codes & Errors

Response Codes	Message
200 - OK	Your request was successful
204 - No Content	Individual is not found within FullContact's Identity Graph
400 - Bad Request	Your request was invalid
500 - Server Error	Something is broken on FullContact's side. If you encounter this, please contact us at [email protected] for assistance.
503 - Service Unavailable	There is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again.