Combined API
This API combines the power of Clearbit’s Person and Company APIs, allowing you to retrieve detailed information about both an individual and their associated company in a single request. Basically, this operation returns two objects (Person and Company) in one, significantly extending provided information.
Method:
GET
Endpoint URL:
The xxxx.backendless.app is a subdomain assigned to your application. For more information see the Client-side Setup section of the Backendless documentation.
https://xxxx.backendless.app/api/services/Clearbit/combinedEnrichment
Request Headers:
Content-Type:application/json
Request Body:
None.
Response Body:
A JSON object containing information related to the requested individual and the associated company.
Parameters:
email – Required parameter. String value. The email address of the person you want to retrieve information about. Clearbit will use this email to look up additional details such as social profiles, job titles, and company information.
givenName – Optional parameter. String value. The given name (i.e. first name) of the person. This can be used in combination with other parameters to narrow down the search results.
familyName – Optional parameter. String value. The family name (i.e. last name) of the person. This can be used in combination with other parameters to narrow down the search results. Significantly improves match rates.
ipAddress – Optional parameter. String value. The IP address of the person which is used to determine the person’s location and provide additional details based on geography. Significantly improves match rates.
location – Optional parameter. String value. The location of the person. This can be specified as a city or country.
company – Optional parameter. String value. The name of the company that the person you want to retrieve information about is associated with. This can be used to look up all individuals associated with that company.
companyDomain – Optional parameter. String value. The domain name of the company that the person you want to retrieve information about is associated with. This can be used to look up all individuals associated with that company, and can be a more reliable identifier than the company name.
linkedIn – Optional parameter. String value. The LinkedIn URL of the person you want to retrieve information about. Can be used to look up additional details about the professional background of an individual.
twitter – Optional parameter. String value. The Twitter handle (i.e. @bobby) of the person you want to retrieve information about. Can use this to look up additional details about the person’s social media presence.
facebook – Optional parameter. String value. The Facebook URL of the person you want to retrieve information about. Can be used to look up additional details about the person’s social media presence.
Example:
The example below runs the enrichment procedure using the provided email address mark@backendless.com and the company name Backendless to obtain additional information about both entities.
curl -X "GET" "https://xxxxx.backendless.app/api/services/Clearbit/combinedEnrichment?email=mark@backendless.com&company=Backendless" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'
The operation returns an object containing additional information and also it saves this object to the ClearbitPeople data table.
{
"person": {
"indexedAt": "2023-04-14T15:03:38.331Z",
"github": {
"followers": 14,
"following": 0,
"handle": "markpiller",
"company": "Backendless",
"id": 120929,
"avatar": "https://avatars.githubusercontent.com/u/120929?v=4",
"blog": "backendless.com"
},
"utcOffset": -5,
"facebook": {
"handle": null
},
"timeZone": "America/Chicago",
"bio": null,
"avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/7b3b6c05-db4c-4742-bd81-60003b09751b",
"employment": {
"role": "leadership",
"domain": "backendless.com",
"name": "Backendless",
"subRole": "founder",
"title": "Founder",
"seniority": "executive"
},
"linkedin": {
"handle": "in/markpiller"
},
"clearbitId": "7b3b6c05-db4c-4742-bd81-60003b09751b",
"geo": {
"country": "United States",
"lng": -96.79698789999999,
"city": "Dallas",
"countryCode": "US",
"stateCode": "TX",
"state": "Texas",
"lat": 32.7766642
},
"site": "http://backendless.com",
"twitter": {
"favorites": null,
"site": null,
"followers": null,
"following": null,
"bio": null,
"statuses": null,
"handle": null,
"location": null,
"id": null,
"avatar": null
},
"emailProvider": false,
"gravatar": {
"urls": [],
"handle": "markpiller",
"avatar": "https://secure.gravatar.com/avatar/cb5cb6d5dc95c423d6619557e5404fc5",
"avatars": [
{
"type": "thumbnail",
"url": "https://secure.gravatar.com/avatar/cb5cb6d5dc95c423d6619557e5404fc5"
}
]
},
"name": {
"givenName": "Mark",
"familyName": "Piller",
"fullName": "Mark Piller"
},
"location": "Dallas, TX, US",
"email": "mark@backendless.com",
"fuzzy": false,
"googleplus": {
"handle": null
}
},
"company": {
"parent": {
"domain": null
},
"description": "Backendless visual app development platform featuring UI Builder, database, and backend with Codeless logic and APIs - no code required.",
"ultimateParent": {
"domain": null
},
"linkedin": {
"handle": "company/backendless-corp"
},
"type": "private",
"foundedYear": 2012,
"legalName": null,
"geo": {
"country": "United States",
"streetName": "Dallas Parkway",
"subPremise": "300",
"lng": -96.8250468,
"streetNumber": "2591",
"streetAddress": "2591 Dallas Parkway #300",
"city": "Frisco",
"countryCode": "US",
"postalCode": "75034",
"stateCode": "TX",
"state": "Texas",
"lat": 33.0997979
},
"twitter": {
"site": "https://t.co/YSrZrmipx3",
"followers": 1628,
"following": 143,
"bio": "Build faster, scale infinitely with the most robust visual app development platform. UI Builder, APIs, real-time database, & more, coding optional. Start free!",
"handle": "Backendless",
"location": "Cloud",
"id": "715489592",
"avatar": "https://pbs.twimg.com/profile_images/1497633925941932037/1hwH6ML0_normal.png"
},
"emailProvider": false,
"logo": "https://logo.clearbit.com/backendless.com",
"tech": [
"youtube",
"google_apps",
"activecampaign",
"aws_route_53",
"mailchimp",
"wordpress",
"nginx",
"google_maps",
"chargify",
"google_analytics",
"google_tag_manager",
"apache_hadoop",
"apache_tomcat",
"mongodb",
"postgresql",
"mysql",
"atlassian_jira",
"apache_cassandra"
],
"indexedAt": "2023-04-26T09:18:56.816Z",
"ticker": null,
"utcOffset": -5,
"identifiers": {
"usEIN": null
},
"facebook": {
"handle": "backendless",
"likes": 2681
},
"timeZone": "America/Chicago",
"domainAliases": [
"backendless.app"
],
"clearbitId": "d1774122-b917-4370-9ce4-9fdee63fc68d",
"tags": [
"Information Technology & Services",
"Technology",
"SAAS",
"B2B",
"Mobile"
],
"crunchbase": {
"handle": "organization/backendless"
},
"site": {
"emailAddresses": [
"info@backendless.com",
"sales@backendless.com",
"support@backendless.com",
"privacypolicy@backendless.com",
"dmca@backendless.com",
"spidey@backendless.com"
],
"phoneNumbers": [
"+1 408-792-7757"
]
},
"phone": null,
"domain": "backendless.com",
"techCategories": [
"image_video_services",
"productivity",
"marketing_automation",
"dns",
"email_delivery_service",
"content_management_system",
"web_servers",
"geolocation",
"payment",
"analytics",
"tag_management",
"data_processing",
"database",
"project_management_software"
],
"name": "Backendless",
"location": "2591 Dallas Pkwy #300, Frisco, TX 75034, USA",
"metrics": {
"employeesRange": "51-250",
"marketCap": null,
"fiscalYearEnd": null,
"trafficRank": "high",
"alexaGlobalRank": 96929,
"raised": null,
"estimatedAnnualRevenue": "$10M-$50M",
"employees": 60,
"alexaUsRank": null,
"annualRevenue": null
},
"category": {
"subIndustry": "Internet Software & Services",
"naics6Codes": [],
"gicsCode": null,
"sicCode": "48",
"industry": "Internet Software & Services",
"sector": "Information Technology",
"sic4Codes": [],
"industryGroup": "Software & Services",
"naicsCode": "51"
}
}
}
Codeless Reference
