This document describes how to use the Eregos Early API to evaluate the trustworthiness of a given URL or domain.

Base URL

https://eregos.com/api/early

Authentication

All requests must include an Authorization header with your API key.

Authorization: eregos_<your_api_key>

If the header is missing or invalid, the request will fail.

Content Type

The API accepts JSON payloads only.

Content-Type: application/json

HTTP Method

POST

Request Format

Body Parameters

Field Type Required Description
query string yes A full URL or domain to be analyzed

Example Request

curl -X POST https://eregos.com/api/early \
  -H "Authorization: eregos_xyz" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "https://hr.airbnb.com/rooms/41477248"
  }'

Successful Response

Example Response

{
  "host": "hr.airbnb.com",
  "trustscore": 89,
  "trustsignal": {
    "domain": 73,
    "ownership": 93,
    "encryption": 100,
    "website": 90
  }
}

Response Fields

Field Type Description
user_id string Identifier of the requesting user
host string Parsed domain from the query
trustscore number Overall trust score (0–100)
trustsignal object Breakdown of trust components

Trust Signal Breakdown

Field Description
domain Domain reputation score
ownership Ownership and registration confidence
encryption HTTPS / TLS security score
website Website structure and behavior score

Error Handling

When an error occurs, the API responds with an error object containing an error_code.

Common Error Codes

Error Code Description
INVALID_URL The provided URL is malformed or unsupported
GOVERNMENT_DOMAIN_BLOCKED Government domains are explicitly blocked
WHOIS_INVALID WHOIS lookup failed or returned invalid data
WHOIS_NOT_FOUND Domain is not registered in WHOIS
EREGOS_UNAVAILABLE The Eregos service is temporarily unavailable

Error Example

{
  "error_code": "INVALID_URL"
}

Notes & Best Practices

  • Always submit fully qualified URLs (including https:// when possible).
  • Government domains may be intentionally blocked.
  • WHOIS-based checks depend on domain registration data availability.
  • Handle EREGOS_UNAVAILABLE by retrying with backoff.
Back to home