Platinux API

Domain checks

How scoring screens every domain, and the one-word reason returned for each kind of rejected input.

View as Markdown

Before anything is scored or charged, every company domain is screened, whether you send it to /score/domain or we find it from an email or LinkedIn URL. Inputs that aren't a company's own website are rejected with HTTP 400 and a one-word reason you can switch on in code:

json
{ "error": "invalid_domain", "reason": "social_media" }

In a bulk call, each rejected domain is listed in rejected with its reason, and the rest are still scored:

json
{ "rejected": [ { "domain": "logo.png", "reason": "file_name" } ] }

Rejected domains are never charged.

Reasons

Instant checks

reasonRejected inputExamples
emptyNothing entered"", " "
invalid_formatNot shaped like a domainacme, hello world.com, -bad-.com
invalid_tldThe ending isn't a real domain endingacme.con, acme.comm
emailAn email addressjane@acme.com
ip_addressAn IP address, with or without a port or path192.168.1.1, http://10.0.0.1:8080/x, 2001:db8::1
file_nameA file name or pathlogo.png, Document.pdf, Presentation.pptx, C:\files\deck.pptx
social_mediaA social networklinkedin.com/company/acme, instagram.com/acme, facebook.com, x.com, youtube.com
messagingA chat or meeting linkwa.me/9198…, chat.whatsapp.com/…, t.me/acme, discord.gg/…
common_siteA well-known site, not a prospectgoogle.com, google.co.in, wikipedia.org, chatgpt.com, example.com
email_providerA generic or temporary email servicegmail.com, outlook.com, mailinator.com
link_shortenerA short-link or link-in-bio servicebit.ly/x, tinyurl.com/x, linktr.ee/acme
marketplaceA marketplace, directory or app storeindiamart.com, amazon.de, crunchbase.com, play.google.com
free_hostA free website on a hosting or site-builder domainacme.myshopify.com, acme.wixsite.com, acme.vercel.app

Live checks

These look at the domain on the internet before scoring.

reasonRejected input
unregisteredThe domain doesn't exist: expired or never registered
no_websiteRegistered, but no website answers, the page is blank, or it shows a default server page
parkedParked or for sale (redirects to a domain marketplace, or a "this domain is for sale" page)
coming_soonA "Coming soon" or "Under construction" page

Bulk only

reasonMeaning
already_processingA single scoring job for this domain is already running
none_validWhole call: no domain in the list passed the checks

How the checks work

  • Cleaning first: https://www.Acme.com/about?x=1 is checked as acme.com. Paths and www. are fine.
  • Subdomains count: in.linkedin.com, m.facebook.com and x.tradeindia.com are recognised as their parent site.
  • Real endings only: the domain ending is checked against the official list of every top-level domain.
  • File names vs. domains: endings that are both a file type and a real domain ending, such as .ai and .app, are treated as domains, so x.ai passes.
  • Live checks never block a real company by accident: a slow site, a site behind bot protection, or a site with a temporary server error is accepted. A domain is rejected only on clear evidence.

Handling reasons in code

javascript
const res = await fetch(`${BASE}/score/domain`, { method: "POST", headers, body: JSON.stringify({ domain, template_id }) });
const body = await res.json();
if (res.status === 400 && body.error === "invalid_domain") {
  switch (body.reason) {
    case "social_media": case "messaging": return "That's a social or chat link. Enter the company's website.";
    case "file_name": return "That looks like a file name.";
    case "unregistered": case "no_website": return "This domain has no website.";
    case "parked": return "This domain is parked or for sale.";
    case "coming_soon": return "This website isn't live yet.";
    default: return "Enter the company's own website, like acme.com.";
  }
}