Links

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.