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": 32500000,
    "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": "[{...}]",
    "score": 649,
    "score_cluster": "very_high"
}

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 Indicates our proprietary estimated annual revenue range for company Ex: 32500000
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: [{...}]
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