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

nametype
valuestring

The domain of the user provided during the API call

Ex: example.com
country_codestring

Indicates the country code of the domain

Ex: it
website_existsboolean

Indicates if the domain exists or not

Ex: true
website_exists_taxonomystring

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_sslboolean

Indicates if the domain has an SSL certificate

Ex: true
internal_links_countinteger

The count of links with the same domain inside the page

Ex: 4
external_links_countinteger

The count of links with external domain inside the page

Ex: 8
internal_email_links_countinteger

The count of email links with the same domain inside the page

Ex: 15
external_email_links_countinteger

The count of email links with external domain inside the page

Ex: 16
internal_images_countinteger

The count of image links with the same domain inside the page

Ex: 23
external_images_countinteger

The count of image links with external domain inside the page

Ex: 42
page_sizeinteger

Specifies the size, in bytes, of the web page corresponding to the domain

Ex: 1057
has_linkedinboolean

Indicates if the domain has a Company on Linkedin corresponding to the domain

Ex: 1057
linkedin_urlstring

The link to the Linkedin company corresponding to the domain

Ex: https://www.linkedin.com/company/trustfull
linkedin_follower_countinteger

Specifies the number of follower of the Linkedin company corresponding to the domain

Ex: 8089
linkedin_company_sizestring

Specifies the cluster size of the Linkedin company corresponding to the domain

Ex: 10,50
linkedin_avg_articles_likes_countinteger

The average count of articles of the Linkedin company corresponding to the domain

Ex: 42
linkedin_first_article_datestring

The first available article date of the Linkedin company corresponding to the domain

Ex: 2024-12-04
linkedin_last_article_datestring

The last available article date of the Linkedin company corresponding to the domain

Ex: 2024-12-04
screenshotstring

The domain website screenshot

Ex: https://example.com/image.jpg
has_sslboolean

Indicates if the domain has an SSL certificate

Ex: true
ssl_is_validboolean

Indicates if the SSL certificate is valid

Ex: true
ssl_valid_fromstring

The date from which the SSL certificate is valid

Ex: 2024-12-04
ssl_valid_tostring

The date until which the SSL certificate is valid

Ex: 2024-12-04
ssl_issuer_organizationstring

The organization that issued the SSL certificate

Ex: Let's Encrypt
company_namestring

The name of the company the user works for, contains the full name

Ex: Apple
company_descriptionstring

A verbose description description of the company associated with the domain

Ex: Apple Inc. is an American...
company_industrystring

Indicates the industry/sector of the company using a standard taxonomy

Ex: Internet Software & Services
company_employeesinteger

Indicates the number of employees of the company

Ex: 1750
company_foundedstring

Indicates the year when the company was founded

Ex: 2014
company_keywordsstring

A list of keywords used in the company description

Ex: smartphone,tech
company_annual_revenueinteger int64

Indicates our proprietary estimated annual revenue range for company

Ex: 17630000000
company_logostring

An url linking to the the logo of the company associated with the domain

Ex: https://...
company_countrystring

Indicates the country name of the company headquarter

Ex: Italy
company_twitter_urlstring

Provides a link to the company twitter account, links is always pointing to twitter domain

Ex: https://...
company_facebook_urlstring

Provides the Facebook url of the company, links is always pointing to facebook domain

Ex: https://...
company_linkedin_urlstring

Provides the Linkedin url of the company, links is always pointing to linkedin domain

Ex: https://...
company_total_fundinginteger

Provides the total amount of funding raised by company

Ex: https://...
company_tech_stackstring

Indicates the set of technologies uses by the company

Ex: JavaScript
has_google_businessboolean

Indicates if the domain has google business info

Ex: true
google_business_ratinginteger

Indicates the google business rating

Ex: 4.5
google_business_review_countinteger

Indicates the google business number of reviews

Ex: 100
google_business_reviewsstring

Lists up to three most important reviews

Ex: [{"summary":"Food is very good, staff is nice, quick service, good price.","link":"https://..."}]
google_business_addressstring

Indicates the google business address

Ex: 5th Avenue
google_business_countrystring

Indicates the google business country

Ex: Italy
google_business_thumbnailstring

Indicates the google business thumbnail

Ex: https://...
google_business_phone_numberstring

Indicates the google business phone number

Ex: 393331234567
google_business_descriptionstring

Indicates the google business description

Ex: A long description
google_business_industrystring

Indicates the google business industry type

Ex: Information services in Milan, Italy
google_business_statusstring

Indicates the google business status

Ex: open
google_business_hoursstring

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_adsboolean

Indicates if the domain has google advertisement

Ex: true
google_ads_days_since_last_showninteger

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_adsstring

Json representation of the top 5 most recent last shown ads

Ex: [{...}]
dns_records_countinteger

Indicates the number of dns records

Ex: 42
dns_mx_recordsstring

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_mxboolean

Indicates whether the domain has mx records

Ex: true
dns_mx_providersstring

Indicates the mx providers

Ex: Google Workspace
dns_mx_is_validboolean

Indicates whether the domain mx records are valid

Ex: true
dns_spf_recordstring

Indicates the spf record

Ex: v=spf1 include:_spf.hostedemail.com ~all
dns_has_spfboolean

Indicates whether the domain has spf records

Ex: true
dns_spf_is_validboolean

Indicates whether the domain spf records are valid

Ex: true
dns_dmarc_recordstring

Indicates the dmarc record

Ex: v=DMARC1; p=none; adkim=r; aspf=r;
dns_has_dmarcboolean

Indicates whether the domain has dmarc records

Ex: true
dns_dmarc_is_validboolean

Indicates whether the domain dmarc records are valid

Ex: true
index_link_countinteger

Indicate the number of pages that can be found in the major search engines

Ex: true
has_glassdoorboolean

Indicates whether the domain has Glassdoor

Ex: true
glassdoor_linkstring

Indicates the domain glassdoor link

Ex: true
glassdoor_ratingnumber float

Indicates the domain glassdoor rating

Ex: true
glassdoor_reviewsinteger

Indicates the domain glassdoor reviews

Ex: true
has_facebookboolean

Indicates whether the domain has Facebook

Ex: true
facebook_linkstring

Indicates the domain facebook link

Ex: http://www.facebook.com/PageLink
facebook_likesnumber float

Indicates the domain facebook likes

Ex: 12
facebook_followersnumber float

Indicates the domain facebook followers

Ex: 150
facebook_ratingnumber float

Indicates the domain facebook rating

Ex: 7
facebook_reviewsinteger

Indicates the domain facebook reviews

Ex: 1200
has_instagramboolean

Indicates whether the domain has Instagram

Ex: true
instagram_linkstring

Indicates the domain instagram link

Ex: http://www.instagram.com/PageLink
instagram_likesinteger

Indicates the domain instagram likes

Ex: 12
instagram_followersinteger

Indicates the domain instagram followers

Ex: 150
instagram_postsinteger

Indicates the domain instagram posts

Ex: 5
scoreinteger

A number ranging from 0 to 1000 represents the quality of the domain information detected

Ex: 649
score_clusterstring

A cluster summarizing the quality of the domain provided

Ex: very_high

Enum: very_low,low,review,high,very_high
registrarstring

Specifies the name of the registrar that manages the domain registration

Ex: GoDaddy.com, LLC
registered_tostring

Indicates the name of the entity or individual who registered the domain

Ex: John Doe
creation_datestring

Specifies the date when the domain was first registered

Ex: 2020-01-02
expiration_datestring

Indicates the date when the domain registration will expire unless renewed

Ex: 2026-01-02
updated_datestring

Specifies the last update date of the domain's registration details.

Ex: 2020-01-02
ageinteger

Represents the number of days since the domain was registered.

Ex: 1460
Language
URL
Click Try It! to start a request and see the response here!