# 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**](https://docs.certn.co/api/certn-api-v-1.0/faq#what-is-a-quickscreen-and-how-do-i-use-it) :white\_check\_mark:

{% tabs %}
{% tab title="Canada" %}

| Industry            | Availability | Endpoints                                                                                                                                                                                                                                                                                                                      |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Human Resources     | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen </a><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/hr#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| Property Management | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen </a><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/pm#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| {% endtab %}        |              |                                                                                                                                                                                                                                                                                                                                |

{% tab title="US and US territories" %}

| Industry            | Availability | Endpoints                                                                                                                                                                                                                                                                                                                      |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Human Resources     | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen </a><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/hr#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| Property Management | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen </a><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/hr#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| {% endtab %}        |              |                                                                                                                                                                                                                                                                                                                                |

{% tab title="Australia" %}

| Industry            | Availability | Endpoints                                                                                                                                                                                                                                                                                                                      |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Human Resources     | Yes          | <ul><li><a href="../../../api-reference/hr#screen-an-applicant-instantly">Quickscreen </a><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/hr#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| Property Management | Yes          | <ul><li><a href="../../../api-reference/pm#screen-an-applicant-instantly">Quickscreen</a> <span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></li><li><a href="../../../api-reference/pm#invite-an-applicant">Invite</a> <span data-gb-custom-inline data-tag="emoji" data-code="1f4e9">📩</span></li></ul> |
| {% endtab %}        |              |                                                                                                                                                                                                                                                                                                                                |
| {% endtabs %}       |              |                                                                                                                                                                                                                                                                                                                                |

### **Parameters**

#### Request flag

Include this flag in the body of your request:

[`request_social_media_check`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags#request-flags)

#### 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](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters "mention")

#### Quickscreen parameters

To complete a quickscreen, include these parameters in the body of your request:&#x20;

* [`information`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#information) &#x20;
  * `first_name`
  * `last_name`
  * `date_of_birth`
  * [`addresses`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#address) (min 1 - the current address has to be in **Canada** (excluding QC), **US**, or **Australia**)
* [`position_or_property_location`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#position-or-property-location)&#x20;
* [`social_media_details`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters#specialization-1)

{% hint style="warning" %}
Make sure to obtain the [proof of consent](https://docs.certn.co/api/certn-api-v-1.0/guides/use-the-api/consent) from your applicant **before** running the quickscreen.
{% endhint %}

#### 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](https://drive.google.com/file/d/16Ldm31LBJl1aXXDL3IPRRMG0RTAPtkU6/view?usp=share_link)                                                         | US and US territories | Employment (HR)       |
| [Social media consent form  Tenancy 2.1.23](https://docs.google.com/document/d/1Dw_XvW81H2o5XAaGIHv7robaeRCyiJc-/edit?usp=sharing\&ouid=115241323289372245932\&rtpof=true\&sd=true) | US and US territories | Tenant screening (PM) |

**Example request**

{% tabs %}
{% tab title="Canada" %}
Canadian address sample

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="US and US territories" %}
US and US territories address sample with county

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="Australia" %}
Australia address Sample

```json
{
    "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"
    }
}
```

{% endtab %}
{% endtabs %}

### Report

Report field: [`social_media_check_result`](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/report-field-mappings#social-media-check-result)&#x20;

### **Test data**

Send Social Media requests with the following parameters on our [demo environment](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account) 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 <a href="#id-400-bad-request" id="id-400-bad-request"></a>

‌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`.

{% hint style="danger" %}
&#x20;"non\_field\_errors": "Social Media Check cannot be ordered for applicants living in this location."
{% endhint %}

#### How to fix this issue <a href="#how-to-fix-this-issue" id="how-to-fix-this-issue"></a>

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

{% content-ref url="../../api-reference/resources/error-codes" %}
[error-codes](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/error-codes)
{% endcontent-ref %}