Legitimate Universal Bio API
Version 1.0
This API allows users to verify articles and domains; extracting information about them. The main endpoint is:
'https://www.legitimate.net/api/verify_article'
- Verifies an article and retrieves detailed information about it. More endpoints will be launching in the coming weeks.
Onboarding
To be able to make API calls you need to have a Legitimate profile. After creating a Legitimate profile visit https://www.legitimate.net/apis.html (available in the footer) where you can sign up for an API account.
Once you sign up for an account your API credentials will be available in your settings area under "API Settings" tab.
Authentication
To authenticate your call you need to use a Bearer Token made up from your API key and secret.
Verify Article
POST
https://www.legitimate.io/api/verify_article
Query Parameters
Headers
Fields:
For the nested articles
array, each object within it has the following fields:
For the nested domain_info
object, the table is as follows:
For the nested bodies_associations
array within domain_info
, each object has the following fields:
For the nested registration_data
object within domain_info
, the table is as follows:
Example call
Always try to include https:// or http:// in the query string.
Response Types
The "type" field can help you determine what way to handle the response.
There are 4 main response types:
Article Verified: The article and author are verified.
Domain Verified Plus: The article is not verified but the domain is verified and additional information is supplied such as other journalists (up to 3) that write for that publication and the latest articles (3).
Domain Verified: The article is not verified but we can verify the domain and provide domain information.
Unverified: Both the article and the domain are not verified. We will then supply additional context and details regarding the domain.
Article Verified Example
When an article is verified a design similar to the image above could be created to represent the article's author. Additional domain information will also be sent if you wanted to display that as well.
Domain Verified Plus
This is an example of what is possible using the Domain Verified Plus response data.
Domain Verified
An example of using the Domain Verified response. For the associations sub section. The API will supply the image, acronym, full name and description. In the example above we have shown the logos however you could add hover effects to show more information from the API.
See the sub section code below:
Unverified
This is an example of what could be displayed using the unverified response.
Examples in various languages
Last updated