LogoLogo
Sign InCertnCertn Help
Certn API v 1.0
Certn API v 1.0
  • Certn API v 1.0
  • Getting Started
    • Create a demo account
      • Send your first request
      • Retrieve the results
  • Guides
    • Manage your team
    • Use the API
      • Use an authorization header
      • Use webhooks
      • 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
      • Social Media Check
      • Softcheck
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • General
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook
On this page
  1. Guides
  2. Run a check

Social Media Check

PreviousMotor Vehicle Record Check / Driver's AbstractNextSoftcheck

Last updated 1 year ago

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 [email protected]. ©2023 Certn.

CtrlK
  • Availability
  • Parameters
  • Report
  • Test data
  • Errors

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 quickscreen ✅

Industry
Availability
Endpoints

Human Resources

Yes

  • Quickscreen ✅

  • Invite 📩

Property Management

Yes

  • Quickscreen ✅

  • Invite 📩

Industry
Availability
Endpoints

Human Resources

Yes

  • Quickscreen ✅

  • Invite 📩

Property Management

Yes

  • Quickscreen ✅

  • Invite 📩

Industry
Availability
Endpoints

Human Resources

Yes

  • Quickscreen ✅

  • Invite 📩

Property Management

Yes

  • Quickscreen ✅

  • Invite 📩

Parameters

Request flag

Include this flag in the body of your request:

request_social_media_check

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:

  • information

    • first_name

    • last_name

    • date_of_birth

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

  • position_or_property_location

  • social_media_details

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

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

Canadian address sample

{
    "request_social_media_check": true,
    "email": "[email protected]",
    "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": "[email protected]",
    "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": "[email protected]",
    "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 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.

Error codes