Journalist Verification API

This API allows you to verify if a social media username belongs to a Legitimate journalist in our system.

Endpoint

POST /api/v1/verify_journalist

URL: https://www.legitimate.net

Parameters

• social_username (required): The social media username to verify. Do not include the @ symbol at the start.

• social_type (required): The social media type of the username. Valid values are twitter, linkedin, or facebook.

Response

The API response is in JSON format and contains the following fields:

• verified (boolean): Indicates if the username belongs to a legitimate journalist in our system.

• first_name (string, optional): The first name of the verified journalist.

• last_name (string, optional): The last name of the verified journalist.

• slug (string, optional): The slug of the verified journalist.

• message (string, optional): The error message if the social media username does not belong to a legitimate journalist in our system.

• profile_bio (string, optional) The bio from their profile.

• article_count The count of articles on their profile.

• articles Their last 3 articles.

• profile_image A link to their profile image.

• social_profiles A list of their social profiles.

Example

Request

{
  "social_username": "CriticalRedPen",
  "social_type": "twitter"
}

Response (verified)

{
    "verified": true,
    "first_name": "Elaine",
    "last_name": "Burke",
    "profile_bio": "Elaine Burke is editor of Silicon Republic, having served a few years as managing editor up to 2019. She joined in 2011 as a journalist covering gadgets, new media and tech jobs. She comes from a background in publishing and is known for being particularly pernickety when it comes to spelling and grammar – earning her the nickname, Critical Red Pen.",
    "slug": "elaine-burke",
    "article_count": 136,
    "articles": [
        {
            "id": 1066870,
            "title": "Cork cybersecurity start-up Vaultree selected for EIC Accelerator",
            "description": "Vaultree is among 78 selected companies that will share in up to €470m of funding through a combination of grants and equity investment.",
            "link": "https://www.siliconrepublic.com/start-ups/vaultree-cork-cybersecurity-eic-accelerator",
            "profile_id": 2158,
            "created_at": "2022-12-20T17:32:10.471Z",
            "updated_at": "2022-12-20T17:32:11.008Z",
            "og_image": "https://www.siliconrepublic.com/wp-content/uploads/2022/12/AdobeStock_278003537.jpeg",
            "icon_path": "https://siliconrepublic.com/favicon.ico",
            "published_at": "2022-12-20T16:19:44.000Z",
            "post_id": null,
            "feature": false,
            "lg_index": "",
            "active": true,
            "search_visible": true,
            "author_name": null,
            "tag_list": [
                "Premium"
            ]
        },
        {
            "id": 1057254,
            "title": "Dublin’s new life sciences hotbed opens in Cherrywood",
            "description": "The Campus in Cherrywood has already attracted an Irish and an international start-up to set up shop in its life sciences ecosystem.",
            "link": "https://www.siliconrepublic.com/start-ups/the-campus-cherrywood-life-sciences-incubation-labs",
            "profile_id": 2158,
            "created_at": "2022-12-08T17:44:51.152Z",
            "updated_at": "2022-12-08T17:44:51.600Z",
            "og_image": "https://www.siliconrepublic.com/wp-content/uploads/2022/12/NO-FEE-PIONEER-GROUP-CHERRYWOOD-OPENING-JB2.jpg",
            "icon_path": "https://siliconrepublic.com/favicon.ico",
            "published_at": "2022-12-08T17:10:01.000Z",
            "post_id": null,
            "feature": false,
            "lg_index": "",
            "active": true,
            "search_visible": true,
            "author_name": null,
            "tag_list": [
                "Premium"
            ]
        },
        {
            "id": 1057255,
            "title": "Irish women awarded top EU innovator prizes",
            "description": "Dr Ciara Clancy and Niamh Donnelly were among the six winners of the European Innovation Council’s women innovators awards.",
            "link": "https://www.siliconrepublic.com/innovation/eu-women-innovators-awards-ciara-clancy-niamh-donnelly",
            "profile_id": 2158,
            "created_at": "2022-12-08T17:44:53.791Z",
            "updated_at": "2022-12-08T17:44:54.087Z",
            "og_image": "https://www.siliconrepublic.com/wp-content/uploads/2022/12/FjYrftvXEAILIQn.jpg",
            "icon_path": "https://siliconrepublic.com/favicon.ico",
            "published_at": "2022-12-07T16:37:49.000Z",
            "post_id": null,
            "feature": false,
            "lg_index": "",
            "active": true,
            "search_visible": true,
            "author_name": null,
            "tag_list": [
                "Premium"
            ]
        }
    ],
    "profile_image": "https://legitimate.net/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBK09zQXc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1ea4f80653c972bd8369f8a478ba57405970580c/ElaineBurke.jpg",
    "profile_social_profiles": {
        "twitter": "CriticalRedPen"
    }
}

Response (not verified)

Sent with username: "CriticalRed_Pen" with an underscore inserted.

{
    "verified": false,
    "message": "Not a legitimate journalist"
}

Errors

The API can return the following errors:

• 422 Unprocessable Entity: If the social_type parameter is missing or invalid.

• 500 Internal Server Error: If there is an error with the server.

Notes

• The social_username parameter is case-insensitive.

• The social_type parameter must be one of twitter, linkedin, or facebook.

• If the verified field is false, the API response will contain a message field with the error message.