Journalist Verification API
This API allows you to verify if a social media username belongs to a Legitimate journalist in our system.
POST /api/v1/verify_journalist
URL: https://www.legitimate.net
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 aretwitter
,linkedin
, orfacebook
.
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.
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"
}
The API can return the following errors:
422 Unprocessable Entity
: If thesocial_type
parameter is missing or invalid.500 Internal Server Error
: If there is an error with the server.
- The
social_username
parameter is case-insensitive. - The
social_type
parameter must be one oftwitter
,linkedin
, orfacebook
. - If the
verified
field isfalse
, the API response will contain amessage
field with the error message.
Last modified 1mo ago