---
updatedAt: 2026-11-06T17:16:35.000Z
agentTools:
projectIndex: https://docs.trustfull.com/llms.txt
---
# Trustfull Domain
Trustfull Domain
Get the data of a previously enriched domain using the customerId.
To use this API, you must first initiate a request to the [Domain Intelligence API](https://docs.trustfull.com/reference/trustfull-domain-intelligence).
This initial call starts the enrichment and decoration process for the specified domain.
Once the process has started, you can use this API to retrieve the results. If the decoration is not yet complete, the endpoint will return a response with a status of processing:
```json
{
"status": "processing",
"message": "The request is still being processed"
}
```
When the decoration is complete, the API returns the enriched data.
## Response
Following an example of the response:
```json
{
"resolution_id": "...",
"customer_id": "...",
"model_id": "...",
"device_request_time": "...",
"claims": [
"domain"
],
"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": true,
"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_favicon": true,
"favicon_link": "https://assets.trustfull.com/favicons/ab/cd/abcdef.png",
"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_company": "Trustfull",
"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",
"is_suspicious_registrar": false,
"registered_to": "John Doe",
"creation_date": "2020-01-02",
"expiration_date": "2026-01-02",
"updated_date": "2020-01-02",
"age": "1460",
"registrant_disclosed": true,
"whois_data": "{\"registrant\": {\"name\": \"John Doe\", \"organization\": \"Example Inc.\", \"email\": \"john@example.com\"}, \"technical_contact\": {\"name\": \"Jane Smith\", \"email\": \"tech@example.com\"}, \"administrative_contact\": {\"name\": \"Admin Team\", \"email\": \"admin@example.com\"}}",
"technologies": "[{\"name\":\"AWS Certificate Manager\",\"category\":\"SSL\\/TLS certificate authorities\"}]",
"technologies_count": "0",
"technologies_is_only_adv": "false",
"technologies_are_enterprise": "false",
"website_contents_emails": "info@example.com",
"website_contents_has_free_email": true,
"website_contents_phone_numbers": "+39 011 1234567",
"website_contents_address": "Via Roma 1, 10121 Torino, Italy",
"website_contents_vat_code": "IT12345678901",
"website_contents_company_name": "Example S.p.A.",
"website_contents_language_code": "it",
"website_contents_language_country": "IT",
"website_contents_social_links": "{\"facebook\": \"https://www.facebook.com/example\"}",
"website_contents_privacy_policy_url": "https://www.example.com/privacy-policy",
"website_contents_terms_and_conditions_url": "https://www.example.com/terms-and-conditions",
"website_contents_contacts_url": "https://www.example.com/contact",
"website_contents_description": "This website provides and example of a website.",
"website_contents_tier1": "TECHNOLOGY_AND_COMPUTING",
"website_contents_tier2": "TECHNOLOGY_AND_COMPUTING",
"website_contents_tier3": "TECHNOLOGY_AND_COMPUTING",
"social_links_max_followers": "10",
"has_trustpilot": true,
"trustpilot_url": "https://www.trustpilot.com/review/example.com",
"trustpilot_description": "Example Company is a leading provider of innovative solutions.",
"trustpilot_rating": 4,
"trustpilot_address": "123 Example Street, Example City, EX 12345",
"trustpilot_phone_number": "+1 234-567-8900",
"trustpilot_email": "email@example.com",
"trustpilot_reviews_count": 150,
"trustpilot_reviews": "[{\"author\": \"John Doe\", \"rating\": 5, \"date\": \"2024-12-04\", \"content\": \"Great service!\"}, {\"author\": \"Jane Smith\", \"rating\": 4, \"date\": \"2024-12-05\", \"content\": \"Very satisfied!\"}, {\"author\": \"Alice Johnson\", \"rating\": 3, \"date\": \"2024-12-06\", \"content\": \"Good, but could be better.\"}, {\"author\": \"Bob Brown\", \"rating\": 2, \"date\": \"2024-12-07\", \"content\": \"Not what I expected.\"}, {\"author\": \"Charlie White\", \"rating\": 1, \"date\": \"2024-12-08\", \"content\": \"Very disappointed.\"}]",
"trustpilot_is_suspicious": false,
"trustpilot_is_claimed": true,
"privacy_policy_exists": "true",
"terms_and_conditions_exists": "true",
"backlinks_count": "10",
"backlinks_count_seo": 10,
"backlinks_referring_domains": 5,
"backlinks_referring_ips": 3,
"backlinks_score": 75,
"semrush_score": 60,
"backlinks_from_a": 12,
"backlinks_from_form": 2,
"backlinks_from_frame": 1,
"backlinks_from_image": 4,
"privacy_policy_content_path": "s3://bucket-name/path/to/privacy_policy.html",
"terms_and_conditions_content_path": "s3://bucket-name/path/to/terms_and_conditions.html",
"privacy_policy_found": true,
"privacy_policy_has_clear_language": true,
"privacy_policy_specifies_company_identity": true,
"privacy_policy_specifies_contact_information": true,
"privacy_policy_specifies_data_collection": true,
"privacy_policy_specifies_data_sharing": true,
"privacy_policy_is_gdpr_compliant": true,
"privacy_policy_has_data_controller": true,
"privacy_policy_has_cookie_policy": true,
"privacy_policy_is_generic": true,
"privacy_policy_with_unrealistic_promises": true,
"terms_and_conditions_found": true,
"terms_and_conditions_has_clear_language": true,
"terms_and_conditions_specifies_company_identity": true,
"terms_and_conditions_specifies_contact_information": true,
"terms_and_conditions_document_is_specific": true,
"terms_and_conditions_with_contradictions": true,
"terms_and_conditions_with_external_incoherent_references": true,
"terms_and_conditions_with_data_protection": true,
"is_enterprise": "false",
"website_contents_is_ecommerce": true,
"website_contents_has_unmodified_template_content": false,
"website_uses_third_party_platform_domain": true,
"website_third_party_platform_domain": "square.site",
"website_third_party_platform_type": "food"
}
}
```
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 |
| website\_redirect | ?string
**DEPRECATED** Indicates the domain redirect type
Ex: HTTPS\_REDIRECT |
| website\_redirect\_to | ?string
**DEPRECATED** Indicates the domain redirect URL
Ex: |
| 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: true |
| linkedin\_url | ?string
The link to the Linkedin company corresponding to the domain
Ex: |
| 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: |
| has\_favicon | ?boolean
Indicates whether the domain website exposes its own favicon
Ex: true |
| favicon\_link | ?string
The link to the favicon downloaded from the domain website
Ex: |
| 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\_company | ?string
Indicates the google business company name
Ex: Trustfull |
| 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: |
| 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: |
| 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 |
| is\_suspicious\_registrar | ?boolean
Indicates if the domain registrar is known for hosting low-trust domains.
Ex: false |
| 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 |
| registrant\_disclosed | ?boolean
Indicates whether the registrant's name or organization is disclosed in the WHOIS record.
Ex: true |
| whois\_data | ?string
A JSON representation of WHOIS information, structured with three top-level objects: "registrant", "administrative\_contact", and "technical\_contact". Each object may contain variable data structure representing various identity and contact details.
Ex: \{"registrant": \{"name": "John Doe", "organization": "Example Inc.", "email": ""}, "technical\_contact": \{"name": "Jane Smith", "email": ""}, "administrative\_contact": \{"name": "Admin Team", "email": ""}} |
| technologies | ?string
A JSON representation of a list of technologies associated to the given domain, each object of the list has a "name" and a "category".
Ex: \[\{"name":"AWS Certificate Manager","category":"SSL\\/TLS certificate authorities"}] |
| technologies\_count | ?integer
The number of technologies associated to the given domain website.
Ex: 0 |
| technologies\_is\_only\_adv | ?boolean
A flag indicating whether in the associated domain website there are only advertising technologies, which is strange for a commercial website.
Ex: false |
| technologies\_are\_enterprise | ?boolean
A flag indicating whether in the associated domain website there are enough enterprise technologies.
Ex: false |
| website\_contents\_emails | ?string
A string containing one or more email addresses extracted from the website contents.
Ex: |
| website\_contents\_has\_free\_email | ?boolean
Indicates whether at least one email address published on the website belongs to a free email provider, such as Gmail.
Ex: true |
| website\_contents\_phone\_numbers | ?string
A string containing one or more phone numbers extracted from the website contents.
Ex: +39 011 1234567 |
| website\_contents\_address | ?string
A string containing the physical address found on the website.
Ex: Via Roma 1, 10121 Torino, Italy |
| website\_contents\_vat\_code | ?string
The VAT identification number found on the website.
Ex: IT12345678901 |
| website\_contents\_company\_name | ?string
The company name found on the website.
Ex: Example S.p.A. |
| website\_contents\_language\_code | ?string
The ISO 639-1 language code of the website content.
Ex: it |
| website\_contents\_language\_country | ?string
The ISO 3166-1 alpha-2 country code associated with the website language.
Ex: IT |
| website\_contents\_social\_links | ?string
A JSON representation of the list of social media profile URLs found on the website.
Ex: \{"facebook": "; |
| website\_contents\_privacy\_policy\_url | ?string
The URL pointing to the website's privacy policy page.
Ex: |
| website\_contents\_terms\_and\_conditions\_url | ?string
The URL pointing to the website's terms and conditions page.
Ex: |
| website\_contents\_contacts\_url | ?string
The URL pointing to the contact page of the website.
Ex: |
| website\_contents\_description | ?string
A summary of website' content.
Ex: This website provides and example of a website. |
| website\_contents\_tier1 | ?string
A tier 1 classification of the website scope.
Ex: TECHNOLOGY\_AND\_COMPUTING |
| website\_contents\_tier2 | ?string
A tier 2 classification of the website scope.
Ex: TECHNOLOGY\_AND\_COMPUTING |
| website\_contents\_tier3 | ?string
A tier 3 classification of the website scope.
Ex: TECHNOLOGY\_AND\_COMPUTING |
| social\_links\_max\_followers | ?integer
The maximum number of followers across the social links
Ex: 10 |
| has\_trustpilot | ?boolean
Indicates whether the domain has a Trustpilot profile
Ex: true |
| trustpilot\_url | ?string
The URL of the Trustpilot profile for the domain
Ex: |
| trustpilot\_description | ?string
A brief description of the company as listed on Trustpilot
Ex: Example Company is a leading provider of innovative solutions. |
| trustpilot\_rating | ?integer
The average rating of the company on Trustpilot
Ex: 4 |
| trustpilot\_address | ?string
The address of the company as listed on Trustpilot
Ex: 123 Example Street, Example City, EX 12345 |
| trustpilot\_phone\_number | ?string
The phone number of the company as listed on Trustpilot
Ex: +1 234-567-8900 |
| trustpilot\_email | ?string
The email address of the company as listed on Trustpilot
Ex: |
| trustpilot\_reviews\_count | ?integer
The number of reviews the company has on Trustpilot
Ex: 150 |
| trustpilot\_reviews | ?string
A JSON representation of the reviews for the company on Trustpilot
Ex: \[\{"author": "John Doe", "rating": 5, "date": "2024-12-04", "content": "Great service!"}, \{"author": "Jane Smith", "rating": 4, "date": "2024-12-05", "content": "Very satisfied!"}, \{"author": "Alice Johnson", "rating": 3, "date": "2024-12-06", "content": "Good, but could be better."}, \{"author": "Bob Brown", "rating": 2, "date": "2024-12-07", "content": "Not what I expected."}, \{"author": "Charlie White", "rating": 1, "date": "2024-12-08", "content": "Very disappointed."}] |
| trustpilot\_is\_suspicious | ?boolean
Indicates whether the Trustpilot profile is considered suspicious
Ex: false |
| trustpilot\_is\_claimed | ?boolean
Indicates whether the Trustpilot profile is claimed by the company
Ex: true |
| privacy\_policy\_exists | ?boolean
A flag explaining if the domain website has a privacy policy
Ex: true |
| terms\_and\_conditions\_exists | ?boolean
A flag explaining if the domain website has a terms and condition policy
Ex: true |
| backlinks\_count | ?integer
A number explaining how many backlinks a domain has
Ex: 10 |
| backlinks\_count\_seo | ?integer
Total number of backlinks discovered by SEO tools
Ex: 10 |
| backlinks\_referring\_domains | ?integer
Number of unique domains that link to the analyzed domain.
Ex: 5 |
| backlinks\_referring\_ips | ?integer
Total number of unique IP addresses from which backlinks originate.
Ex: 3 |
| backlinks\_score | ?integer
A general quality score of the backlink profile
Ex: 75 |
| semrush\_score | ?integer
Proprietary domain authority, based on the quality, quantity, and influence of backlinks.
Ex: 60 |
| backlinks\_from\_a | ?integer
Number of backlinks found in anchor text elements within regular content.
Ex: 12 |
| backlinks\_from\_form | ?integer
Number of backlinks embedded in HTML form elements.
Ex: 2 |
| backlinks\_from\_frame | ?integer
Number of backlinks found inside iframe or similar frame-based structures.
Ex: 1 |
| backlinks\_from\_image | ?integer
Number of backlinks originating from image tags.
Ex: 4 |
| privacy\_policy\_content\_path | ?string
The S3 link to the privacy policy page content.
Ex: s3://bucket-name/path/to/privacy\_policy.html |
| terms\_and\_conditions\_content\_path | ?string
The S3 link to the terms and conditions page content.
Ex: s3://bucket-name/path/to/terms\_and\_conditions.html |
| privacy\_policy\_found | ?boolean
A flag indicating whether the privacy policy has been found.
Ex: true |
| privacy\_policy\_has\_clear\_language | ?boolean
A flag indicating whether the privacy policy document is written in clear, plain language, avoiding legal and technical jargon to ensure that it is easily understandable for all users, regardless of their technical or legal expertise.
Ex: true |
| privacy\_policy\_specifies\_company\_identity | ?boolean
A flag indicating whether the privacy policy document clearly identifies the company, specifying its full legal name and legal status, which is essential for transparency.
Ex: true |
| privacy\_policy\_specifies\_contact\_information | ?boolean
A flag indicating whether the privacy policy document specifies valid contact information, enabling users to submit inquiries or exercise their legal rights.
Ex: true |
| privacy\_policy\_specifies\_data\_collection | ?boolean
A flag indicating whether the privacy policy document specifies the types of data collected, the methods of collection, the purposes of processing, and the legal basis for that processing.
Ex: true |
| privacy\_policy\_specifies\_data\_sharing | ?boolean
A flag indicating whether the privacy policy document clearly explains how and with which third parties user data is shared, outlining any legal limitations and their specific usage rights.
Ex: true |
| privacy\_policy\_is\_gdpr\_compliant | ?boolean
A flag indicating whether the privacy policy document adheres to GDPR regulations.
Ex: true |
| privacy\_policy\_has\_data\_controller | ?boolean
A flag indicating whether the privacy policy document identifies the data controller, which is the entity responsible for determining the purposes and means of the processing of personal data.
Ex: true |
| privacy\_policy\_has\_cookie\_policy | ?boolean
A flag indicating whether the privacy policy document includes a specific cookie policy that explains the use of tracking technologies, the types of cookies used, and how users can manage their preferences.
Ex: true |
| privacy\_policy\_is\_generic | ?boolean
A flag indicating whether the privacy policy document is too generic and lacks the specific details required to demonstrate it has been customized to the company’s unique data processing activities.
Ex: true |
| privacy\_policy\_with\_unrealistic\_promises | ?boolean
A flag indicating whether the privacy policy document contains unrealistic or misleading claims, such as guaranteeing absolute data security or promising that user data will never be shared under any circumstances.
Ex: true |
| terms\_and\_conditions\_found | ?boolean
A flag indicating whether the terms and conditions document has been found.
Ex: true |
| terms\_and\_conditions\_has\_clear\_language | ?boolean
A flag indicating whether the terms and conditions document is written in clear, plain language, avoiding legal and technical jargon to ensure that it is easily understandable for all users, regardless of their technical or legal expertise.
Ex: true |
| terms\_and\_conditions\_specifies\_company\_identity | ?boolean
A flag that indicates whether the terms and conditions document explicitly includes company-related information, such as the company’s legal name, registered address, identification number, or other official business details
Ex: true |
| terms\_and\_conditions\_specifies\_contact\_information | ?boolean
A flag indicating whether the terms and conditions document specifies valid contact information, enabling users to submit inquiries or exercise their legal rights.
Ex: true |
| terms\_and\_conditions\_document\_is\_specific | ?boolean
A flag indicating whether the terms and conditions document is sufficiently specific and tailored to the company’s services, rather than a generic template that fails to clearly outline the rights and obligations of both parties.
Ex: true |
| terms\_and\_conditions\_with\_contradictions | ?boolean
A flag indicating whether the terms and conditions document contains internal contradictions or inconsistencies that create ambiguity and could make the terms difficult to interpret or legally unenforceable.
Ex: true |
| terms\_and\_conditions\_with\_external\_incoherent\_references | ?boolean
A flag indicating whether the terms and conditions document contains suspicious or misleading external references, which could be a signal for a scam or a deceptive practice by preventing users from verifying the company's claims.
Ex: true |
| terms\_and\_conditions\_with\_data\_protection | ?boolean
A flag indicating whether the terms and conditions document specifies how personal data is protected and secured, referring to details which specify company's security measures and user rights.
Ex: true |
| is\_enterprise | ?boolean
A flag indicating whether in the associated domain website is enough complete to be considered enterprise
Ex: false |
| website\_contents\_is\_ecommerce | ?boolean
True when the domain website is an ecommerce platform selling physical or digital goods or services online
Ex: true |
| website\_contents\_has\_unmodified\_template\_content | ?boolean
True when the website uses an unchanged starter template or contains template text or data that has not been replaced; null when uncertain.
Ex: false |
| website\_uses\_third\_party\_platform\_domain | ?boolean
True when the website uses a domain belonging to a third-party platform, such as square.site, so the registration data describes the platform rather than the customer.
Ex: true |
| website\_third\_party\_platform\_domain | ?string
The third-party platform domain used by the website, such as square.site or site123.me; null when the customer owns the domain.
Ex: square.site |
| website\_third\_party\_platform\_type | ?string
The category of the third-party platform the website uses; null when unknown.
Ex: food
Enum: general,booking,beauty,food,hospitality,ecommerce,healthcare,events,automotive |
### Status Codes
| Code | Type | Description |
| :--- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 | - | The request was successfully executed and the operation was successful |
| 202 | - | The request is still being processed |
| 403 | CLIENT | The request was not processed because there was an issue with the authentication |
| 404 | CLIENT | The requested resource could not be found. This can happen if the `customer_id` does not exist. |
| 401 | CLIENT | This may happen if you correctly populated the API key field but the key is either incorrect or not enabled. |
| 429 | CLIENT | Indicates the user has sent too many requests in a given amount of time |
| 500 | SERVER | This is a generic error indicating a server-side problem. |
| 504 | SERVER | Gateway timeout, the server took too much time to response and closed the connection. In most cases is safe to retry this kind of transaction |
# OpenAPI definition
```json
{
"openapi": "3.0.0",
"info": {
"title": "PRODUCTS",
"description": "Hub is the main entry point for the API, it is used to retrieve data from the system",
"version": "1.0"
},
"servers": [
{
"url": "https://api.fido.id/{version}",
"description": "Production",
"variables": {
"version": {
"enum": [
"1.0"
],
"default": "1.0"
}
}
}
],
"paths": {
"/domain-intelligence/{customerId}": {
"get": {
"tags": [
"Products"
],
"summary": "Trustfull Domain",
"description": "Trustfull Domain",
"operationId": "get-domain-api",
"parameters": [
{
"$ref": "#/components/parameters/content-type"
},
{
"$ref": "#/components/parameters/accept"
},
{
"$ref": "#/components/parameters/x-api-key"
},
{
"name": "customerId",
"in": "path",
"required": true,
"schema": {
"type": "string",
"example": "customer_id_393494108457"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetDomainResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"GetDomainResponsePayload": {
"title": "Domain block payload",
"description": "Domain block of GetDomainResponse",
"properties": {
"agent_id": {
"description": "The id of the agent that scheduled this lookup, absent on a manual one",
"type": "string",
"example": "8c05e164d1ea0c1e8ca626ee429c1028",
"nullable": true
},
"value": {
"description": "The domain of the user provided during the API call",
"type": "string",
"example": "example.com",
"nullable": true
},
"country_code": {
"description": "Indicates the country code of the domain",
"type": "string",
"example": "it",
"nullable": true
},
"website_exists": {
"description": "Indicates if the domain exists or not",
"type": "boolean",
"example": true,
"nullable": true
},
"website_exists_taxonomy": {
"description": "Indicates in which taxonomy the domain is categorized\n- **TAXONOMY_WEBSITE_EXISTS:** There is a website associated with this domain\n- **TAXONOMY_WEBSITE_ERROR:** The website associated with this domain is unreachable\n- **TAXONOMY_REDIRECT:** The website contains a redirection to another website\n- **TAXONOMY_REDIRECT_TO_HTTPS:** The website performs a redirect from the HTTP protocol to the HTTPS protocol\n- **TAXONOMY_PARKED_DOMAIN:** The domain is of the \"parked\" type\n- **TAXONOMY_WEBSITE_HOSTING:** The website is from a provider or hosting\n- **TAXONOMY_NO_CONTENT:** The website is empty\n- **TAXONOMY_TIMEOUT:** The website does not respond within an acceptable time",
"type": "string",
"enum": [
"TAXONOMY_WEBSITE_EXISTS",
"TAXONOMY_WEBSITE_ERROR",
"TAXONOMY_REDIRECT",
"TAXONOMY_REDIRECT_TO_HTTPS",
"TAXONOMY_PARKED_DOMAIN",
"TAXONOMY_WEBSITE_HOSTING",
"TAXONOMY_NO_CONTENT",
"TAXONOMY_TIMEOUT"
],
"example": "TAXONOMY_WEBSITE_EXISTS",
"nullable": true
},
"website_exists_ssl": {
"description": "Indicates if the domain has an SSL certificate",
"type": "boolean",
"example": true,
"nullable": true
},
"website_redirect": {
"description": "**DEPRECATED** Indicates the domain redirect type",
"type": "string",
"example": "HTTPS_REDIRECT",
"nullable": true
},
"website_redirect_to": {
"description": "**DEPRECATED** Indicates the domain redirect URL",
"type": "string",
"example": "https://example.com",
"nullable": true
},
"internal_links_count": {
"description": "The count of links with the same domain inside the page",
"type": "integer",
"example": 4,
"nullable": true
},
"external_links_count": {
"description": "The count of links with external domain inside the page",
"type": "integer",
"example": 8,
"nullable": true
},
"internal_email_links_count": {
"description": "The count of email links with the same domain inside the page",
"type": "integer",
"example": 15,
"nullable": true
},
"external_email_links_count": {
"description": "The count of email links with external domain inside the page",
"type": "integer",
"example": 16,
"nullable": true
},
"internal_images_count": {
"description": "The count of image links with the same domain inside the page",
"type": "integer",
"example": 23,
"nullable": true
},
"external_images_count": {
"description": "The count of image links with external domain inside the page",
"type": "integer",
"example": 42,
"nullable": true
},
"page_size": {
"description": "Specifies the size, in bytes, of the web page corresponding to the domain",
"type": "integer",
"example": 1057,
"nullable": true
},
"has_linkedin": {
"description": "Indicates if the domain has a Company on Linkedin corresponding to the domain",
"type": "boolean",
"example": true,
"nullable": true
},
"linkedin_url": {
"description": "The link to the Linkedin company corresponding to the domain",
"type": "string",
"example": "https://www.linkedin.com/company/trustfull",
"nullable": true
},
"linkedin_follower_count": {
"description": "Specifies the number of follower of the Linkedin company corresponding to the domain",
"type": "integer",
"example": 8089,
"nullable": true
},
"linkedin_avg_articles_likes_count": {
"description": "The average count of articles of the Linkedin company corresponding to the domain",
"type": "integer",
"example": 42,
"nullable": true
},
"linkedin_first_article_date": {
"description": "The first available article date of the Linkedin company corresponding to the domain",
"type": "string",
"example": "2024-12-04",
"nullable": true
},
"linkedin_last_article_date": {
"description": "The last available article date of the Linkedin company corresponding to the domain",
"type": "string",
"example": "2024-12-04",
"nullable": true
},
"linkedin_company_size": {
"description": "Specifies the cluster size of the Linkedin company corresponding to the domain",
"type": "string",
"example": "10,50",
"nullable": true
},
"screenshot": {
"description": "The domain website screenshot",
"type": "string",
"example": "https://example.com/image.jpg",
"nullable": true
},
"has_favicon": {
"description": "Indicates whether the domain website exposes its own favicon",
"type": "boolean",
"example": true,
"nullable": true
},
"favicon_link": {
"description": "The link to the favicon downloaded from the domain website",
"type": "string",
"example": "https://assets.trustfull.com/favicons/ab/cd/abcdef.png",
"nullable": true
},
"has_ssl": {
"description": "Indicates if the domain has an SSL certificate",
"type": "boolean",
"example": true,
"nullable": true
},
"ssl_is_valid": {
"description": "Indicates if the SSL certificate is valid",
"type": "boolean",
"example": true,
"nullable": true
},
"ssl_valid_from": {
"description": "The date from which the SSL certificate is valid",
"type": "string",
"example": "2024-12-04",
"nullable": true
},
"ssl_valid_to": {
"description": "The date until which the SSL certificate is valid",
"type": "string",
"example": "2024-12-04",
"nullable": true
},
"ssl_issuer_organization": {
"description": "The organization that issued the SSL certificate",
"type": "string",
"example": "Let's Encrypt",
"nullable": true
},
"company_name": {
"description": "The name of the company the user works for, contains the full name",
"type": "string",
"example": "Apple",
"nullable": true
},
"company_description": {
"description": "A verbose description description of the company associated with the domain",
"type": "string",
"example": "Apple Inc. is an American...",
"nullable": true
},
"company_industry": {
"description": "Indicates the industry/sector of the company using a standard taxonomy",
"type": "string",
"example": "Internet Software & Services",
"nullable": true
},
"company_employees": {
"description": "Indicates the number of employees of the company",
"type": "integer",
"example": 1750,
"nullable": true
},
"company_founded": {
"description": "Indicates the year when the company was founded",
"type": "string",
"example": 2014,
"nullable": true
},
"company_keywords": {
"description": "A list of keywords used in the company description",
"type": "string",
"example": "smartphone,tech",
"nullable": true
},
"company_annual_revenue": {
"description": "Indicates our proprietary estimated annual revenue range for company",
"type": "integer",
"format": "int64",
"example": 17630000000
},
"company_logo": {
"description": "An url linking to the the logo of the company associated with the domain ",
"type": "string",
"example": "https://...",
"nullable": true
},
"company_country": {
"description": "Indicates the country name of the company headquarter",
"type": "string",
"example": "Italy",
"nullable": true
},
"company_twitter_url": {
"description": "Provides a link to the company twitter account, links is always pointing to twitter domain",
"type": "string",
"example": "https://...",
"nullable": true
},
"company_facebook_url": {
"description": "Provides the Facebook url of the company, links is always pointing to facebook domain",
"type": "string",
"example": "https://...",
"nullable": true
},
"company_linkedin_url": {
"description": "Provides the Linkedin url of the company, links is always pointing to linkedin domain",
"type": "string",
"example": "https://...",
"nullable": true
},
"company_total_funding": {
"description": "Provides the total amount of funding raised by company",
"type": "integer",
"example": "https://...",
"nullable": true
},
"company_tech_stack": {
"description": "Indicates the set of technologies uses by the company",
"type": "string",
"example": "JavaScript",
"nullable": true
},
"has_google_business": {
"description": "Indicates if the domain has google business info",
"type": "boolean",
"example": true,
"nullable": true
},
"google_business_company": {
"description": "Indicates the google business company name",
"type": "string",
"example": "Trustfull",
"nullable": true
},
"google_business_rating": {
"description": "Indicates the google business rating",
"type": "number",
"format": "float",
"example": 4.5,
"nullable": true
},
"google_business_review_count": {
"description": "Indicates the google business number of reviews",
"type": "integer",
"example": 100,
"nullable": true
},
"google_business_reviews": {
"description": "Lists up to three most important reviews",
"type": "string",
"example": "[{\"summary\":\"Food is very good, staff is nice, quick service, good price.\",\"link\":\"https:\\/\\/...\"}]",
"nullable": true
},
"google_business_address": {
"description": "Indicates the google business address",
"type": "string",
"example": "5th Avenue",
"nullable": true
},
"google_business_country": {
"description": "Indicates the google business country",
"type": "string",
"example": "Italy",
"nullable": true
},
"google_business_thumbnail": {
"description": "Indicates the google business thumbnail",
"type": "string",
"example": "https://...",
"nullable": true
},
"google_business_phone_number": {
"description": "Indicates the google business phone number",
"type": "string",
"example": "393331234567",
"nullable": true
},
"google_business_description": {
"description": "Indicates the google business description",
"type": "string",
"example": "A long description",
"nullable": true
},
"google_business_industry": {
"description": "Indicates the google business industry type",
"type": "string",
"example": "Information services in Milan, Italy",
"nullable": true
},
"google_business_status": {
"description": "Indicates the google business status",
"type": "string",
"example": "open",
"nullable": true
},
"google_business_hours": {
"description": "Indicates the google business opening hours",
"type": "string",
"example": "{\"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\"}",
"nullable": true
},
"has_google_ads": {
"description": "Indicates if the domain has google advertisement",
"type": "boolean",
"example": true,
"nullable": true
},
"google_ads": {
"description": "Json representation of the top 5 most recent last shown ads",
"type": "string",
"example": "[{...}]",
"nullable": true
},
"google_ads_days_since_last_shown": {
"description": "Represents the number of days that have passed since the most recent last shown date for Google Ads associated with the domain.",
"type": "integer",
"example": 16,
"nullable": true
},
"dns_records_count": {
"description": "Indicates the number of dns records",
"type": "integer",
"example": 42,
"nullable": true
},
"dns_mx_records": {
"description": "Indicates the mx records",
"type": "string",
"example": "alt1.aspmx.l.google.com, alt2.aspmx.l.google.com, alt3.aspmx.l.google.com, alt4.aspmx.l.google.com, aspmx.l.google.com",
"nullable": true
},
"dns_has_mx": {
"description": "Indicates whether the domain has mx records",
"type": "boolean",
"example": true,
"nullable": true
},
"dns_mx_providers": {
"description": "Indicates the mx providers",
"type": "string",
"example": "Google Workspace",
"nullable": true
},
"dns_mx_is_valid": {
"description": "Indicates whether the domain mx records are valid",
"type": "boolean",
"example": true,
"nullable": true
},
"dns_spf_record": {
"description": "Indicates the spf record",
"type": "string",
"example": "v=spf1 include:_spf.hostedemail.com ~all",
"nullable": true
},
"dns_has_spf": {
"description": "Indicates whether the domain has spf records",
"type": "boolean",
"example": true,
"nullable": true
},
"dns_spf_is_valid": {
"description": "Indicates whether the domain spf records are valid",
"type": "boolean",
"example": true,
"nullable": true
},
"dns_dmarc_record": {
"description": "Indicates the dmarc record",
"type": "string",
"example": "v=DMARC1; p=none; adkim=r; aspf=r;",
"nullable": true
},
"dns_has_dmarc": {
"description": "Indicates whether the domain has dmarc records",
"type": "boolean",
"example": true,
"nullable": true
},
"dns_dmarc_is_valid": {
"description": "Indicates whether the domain dmarc records are valid",
"type": "boolean",
"example": true,
"nullable": true
},
"index_link_count": {
"description": "Indicate the number of pages that can be found in the major search engines",
"type": "integer",
"example": true,
"nullable": true
},
"has_glassdoor": {
"description": "Indicates whether the domain has Glassdoor",
"type": "boolean",
"example": true,
"nullable": true
},
"glassdoor_link": {
"description": "Indicates the domain glassdoor link",
"type": "string",
"example": true,
"nullable": true
},
"glassdoor_rating": {
"description": "Indicates the domain glassdoor rating",
"type": "number",
"format": "float",
"example": true,
"nullable": true
},
"glassdoor_reviews": {
"description": "Indicates the domain glassdoor reviews",
"type": "integer",
"example": true,
"nullable": true
},
"has_facebook": {
"description": "Indicates whether the domain has Facebook",
"type": "boolean",
"example": true,
"nullable": true
},
"facebook_link": {
"description": "Indicates the domain facebook link",
"type": "string",
"example": "http://www.facebook.com/PageLink",
"nullable": true
},
"facebook_likes": {
"description": "Indicates the domain facebook likes",
"type": "integer",
"example": 12,
"nullable": true
},
"facebook_followers": {
"description": "Indicates the domain facebook followers",
"type": "integer",
"example": 150,
"nullable": true
},
"facebook_rating": {
"description": "Indicates the domain facebook rating",
"type": "number",
"format": "float",
"example": 7,
"nullable": true
},
"facebook_reviews": {
"description": "Indicates the domain facebook reviews",
"type": "integer",
"example": 1200,
"nullable": true
},
"has_instagram": {
"description": "Indicates whether the domain has Instagram",
"type": "boolean",
"example": true,
"nullable": true
},
"instagram_link": {
"description": "Indicates the domain instagram link",
"type": "string",
"example": "http://www.instagram.com/PageLink",
"nullable": true
},
"instagram_likes": {
"description": "Indicates the domain instagram likes",
"type": "integer",
"example": 12,
"nullable": true
},
"instagram_followers": {
"description": "Indicates the domain instagram followers",
"type": "integer",
"example": 150,
"nullable": true
},
"instagram_posts": {
"description": "Indicates the domain instagram posts",
"type": "integer",
"example": 5,
"nullable": true
},
"registrar": {
"description": "Specifies the name of the registrar that manages the domain registration",
"type": "string",
"example": "GoDaddy.com, LLC",
"nullable": true
},
"is_suspicious_registrar": {
"description": "Indicates if the domain registrar is known for hosting low-trust domains.",
"type": "boolean",
"example": false,
"nullable": true
},
"registered_to": {
"description": "Indicates the name of the entity or individual who registered the domain",
"type": "string",
"example": "John Doe",
"nullable": true
},
"creation_date": {
"description": "Specifies the date when the domain was first registered",
"type": "string",
"pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}",
"example": "2020-01-02",
"nullable": true
},
"expiration_date": {
"description": "Indicates the date when the domain registration will expire unless renewed",
"type": "string",
"pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}",
"example": "2026-01-02",
"nullable": true
},
"updated_date": {
"description": "Specifies the last update date of the domain's registration details.",
"type": "string",
"pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}",
"example": "2020-01-02",
"nullable": true
},
"age": {
"description": "Represents the number of days since the domain was registered.",
"type": "integer",
"example": "1460",
"nullable": true
},
"registrant_disclosed": {
"description": "Indicates whether the registrant's name or organization is disclosed in the WHOIS record.",
"type": "boolean",
"example": true,
"nullable": true
},
"whois_data": {
"description": "A JSON representation of WHOIS information, structured with three top-level objects: \"registrant\", \"administrative_contact\", and \"technical_contact\". Each object may contain variable data structure representing various identity and contact details.",
"type": "string",
"example": "{\"registrant\": {\"name\": \"John Doe\", \"organization\": \"Example Inc.\", \"email\": \"john@example.com\"}, \"technical_contact\": {\"name\": \"Jane Smith\", \"email\": \"tech@example.com\"}, \"administrative_contact\": {\"name\": \"Admin Team\", \"email\": \"admin@example.com\"}}",
"nullable": true
},
"technologies": {
"description": "A JSON representation of a list of technologies associated to the given domain, each object of the list has a \"name\" and a \"category\".",
"type": "string",
"example": "[{\"name\":\"AWS Certificate Manager\",\"category\":\"SSL\\/TLS certificate authorities\"}]",
"nullable": true
},
"technologies_count": {
"description": "The number of technologies associated to the given domain website.",
"type": "integer",
"example": "0",
"nullable": true
},
"technologies_is_only_adv": {
"description": "A flag indicating whether in the associated domain website there are only advertising technologies, which is strange for a commercial website.",
"type": "boolean",
"example": "false",
"nullable": true
},
"technologies_are_enterprise": {
"description": "A flag indicating whether in the associated domain website there are enough enterprise technologies.",
"type": "boolean",
"example": "false",
"nullable": true
},
"website_contents_emails": {
"description": "A string containing one or more email addresses extracted from the website contents.",
"type": "string",
"example": "info@example.com",
"nullable": true
},
"website_contents_has_free_email": {
"description": "Indicates whether at least one email address published on the website belongs to a free email provider, such as Gmail.",
"type": "boolean",
"example": true,
"nullable": true
},
"website_contents_phone_numbers": {
"description": "A string containing one or more phone numbers extracted from the website contents.",
"type": "string",
"example": "+39 011 1234567",
"nullable": true
},
"website_contents_address": {
"description": "A string containing the physical address found on the website.",
"type": "string",
"example": "Via Roma 1, 10121 Torino, Italy",
"nullable": true
},
"website_contents_vat_code": {
"description": "The VAT identification number found on the website.",
"type": "string",
"example": "IT12345678901",
"nullable": true
},
"website_contents_company_name": {
"description": "The company name found on the website.",
"type": "string",
"example": "Example S.p.A.",
"nullable": true
},
"website_contents_language_code": {
"description": "The ISO 639-1 language code of the website content.",
"type": "string",
"example": "it",
"nullable": true
},
"website_contents_language_country": {
"description": "The ISO 3166-1 alpha-2 country code associated with the website language.",
"type": "string",
"example": "IT",
"nullable": true
},
"website_contents_social_links": {
"description": "A JSON representation of the list of social media profile URLs found on the website.",
"type": "string",
"example": "{\"facebook\": \"https://www.facebook.com/example\"}",
"nullable": true
},
"website_contents_privacy_policy_url": {
"description": "The URL pointing to the website's privacy policy page.",
"type": "string",
"example": "https://www.example.com/privacy-policy",
"nullable": true
},
"website_contents_terms_and_conditions_url": {
"description": "The URL pointing to the website's terms and conditions page.",
"type": "string",
"example": "https://www.example.com/terms-and-conditions",
"nullable": true
},
"website_contents_contacts_url": {
"description": "The URL pointing to the contact page of the website.",
"type": "string",
"example": "https://www.example.com/contact",
"nullable": true
},
"website_contents_description": {
"description": "A summary of website' content.",
"type": "string",
"example": "This website provides and example of a website.",
"nullable": true
},
"website_contents_tier1": {
"description": "A tier 1 classification of the website scope.",
"type": "string",
"example": "TECHNOLOGY_AND_COMPUTING",
"nullable": true
},
"website_contents_tier2": {
"description": "A tier 2 classification of the website scope.",
"type": "string",
"example": "TECHNOLOGY_AND_COMPUTING",
"nullable": true
},
"website_contents_tier3": {
"description": "A tier 3 classification of the website scope.",
"type": "string",
"example": "TECHNOLOGY_AND_COMPUTING",
"nullable": true
},
"social_links_max_followers": {
"description": "The maximum number of followers across the social links",
"type": "integer",
"example": "10",
"nullable": true
},
"has_trustpilot": {
"description": "Indicates whether the domain has a Trustpilot profile",
"type": "boolean",
"example": true,
"nullable": true
},
"trustpilot_url": {
"description": "The URL of the Trustpilot profile for the domain",
"type": "string",
"example": "https://www.trustpilot.com/review/example.com",
"nullable": true
},
"trustpilot_description": {
"description": "A brief description of the company as listed on Trustpilot",
"type": "string",
"example": "Example Company is a leading provider of innovative solutions.",
"nullable": true
},
"trustpilot_rating": {
"description": "The average rating of the company on Trustpilot",
"type": "number",
"format": "float",
"example": 4,
"nullable": true
},
"trustpilot_address": {
"description": "The address of the company as listed on Trustpilot",
"type": "string",
"example": "123 Example Street, Example City, EX 12345",
"nullable": true
},
"trustpilot_phone_number": {
"description": "The phone number of the company as listed on Trustpilot",
"type": "string",
"example": "+1 234-567-8900",
"nullable": true
},
"trustpilot_email": {
"description": "The email address of the company as listed on Trustpilot",
"type": "string",
"example": "email@example.com",
"nullable": true
},
"trustpilot_reviews_count": {
"description": "The number of reviews the company has on Trustpilot",
"type": "integer",
"example": 150,
"nullable": true
},
"trustpilot_reviews": {
"description": "A JSON representation of the reviews for the company on Trustpilot",
"type": "string",
"example": "[{\"author\": \"John Doe\", \"rating\": 5, \"date\": \"2024-12-04\", \"content\": \"Great service!\"}, {\"author\": \"Jane Smith\", \"rating\": 4, \"date\": \"2024-12-05\", \"content\": \"Very satisfied!\"}, {\"author\": \"Alice Johnson\", \"rating\": 3, \"date\": \"2024-12-06\", \"content\": \"Good, but could be better.\"}, {\"author\": \"Bob Brown\", \"rating\": 2, \"date\": \"2024-12-07\", \"content\": \"Not what I expected.\"}, {\"author\": \"Charlie White\", \"rating\": 1, \"date\": \"2024-12-08\", \"content\": \"Very disappointed.\"}]",
"nullable": true
},
"trustpilot_is_suspicious": {
"description": "Indicates whether the Trustpilot profile is considered suspicious",
"type": "boolean",
"example": false,
"nullable": true
},
"trustpilot_is_claimed": {
"description": "Indicates whether the Trustpilot profile is claimed by the company",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_exists": {
"description": "A flag explaining if the domain website has a privacy policy",
"type": "boolean",
"example": "true",
"nullable": true
},
"terms_and_conditions_exists": {
"description": "A flag explaining if the domain website has a terms and condition policy",
"type": "boolean",
"example": "true",
"nullable": true
},
"backlinks_count": {
"description": "A number explaining how many backlinks a domain has",
"type": "integer",
"example": "10",
"nullable": true
},
"backlinks_count_seo": {
"description": "Total number of backlinks discovered by SEO tools",
"type": "integer",
"example": 10,
"nullable": true
},
"backlinks_referring_domains": {
"description": "Number of unique domains that link to the analyzed domain.",
"type": "integer",
"example": 5,
"nullable": true
},
"backlinks_referring_ips": {
"description": "Total number of unique IP addresses from which backlinks originate.",
"type": "integer",
"example": 3,
"nullable": true
},
"backlinks_score": {
"description": "A general quality score of the backlink profile",
"type": "integer",
"example": 75,
"nullable": true
},
"semrush_score": {
"description": "Proprietary domain authority, based on the quality, quantity, and influence of backlinks.",
"type": "integer",
"example": 60,
"nullable": true
},
"backlinks_from_a": {
"description": "Number of backlinks found in anchor text elements within regular content.",
"type": "integer",
"example": 12,
"nullable": true
},
"backlinks_from_form": {
"description": "Number of backlinks embedded in HTML form elements.",
"type": "integer",
"example": 2,
"nullable": true
},
"backlinks_from_frame": {
"description": "Number of backlinks found inside iframe or similar frame-based structures.",
"type": "integer",
"example": 1,
"nullable": true
},
"backlinks_from_image": {
"description": "Number of backlinks originating from image tags.",
"type": "integer",
"example": 4,
"nullable": true
},
"privacy_policy_content_path": {
"description": "The S3 link to the privacy policy page content.",
"type": "string",
"example": "s3://bucket-name/path/to/privacy_policy.html",
"nullable": true
},
"terms_and_conditions_content_path": {
"description": "The S3 link to the terms and conditions page content.",
"type": "string",
"example": "s3://bucket-name/path/to/terms_and_conditions.html",
"nullable": true
},
"privacy_policy_found": {
"description": "A flag indicating whether the privacy policy has been found.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_has_clear_language": {
"description": "A flag indicating whether the privacy policy document is written in clear, plain language, avoiding legal and technical jargon to ensure that it is easily understandable for all users, regardless of their technical or legal expertise.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_specifies_company_identity": {
"description": "A flag indicating whether the privacy policy document clearly identifies the company, specifying its full legal name and legal status, which is essential for transparency.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_specifies_contact_information": {
"description": "A flag indicating whether the privacy policy document specifies valid contact information, enabling users to submit inquiries or exercise their legal rights.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_specifies_data_collection": {
"description": "A flag indicating whether the privacy policy document specifies the types of data collected, the methods of collection, the purposes of processing, and the legal basis for that processing.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_specifies_data_sharing": {
"description": "A flag indicating whether the privacy policy document clearly explains how and with which third parties user data is shared, outlining any legal limitations and their specific usage rights.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_is_gdpr_compliant": {
"description": "A flag indicating whether the privacy policy document adheres to GDPR regulations.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_has_data_controller": {
"description": "A flag indicating whether the privacy policy document identifies the data controller, which is the entity responsible for determining the purposes and means of the processing of personal data.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_has_cookie_policy": {
"description": "A flag indicating whether the privacy policy document includes a specific cookie policy that explains the use of tracking technologies, the types of cookies used, and how users can manage their preferences.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_is_generic": {
"description": "A flag indicating whether the privacy policy document is too generic and lacks the specific details required to demonstrate it has been customized to the company's unique data processing activities.",
"type": "boolean",
"example": true,
"nullable": true
},
"privacy_policy_with_unrealistic_promises": {
"description": "A flag indicating whether the privacy policy document contains unrealistic or misleading claims, such as guaranteeing absolute data security or promising that user data will never be shared under any circumstances.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_found": {
"description": "A flag indicating whether the terms and conditions document has been found.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_has_clear_language": {
"description": "A flag indicating whether the terms and conditions document is written in clear, plain language, avoiding legal and technical jargon to ensure that it is easily understandable for all users, regardless of their technical or legal expertise.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_specifies_company_identity": {
"description": "A flag that indicates whether the terms and conditions document explicitly includes company-related information, such as the company's legal name, registered address, identification number, or other official business details",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_specifies_contact_information": {
"description": "A flag indicating whether the terms and conditions document specifies valid contact information, enabling users to submit inquiries or exercise their legal rights.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_document_is_specific": {
"description": "A flag indicating whether the terms and conditions document is sufficiently specific and tailored to the company's services, rather than a generic template that fails to clearly outline the rights and obligations of both parties.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_with_contradictions": {
"description": "A flag indicating whether the terms and conditions document contains internal contradictions or inconsistencies that create ambiguity and could make the terms difficult to interpret or legally unenforceable.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_with_external_incoherent_references": {
"description": "A flag indicating whether the terms and conditions document contains suspicious or misleading external references, which could be a signal for a scam or a deceptive practice by preventing users from verifying the company's claims.",
"type": "boolean",
"example": true,
"nullable": true
},
"terms_and_conditions_with_data_protection": {
"description": "A flag indicating whether the terms and conditions document specifies how personal data is protected and secured, referring to details which specify company's security measures and user rights.",
"type": "boolean",
"example": true,
"nullable": true
},
"is_enterprise": {
"description": "A flag indicating whether in the associated domain website is enough complete to be considered enterprise",
"type": "boolean",
"example": "false",
"nullable": true
},
"website_contents_is_ecommerce": {
"description": "True when the domain website is an ecommerce platform selling physical or digital goods or services online",
"type": "boolean",
"example": true,
"nullable": true
},
"website_contents_has_unmodified_template_content": {
"description": "True when the website uses an unchanged starter template or contains template text or data that has not been replaced; null when uncertain.",
"type": "boolean",
"example": false,
"nullable": true
},
"website_uses_third_party_platform_domain": {
"description": "True when the website uses a domain belonging to a third-party platform, such as square.site, so the registration data describes the platform rather than the customer.",
"type": "boolean",
"example": true,
"nullable": true
},
"website_third_party_platform_domain": {
"description": "The third-party platform domain used by the website, such as square.site or site123.me; null when the customer owns the domain.",
"type": "string",
"example": "square.site",
"nullable": true
},
"website_third_party_platform_type": {
"description": "The category of the third-party platform the website uses; null when unknown.",
"type": "string",
"enum": [
"general",
"booking",
"beauty",
"food",
"hospitality",
"ecommerce",
"healthcare",
"events",
"automotive"
],
"example": "food",
"nullable": true
},
"score": {
"description": "A number ranging from 0 to 1000 represents the quality of the domain information detected",
"type": "integer",
"example": 649,
"nullable": true
},
"score_cluster": {
"description": "A cluster summarizing the quality of the domain provided",
"type": "string",
"enum": [
"very_low",
"low",
"review",
"high",
"very_high"
],
"example": "very_high",
"nullable": true
},
"reason_codes": {
"description": "Comma-separated risk and trust signal codes fired by the domain explain chain.",
"type": "string",
"example": "RO001,TO002",
"nullable": true
}
},
"type": "object"
},
"HubRequestBase": {
"title": "HubRequestBase",
"description": "HubRequestBase",
"required": [
"customer_id",
"claims"
],
"properties": {
"customer_id": {
"description": "A string representing the unique identifier of the user you are requesting information about. Each request requires a different customer_id",
"type": "string",
"example": "customer_id_393494108457"
},
"max_enrichment_time": {
"description": "Specifies the maximum duration for data enrichment, allowing you to fine-tune the process to enhance accuracy or reduce response time. [Read more](https://docs.trustfull.com/docs/response-times#working-with-max-enrichment-time)",
"type": "number",
"format": "float",
"maximum": 10,
"minimum": 1.7,
"example": 3
},
"model_id": {
"description": "The id of the model that computes the score: one of your models, or a system model such as phone_score. The model must score the product of the call. Leave it out to use the active model of the product.",
"type": "string",
"example": "c0a8f3e2-4b1d-4e8a-9f2a-7d1e2b3c4d5e"
}
},
"type": "object"
},
"HubResponseBase": {
"title": "Base",
"description": "Base",
"properties": {
"resolution_id": {
"type": "string",
"example": "00000000-0000-0000-0000-000000000000"
},
"device_request_time": {
"type": "string",
"example": "2023-04-21T12:15:36.009Z"
},
"customer_id": {
"$ref": "#/components/schemas/HubRequestBase/properties/customer_id"
},
"model_id": {
"description": "The id of the model that computed the score of the response. It is null when no model computed a score.",
"type": "string",
"example": "c0a8f3e2-4b1d-4e8a-9f2a-7d1e2b3c4d5e",
"nullable": true
}
},
"type": "object"
},
"GetDomainResponseBase": {
"title": "Domain Base",
"description": "Domain Base",
"properties": {
"resolution_id": {
"type": "string",
"example": "00000000-0000-0000-0000-000000000000"
},
"device_request_time": {
"type": "string",
"example": "2023-04-21T12:15:36.009Z"
},
"customer_id": {
"$ref": "#/components/schemas/HubRequestBase/properties/customer_id"
},
"model_id": {
"$ref": "#/components/schemas/HubResponseBase/properties/model_id"
}
},
"type": "object"
},
"GetDomainResponse": {
"title": "Domain",
"description": "Domain",
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GetDomainResponseBase"
},
{
"properties": {
"domain": {
"$ref": "#/components/schemas/GetDomainResponsePayload"
}
},
"type": "object"
}
]
}
},
"parameters": {
"content-type": {
"name": "content-type",
"in": "header",
"schema": {
"type": "string",
"default": "application/json"
}
},
"accept": {
"name": "accept",
"in": "header",
"schema": {
"type": "string",
"default": "application/json"
}
},
"x-api-key": {
"name": "x-api-key",
"in": "header",
"required": true,
"schema": {
"type": "string",
"example": "[your-api-key]"
}
}
}
}
}
```