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.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 Name	Type	Description
socialProfiiles.username	string	The common username for the profile, often found in the url of the profile
socialProfiles.userid	string	A user ID for the profile. This can often be different from a username, and is often numeric, but depends on the platform
socialProfiles.url	string	A direct URL to the individual's profile
socialProfiles.bio	string	The headline or short top description from the given profile
socialProfiles.service	string	Indicator of which social network / platform (LinkedIn, Github, Pinterest, Twitter, etc)
socialProfiles.followers	integer	The number of profiles following this individual profile
socialProfiles.following	integer	The number of other profiles the individual is following on the platform.
photos.label	string	Type of photo being provided.
photos.value	string	URL to photo.

Response Codes & Errors

Response Codes	Message
200 - OK	Your request was successful
204 - No Content	Individual is not found within Fideo's Identity Graph
400 - Bad Request	Your request was invalid
500 - Server Error	Something is broken on Fideo'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.