LogoLogo
Sign InCertnCertn Help
Certn API
Certn API
  • Certn API
  • Getting Started
    • Request a demo account
      • Get your access token
      • Understand your general resources
      • Create your first application
      • Retrieve the results
  • Guides
    • Manage your settings
    • Manage your integration users
    • Use the API
      • Get and use an Authorization Token
      • Use webhooks
        • Webhook parameters and example
      • Get the applicant's consent
    • Run a check
      • Address Reference Check
      • Australia Right To Work Check
      • Basic Disclosure And Barring Service Check
      • Basic Disclosure Scotland Check
      • Canadian Criminal Record Check
      • Credential Verification
      • Credit Check
      • Education Verification
      • Employment Verification
      • Employment Reference Check
      • Enhanced Identity Verification
      • International Criminal Record Check
      • Motor Vehicle Record Check / Driver's Abstract
      • Softcheck
      • Social Media Check
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • Settings and packages
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
        • Package settings
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook

The Certn Group of companies includes Certn, Credence & InterCheck. For educational purposes, these companies are referred to as “Certn” in this website. For questions about any of the aforementioned companies, contact support@certn.co. ©2023 Certn.

On this page
  • Availability
  • Parameters
  • Report
  • Test data
  • Errors

Was this helpful?

Export as PDF
  1. Guides
  2. Run a check

Social Media Check

PreviousSoftcheckNextSOQUIJ

Last updated 1 year ago

Was this helpful?

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), the US and US territories , and Australia

This check is available for a

Industry
Availability
Endpoints

Human Resources

Yes

Property Management

Yes

Industry
Availability
Endpoints

Human Resources

Yes

Property Management

Yes

Industry
Availability
Endpoints

Human Resources

Yes

Property Management

Yes

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

See all available Application parameters

Quickscreen parameters

To complete a quickscreen, include these parameters in the body of your request:

    • first_name

    • last_name

    • date_of_birth

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

US and US territories

Employment (HR)

US and US territories

Tenant screening (PM)

Example request

Canadian address sample

{
    "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 address sample with county

{
    "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 address Sample

{
    "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

Test data

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 country or province_state.

"non_field_errors": "Social Media Check cannot be ordered for applicants living in this location."

How to fix this issue

Make sure your applicant resides in one of our supported regions.

(min 1 - the current address has to be in Canada (excluding QC), US, or Australia)

Make sure to obtain the from your applicant before running the quickscreen.

Report field:

Send Social Media requests with the following parameters on our to retrieve our pre-filled reports.

proof of consent
demo environment
Error codes
Social media consent form 05.02.22
Social media consent form Tenancy 2.1.23
🇨🇦
🇺🇸
🇦🇺
✅
✅
📩
✅
📩
✅
📩
✅
📩
✅
📩
✅
📩
quickscreen
information
addresses
position_or_property_location
social_media_details
request_social_media_check
social_media_check_result
Quickscreen
Invite
Quickscreen
Quickscreen
Invite
Quickscreen
Invite
Quickscreen
Invite
Invite
Quickscreen
Invite