Guides

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 \
  https://api.fideo.ai/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"
    }],
  }'
{
  "socialProfiles": [
    {
      "username": "jenny.davidson",
      "userid": "215652865",
      "url": "https://www.linkedin.com/in/jennydavidson1186",
      "bio": "Cheif of Getting Things Done",
      "service": "linkedin",
      "followers": 508,
      "following": 307
    },
    {
      "username": "jennay1245",
      "url": "http://www.pinterest.com/jennay1245/",
      "service": "pinterest",
      "followers": 7456,
      "following": 21
    },
    {
      "username": "jennagainn12983",
      "userid": "8675309",
      "url": "https://twitter.com/jennagainn12983",
      "bio": "It's Jenn. Againn....",
      "service": "twitter",
      "followers": 62,
      "following": 50
    }
  ],
  "photos": [
  {
    "label": "avatar",
    "value": "https://d2ojpxxtu63wzl.cloudfront.net/static/a7e6a5aba590d4933e35eaadabd97fd2_44e00e968ac57725a15b32f9ca714827aff8e4818d290cb0c611f2e2585253b3"
  }
],
}


Social Signals Response Properties

Property NameTypeDescription
socialProfiiles.usernamestringThe common username for the profile, often found in the url of the profile
socialProfiles.useridstringA user ID for the profile. This can often be different from a username, and is often numeric, but depends on the platform
socialProfiles.urlstringA direct URL to the individual's profile
socialProfiles.biostringThe headline or short top description from the given profile
socialProfiles.servicestringIndicator of which social network / platform (LinkedIn, Github, Pinterest, Twitter, etc)
socialProfiles.followersintegerThe number of profiles following this individual profile
socialProfiles.followingintegerThe number of other profiles the individual is following on the platform.
photos.labelstringType of photo being provided.
photos.valuestringURL to photo.

Response Codes & Errors

Response CodesMessage
200 - OKYour request was successful
204 - No ContentIndividual is not found within Fideo's Identity Graph
400 - Bad RequestYour request was invalid
500 - Server ErrorSomething is broken on Fideo'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.