social media check.md
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs; this page is available as Markdown.
Social Media Check
Certn's Social Media Check is an analysis of candidates’ public posts across social media platforms, the web and news articles. Certn retrieves these profiles, posts and images to determine if they fit into one or more pre-defined categories.
Availability
This check is available for applicants from Canada (excluding Quebec) :flag_ca:, the US and US territories :flag_us:, and Australia :flag_au:
This check is available for a quickscreen :white_check_mark:
Canada
| Industry | Availability | Endpoints |
|---|---|---|
| Human Resources | Yes | Quickscreen ✅, Invite 📩 |
| Property Management | Yes | Quickscreen ✅, Invite 📩 |
US and US Territories
Australia
Parameters
Request flag
Include this flag in the body of your request:
Invite parameters
To invite an applicant to complete a screen, include this parameter in the body of your request:
email
Quickscreen parameters
To complete a quickscreen, include these parameters in the body of your request:
informationfirst_namelast_namedate_of_birthaddresses(min 1 - the current address has to be in Canada (excluding QC), US, or Australia)
position_or_property_locationsocial_media_details
Quickscreen consent forms
We provide sample consent forms if you're running quickscreens on applicants residing in these regions:
| Sample consent form | Candidate region | Your industry |
|---|---|---|
| Social media consent form 05.02.22 | US and US territories | Employment (HR) |
| Social media consent form Tenancy 2.1.23 | US and US territories | Tenant screening (PM) |
Example request
Canada
{
"request_social_media_check": true,
"email": "example@certn.co",
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"date_of_birth": "1987-03-04",
"addresses": [
{
"address": "12 CA address St",
"city": "Burnaby",
"province_state": "BC",
"country": "CA",
"postal_code": "V2N7C3",
"start_date": "2000-02-02",
"current": true
}
],
"social_media_details": {
"high_school_name": "My high school",
"college_country": "Canada",
"college_name": "Test college",
"twitter_url": "https://twitter.com",
"facebook_url": "myFacebook",
"instagram_url": "instagram_handle",
"linkedin_url": "test_linkedin_link",
"tiktok_url": null,
"reddit_url": null
}
},
"position_or_property_location": {
"address": "2680 Blanshard St Unit 3",
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"postal_code": "V8T5E1",
"location_type": "Position Location"
}
}
US and US Territories
{
"request_social_media_check": true,
"email": "example@certn.co",
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"date_of_birth": "1987-03-04",
"addresses": [
{
"address": "3601 West Belleview Avenue",
"city": "Littleton",
"province_state": "CO",
"county": "Arapahoe",
"country": "US",
"postal_code": "80123",
"start_date": "2000-02-02",
"current": true
}
],
"social_media_details": {
"high_school_name": "My high school",
"college_country": "US",
"college_name": "Test college",
"twitter_url": "https://twitter.com",
"facebook_url": "myFacebook",
"instagram_url": "instagram_handle",
"linkedin_url": "test_linkedin_link",
"tiktok_url": null,
"reddit_url": null
}
},
"position_or_property_location": {
"address": "Tiffany & Co., 97 Greene St",
"city": "New York City",
"county": "New York",
"province_state": "NY",
"country": "US",
"postal_code": "10012",
"location_type": "Position Location"
}
}
Australia
{
"request_social_media_check": true,
"email": "example@certn.co",
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"date_of_birth": "1987-03-04",
"addresses": [
{
"address": "42 Wallaby Way",
"city": "Sydney",
"province_state": "NSW",
"country": "AU",
"postal_code": "2000",
"start_date": "2000-02-02",
"current": true
}
],
"social_media_details": {
"high_school_name": "My high school",
"college_country": "AU",
"college_name": "Test college",
"twitter_url": "https://twitter.com",
"facebook_url": "myFacebook",
"instagram_url": "instagram_handle",
"linkedin_url": "test_linkedin_link",
"tiktok_url": null,
"reddit_url": null
}
},
"position_or_property_location": {
"address": "600 George St",
"city": "Sydney",
"province_state": "NSW",
"country": "AU",
"postal_code": "2000",
"location_type": "Position Location"
}
}
Report
Report field: social_media_check_result
Test data
Send Social Media requests with the following parameters on our demo environment to retrieve our pre-filled reports.
Clear results
| First name | Last name | Address | Result |
|---|---|---|---|
| Clear | SupportedRegion | US, Canada (non Quebec), Australia | Clear |
Records found
| First name | Last name | Address | Result |
|---|---|---|---|
| Review | SupportedRegion | US, Canada (non Quebec), Australia | Review |
| Any | Any | Quebec, Canada, Australia | Review |
Errors
400 Bad Request
You may receive a 400 Bad Request if:
- You sent a quickscreen request for a Social Media Check on a applicant residing in an unsupported
countryorprovince_state.
How to fix this issue
Make sure your applicant resides in one of our supported regions.