post https://api.fido.id/{version}/domain
Domain
Trustfull's API endpoints are quite flexible and you can request a range of services from a single endpoint
One of the possible use cases is Domain Intelligence
What is Domain Intelligence?
Domain Intelligence is a product that combines advanced domain validation, data enrichment, and a specific AI model all based on a pair of touch point, the domain and a country code.
Request
following an example of a Domain Intelligence
curl --request POST \
--url https://api.fido.id/1.0/domain \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-api-key: [your_app_key]' \
--data '
{
"customer_id": "your_customer_id",
"claims": [
"domain"
],
"domain": {
"value": "trustfull.com",
"country": "it"
}
}'
Response
Following an example of the response:
{
"resolution_id": "...",
"customer_id": "...",
"device_request_time": "...",
"webhook_url": "...",
"claims": [
"domain"
],
"value": "example.com",
"country_code": "it",
"website_exists": true,
"website_exists_taxonomy": "TAXONOMY_WEBSITE_EXISTS",
"website_exists_ssl": true,
"internal_links_count": 4,
"external_links_count": 8,
"internal_email_links_count": 15,
"external_email_links_count": 16,
"internal_images_count": 23,
"external_images_count": 42,
"page_size": 1057,
"has_linkedin": 1057,
"linkedin_url": "https://www.linkedin.com/company/trustfull",
"linkedin_follower_count": 8089,
"linkedin_company_size": "10,50",
"linkedin_avg_articles_likes_count": 42,
"linkedin_first_article_date": "2024-12-04",
"linkedin_last_article_date": "2024-12-04",
"screenshot": "https://example.com/image.jpg",
"has_ssl": true,
"ssl_is_valid": true,
"ssl_valid_from": "2024-12-04",
"ssl_valid_to": "2024-12-04",
"ssl_issuer_organization": "Let's Encrypt",
"company_name": "Apple",
"company_description": "Apple Inc. is an American...",
"company_industry": "Internet Software & Services",
"company_employees": 1750,
"company_founded": 2014,
"company_keywords": "smartphone,tech",
"company_annual_revenue": 17630000000,
"company_logo": "https://...",
"company_country": "Italy",
"company_twitter_url": "https://...",
"company_facebook_url": "https://...",
"company_linkedin_url": "https://...",
"company_total_funding": "https://...",
"company_tech_stack": "JavaScript",
"has_google_business": true,
"google_business_rating": 4.5,
"google_business_review_count": 100,
"google_business_reviews": "[{\"summary\":\"Food is very good, staff is nice, quick service, good price.\",\"link\":\"https:\\/\\/...\"}]",
"google_business_address": "5th Avenue",
"google_business_country": "Italy",
"google_business_thumbnail": "https://...",
"google_business_phone_number": "393331234567",
"google_business_description": "A long description",
"google_business_industry": "Information services in Milan, Italy",
"google_business_status": "open",
"google_business_hours": "{\"monday\":\"opens: 9 AM, closes: 6:30 PM\",\"tuesday_christmas_eve\":\"opens: 9 AM, closes: 6:30 PMHours might differ\",\"wednesday_christmas\":\"opens: 9 AM, closes: 6:30 PMHours might differ\",\"thursday_saint_stephen_s_day\":\"opens: 9 AM, closes: 6:30 PMHours might differ\",\"friday\":\"opens: 9 AM, closes: 6:30 PM\",\"saturday\":\"opens: Closed\",\"sunday\":\"opens: Closed\"}",
"has_google_ads": true,
"google_ads_days_since_last_shown": 16,
"google_ads": "[{...}]",
"dns_records_count": 42,
"dns_mx_records": "alt1.aspmx.l.google.com, alt2.aspmx.l.google.com, alt3.aspmx.l.google.com, alt4.aspmx.l.google.com, aspmx.l.google.com",
"dns_has_mx": true,
"dns_mx_providers": "Google Workspace",
"dns_mx_is_valid": true,
"dns_spf_record": "v=spf1 include:_spf.hostedemail.com ~all",
"dns_has_spf": true,
"dns_spf_is_valid": true,
"dns_dmarc_record": "v=DMARC1; p=none; adkim=r; aspf=r;",
"dns_has_dmarc": true,
"dns_dmarc_is_valid": true,
"index_link_count": true,
"has_glassdoor": true,
"glassdoor_link": true,
"glassdoor_rating": true,
"glassdoor_reviews": true,
"has_facebook": true,
"facebook_link": "http://www.facebook.com/PageLink",
"facebook_likes": 12,
"facebook_followers": 150,
"facebook_rating": 7,
"facebook_reviews": 1200,
"has_instagram": true,
"instagram_link": "http://www.instagram.com/PageLink",
"instagram_likes": 12,
"instagram_followers": 150,
"instagram_posts": 5,
"score": 649,
"score_cluster": "very_high",
"registrar": "GoDaddy.com, LLC",
"registered_to": "John Doe",
"creation_date": "2020-01-02",
"expiration_date": "2026-01-02",
"updated_date": "2020-01-02",
"age": "1460"
}
The following fields can be found under the "domain" object
name | type |
---|---|
value | string The domain of the user provided during the API call Ex: example.com |
country_code | string Indicates the country code of the domain Ex: it |
website_exists | boolean Indicates if the domain exists or not Ex: true |
website_exists_taxonomy | string Indicates in which taxonomy the domain is categorized - TAXONOMY_WEBSITE_EXISTS: There is a website associated with this domain - TAXONOMY_WEBSITE_ERROR: The website associated with this domain is unreachable - TAXONOMY_REDIRECT: The website contains a redirection to another website - TAXONOMY_REDIRECT_TO_HTTPS: The website performs a redirect from the HTTP protocol to the HTTPS protocol - TAXONOMY_PARKED_DOMAIN: The domain is of the "parked" type - TAXONOMY_WEBSITE_HOSTING: The website is from a provider or hosting - TAXONOMY_NO_CONTENT: The website is empty - TAXONOMY_TIMEOUT: The website does not respond within an acceptable time Ex: TAXONOMY_WEBSITE_EXISTS Enum: TAXONOMY_WEBSITE_EXISTS,TAXONOMY_WEBSITE_ERROR,TAXONOMY_REDIRECT,TAXONOMY_REDIRECT_TO_HTTPS,TAXONOMY_PARKED_DOMAIN,TAXONOMY_WEBSITE_HOSTING,TAXONOMY_NO_CONTENT,TAXONOMY_TIMEOUT |
website_exists_ssl | boolean Indicates if the domain has an SSL certificate Ex: true |
internal_links_count | integer The count of links with the same domain inside the page Ex: 4 |
external_links_count | integer The count of links with external domain inside the page Ex: 8 |
internal_email_links_count | integer The count of email links with the same domain inside the page Ex: 15 |
external_email_links_count | integer The count of email links with external domain inside the page Ex: 16 |
internal_images_count | integer The count of image links with the same domain inside the page Ex: 23 |
external_images_count | integer The count of image links with external domain inside the page Ex: 42 |
page_size | integer Specifies the size, in bytes, of the web page corresponding to the domain Ex: 1057 |
has_linkedin | boolean Indicates if the domain has a Company on Linkedin corresponding to the domain Ex: 1057 |
linkedin_url | string The link to the Linkedin company corresponding to the domain Ex: https://www.linkedin.com/company/trustfull |
linkedin_follower_count | integer Specifies the number of follower of the Linkedin company corresponding to the domain Ex: 8089 |
linkedin_company_size | string Specifies the cluster size of the Linkedin company corresponding to the domain Ex: 10,50 |
linkedin_avg_articles_likes_count | integer The average count of articles of the Linkedin company corresponding to the domain Ex: 42 |
linkedin_first_article_date | string The first available article date of the Linkedin company corresponding to the domain Ex: 2024-12-04 |
linkedin_last_article_date | string The last available article date of the Linkedin company corresponding to the domain Ex: 2024-12-04 |
screenshot | string The domain website screenshot Ex: https://example.com/image.jpg |
has_ssl | boolean Indicates if the domain has an SSL certificate Ex: true |
ssl_is_valid | boolean Indicates if the SSL certificate is valid Ex: true |
ssl_valid_from | string The date from which the SSL certificate is valid Ex: 2024-12-04 |
ssl_valid_to | string The date until which the SSL certificate is valid Ex: 2024-12-04 |
ssl_issuer_organization | string The organization that issued the SSL certificate Ex: Let's Encrypt |
company_name | string The name of the company the user works for, contains the full name Ex: Apple |
company_description | string A verbose description description of the company associated with the domain Ex: Apple Inc. is an American... |
company_industry | string Indicates the industry/sector of the company using a standard taxonomy Ex: Internet Software & Services |
company_employees | integer Indicates the number of employees of the company Ex: 1750 |
company_founded | string Indicates the year when the company was founded Ex: 2014 |
company_keywords | string A list of keywords used in the company description Ex: smartphone,tech |
company_annual_revenue | integer int64 Indicates our proprietary estimated annual revenue range for company Ex: 17630000000 |
company_logo | string An url linking to the the logo of the company associated with the domain Ex: https://... |
company_country | string Indicates the country name of the company headquarter Ex: Italy |
company_twitter_url | string Provides a link to the company twitter account, links is always pointing to twitter domain Ex: https://... |
company_facebook_url | string Provides the Facebook url of the company, links is always pointing to facebook domain Ex: https://... |
company_linkedin_url | string Provides the Linkedin url of the company, links is always pointing to linkedin domain Ex: https://... |
company_total_funding | integer Provides the total amount of funding raised by company Ex: https://... |
company_tech_stack | string Indicates the set of technologies uses by the company Ex: JavaScript |
has_google_business | boolean Indicates if the domain has google business info Ex: true |
google_business_rating | integer Indicates the google business rating Ex: 4.5 |
google_business_review_count | integer Indicates the google business number of reviews Ex: 100 |
google_business_reviews | string Lists up to three most important reviews Ex: [{"summary":"Food is very good, staff is nice, quick service, good price.","link":"https://..."}] |
google_business_address | string Indicates the google business address Ex: 5th Avenue |
google_business_country | string Indicates the google business country Ex: Italy |
google_business_thumbnail | string Indicates the google business thumbnail Ex: https://... |
google_business_phone_number | string Indicates the google business phone number Ex: 393331234567 |
google_business_description | string Indicates the google business description Ex: A long description |
google_business_industry | string Indicates the google business industry type Ex: Information services in Milan, Italy |
google_business_status | string Indicates the google business status Ex: open |
google_business_hours | string Indicates the google business opening hours Ex: {"monday":"opens: 9 AM, closes: 6:30 PM","tuesday_christmas_eve":"opens: 9 AM, closes: 6:30 PMHours might differ","wednesday_christmas":"opens: 9 AM, closes: 6:30 PMHours might differ","thursday_saint_stephen_s_day":"opens: 9 AM, closes: 6:30 PMHours might differ","friday":"opens: 9 AM, closes: 6:30 PM","saturday":"opens: Closed","sunday":"opens: Closed"} |
has_google_ads | boolean Indicates if the domain has google advertisement Ex: true |
google_ads_days_since_last_shown | integer Represents the number of days that have passed since the most recent last shown date for Google Ads associated with the domain. Ex: 16 |
google_ads | string Json representation of the top 5 most recent last shown ads Ex: [{...}] |
dns_records_count | integer Indicates the number of dns records Ex: 42 |
dns_mx_records | string Indicates the mx records Ex: alt1.aspmx.l.google.com, alt2.aspmx.l.google.com, alt3.aspmx.l.google.com, alt4.aspmx.l.google.com, aspmx.l.google.com |
dns_has_mx | boolean Indicates whether the domain has mx records Ex: true |
dns_mx_providers | string Indicates the mx providers Ex: Google Workspace |
dns_mx_is_valid | boolean Indicates whether the domain mx records are valid Ex: true |
dns_spf_record | string Indicates the spf record Ex: v=spf1 include:_spf.hostedemail.com ~all |
dns_has_spf | boolean Indicates whether the domain has spf records Ex: true |
dns_spf_is_valid | boolean Indicates whether the domain spf records are valid Ex: true |
dns_dmarc_record | string Indicates the dmarc record Ex: v=DMARC1; p=none; adkim=r; aspf=r; |
dns_has_dmarc | boolean Indicates whether the domain has dmarc records Ex: true |
dns_dmarc_is_valid | boolean Indicates whether the domain dmarc records are valid Ex: true |
index_link_count | integer Indicate the number of pages that can be found in the major search engines Ex: true |
has_glassdoor | boolean Indicates whether the domain has Glassdoor Ex: true |
glassdoor_link | string Indicates the domain glassdoor link Ex: true |
glassdoor_rating | number float Indicates the domain glassdoor rating Ex: true |
glassdoor_reviews | integer Indicates the domain glassdoor reviews Ex: true |
has_facebook | boolean Indicates whether the domain has Facebook Ex: true |
facebook_link | string Indicates the domain facebook link Ex: http://www.facebook.com/PageLink |
facebook_likes | number float Indicates the domain facebook likes Ex: 12 |
facebook_followers | number float Indicates the domain facebook followers Ex: 150 |
facebook_rating | number float Indicates the domain facebook rating Ex: 7 |
facebook_reviews | integer Indicates the domain facebook reviews Ex: 1200 |
has_instagram | boolean Indicates whether the domain has Instagram Ex: true |
instagram_link | string Indicates the domain instagram link Ex: http://www.instagram.com/PageLink |
instagram_likes | integer Indicates the domain instagram likes Ex: 12 |
instagram_followers | integer Indicates the domain instagram followers Ex: 150 |
instagram_posts | integer Indicates the domain instagram posts Ex: 5 |
score | integer A number ranging from 0 to 1000 represents the quality of the domain information detected Ex: 649 |
score_cluster | string A cluster summarizing the quality of the domain provided Ex: very_high Enum: very_low,low,review,high,very_high |
registrar | string Specifies the name of the registrar that manages the domain registration Ex: GoDaddy.com, LLC |
registered_to | string Indicates the name of the entity or individual who registered the domain Ex: John Doe |
creation_date | string Specifies the date when the domain was first registered Ex: 2020-01-02 |
expiration_date | string Indicates the date when the domain registration will expire unless renewed Ex: 2026-01-02 |
updated_date | string Specifies the last update date of the domain's registration details. Ex: 2020-01-02 |
age | integer Represents the number of days since the domain was registered. Ex: 1460 |