← APIs / Company Identity
Verified

Company Identity

Apiosk Basicsby Apiosk Basics · General

Normalize and connect a company's name, domain and email: standardize legal-form suffixes, classify an email domain, and derive a company name or country from a homepage.

dataapi
Price per request
$0.07
About

Company Identity is a bundle of small, deterministic (plus light-scrape) tools an AI agent uses when it processes leads, forms or CRM records: company-normalize standardizes a name and its legal-form suffix (BV, N.V., Ltd, LLC, Inc); email-domain-check classifies an email domain as company / free-provider / disposable from local lists; company-from-domain derives a likely company name from a homepage (og:site_name / title / meta); company-country-detect infers a country from an explicit hint, the domain TLD, or address signals on the page. Heuristic, list- and scrape-based, not a live registry lookup. Pay per request via x402; no API key needed from the caller.

Base URL
https://gateway.apiosk.com/company-identity
Technical Specs
Auth Methodx402
Response FormatJSON
Endpoints4
Endpoints
MethodPathDescriptionCost
POST /company-country-detect Infer a company's likely country: an explicit country hint wins, then the domain TLD (.nl/.de/.be/.fr/.uk; .com/.io/.net/.org are country-neutral), then address signals scraped from the homepage (EN/NL only in v1). Returns the signals it used.
$0.07 default
 View details
POST /company-from-domain Fetch a domain's homepage and derive a likely company name (og:site_name > title > meta description), with generic suffixes like " - Home" / " | Official Website" stripped. Returns company_name null with confidence 0 when nothing usable is found (still HTTP 200).
$0.07 default
 View details
POST /company-normalize Normalize a company name: standardize whitespace and the legal-form suffix (BV/B.V., NV/N.V., Ltd, LLC, Inc) and return a canonical form plus a bare lowercase alphanumeric key. Does not guess the "real" name — only standardizes what is already there.
$0.07 default
 View details
POST /email-domain-check Classify an email address by its domain: company vs. known free provider (Gmail/Outlook/…) vs. disposable domain. List-based heuristic, not a live DNS/MX check.
$0.07 default
 View details
Endpoint documentation
POST/company-country-detect
$0.07 default
Description

Infer a company's likely country: an explicit country hint wins, then the domain TLD (.nl/.de/.be/.fr/.uk; .com/.io/.net/.org are country-neutral), then address signals scraped from the homepage (EN/NL only in v1). Returns the signals it used.

Pricing
$0.07 default
Request schema
{
  "anyOf": [
    {
      "required": [
        "domain"
      ]
    },
    {
      "required": [
        "country"
      ]
    },
    {
      "required": [
        "name"
      ]
    }
  ],
  "properties": {
    "country": {
      "description": "Optional explicit hint; when present it is trusted and returned directly.",
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  },
  "type": "object"
}
Response schema
{
  "properties": {
    "company_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "confidence": {
      "type": "number"
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "signals": {
      "items": {
        "enum": [
          "explicit",
          "domain_tld",
          "address_hint"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
Example request
{
  "domain": "tomtom.com",
  "name": "TomTom"
}
Example response
{
  "company_name": "TomTom",
  "confidence": 0.9,
  "country": "NL",
  "signals": [
    "domain_tld",
    "address_hint"
  ]
}
POST/company-from-domain
$0.07 default
Description

Fetch a domain's homepage and derive a likely company name (og:site_name > title > meta description), with generic suffixes like " - Home" / " | Official Website" stripped. Returns company_name null with confidence 0 when nothing usable is found (still HTTP 200).

Pricing
$0.07 default
Request schema
{
  "properties": {
    "domain": {
      "description": "Bare domain, e.g. \"tomtom.com\".",
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}
Response schema
{
  "properties": {
    "company_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "confidence": {
      "type": "number"
    },
    "domain": {
      "type": "string"
    },
    "source": {
      "enum": [
        "og_site_name",
        "website_title",
        "meta_description",
        "unavailable"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
Example request
{
  "domain": "tomtom.com"
}
Example response
{
  "company_name": "TomTom",
  "confidence": 0.8,
  "domain": "tomtom.com",
  "source": "website_title"
}
POST/company-normalize
$0.07 default
Description

Normalize a company name: standardize whitespace and the legal-form suffix (BV/B.V., NV/N.V., Ltd, LLC, Inc) and return a canonical form plus a bare lowercase alphanumeric key. Does not guess the "real" name — only standardizes what is already there.

Pricing
$0.07 default
Request schema
{
  "properties": {
    "country": {
      "description": "Optional ISO country code; echoed back, not detected here.",
      "type": "string"
    },
    "name": {
      "description": "Company name, e.g. \"Tom Tom nv\".",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
Response schema
{
  "properties": {
    "canonical_name": {
      "type": "string"
    },
    "confidence": {
      "description": "0.95 when a legal form was recognized, else 0.7.",
      "type": "number"
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "normalized_name": {
      "description": "canonical_name lowercased, only a-z0-9.",
      "type": "string"
    }
  },
  "type": "object"
}
Example request
{
  "country": "NL",
  "name": "Tom Tom nv"
}
Example response
{
  "canonical_name": "Tom Tom N.V.",
  "confidence": 0.95,
  "country": "NL",
  "normalized_name": "tomtom"
}
POST/email-domain-check
$0.07 default
Description

Classify an email address by its domain: company vs. known free provider (Gmail/Outlook/…) vs. disposable domain. List-based heuristic, not a live DNS/MX check.

Pricing
$0.07 default
Request schema
{
  "properties": {
    "email": {
      "description": "Email address, e.g. \"olivier@tomtom.com\".",
      "type": "string"
    }
  },
  "required": [
    "email"
  ],
  "type": "object"
}
Response schema
{
  "properties": {
    "confidence": {
      "type": "number"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ]
    },
    "email": {
      "type": "string"
    },
    "is_disposable": {
      "type": "boolean"
    },
    "is_free_provider": {
      "type": "boolean"
    },
    "type": {
      "enum": [
        "company",
        "free_email",
        "disposable",
        "invalid"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
Example request
{
  "email": "olivier@tomtom.com"
}
Example response
{
  "confidence": 0.85,
  "domain": "tomtom.com",
  "email": "olivier@tomtom.com",
  "is_disposable": false,
  "is_free_provider": false,
  "type": "company"
}
Home · Documentation · Apiosk.com