docs / endpoint

POST /v1/domains/card

Company card — identity, contacts, socials, technology from our crawl.

Credits: 10 credits per call. Timeout: 60s

Parameters

NameTypeRequiredDefaultDescription
domain string required — Domain to look up (bare hostname, lowercased). Required, max 255 chars, no spaces.

Request

→ requestPOST /v1/domains/card
POST /v1/domains/card HTTP/1.1
Authorization: Bearer sof_live_your_key_here
Content-Type: application/json

{
  "domain": "example.com"
}

Response

Wrapped in the standard envelope -- id, object, created_at, elapsed_ms, cache, credits -- documented once on The Contract. The body below is a real envelope with this endpoint's data shape; values vary per request, and a … marks an array cut short for display.

← response200
{
  "id": "doma_ubxr25pseo765qaqovleyi2x",
  "request_id": "req_nzfsjlqkgncljkkiaqcd6eajxq",
  "object": "domain_card",
  "created_at": "2026-08-09T07:21:10Z",
  "elapsed_ms": 180,
  "cache": "miss",
  "credits": {
    "charged": 10,
    "balance": 9857
  },
  "data": {
    "domain": "example.com",
    "site_name": "Example Inc.",
    "description": "Compression socks for trail runners.",
    "logo_url": "https://example.com/logo.svg",
    "emails": [
      "hello@example.com"
    ],
    "phones": [
      "+1 415 555 0100"
    ],
    "postal_address": "548 Market St, San Francisco, CA",
    "social_profiles": {
      "linkedin": "https://linkedin.com/company/example",
      "x": "https://x.com/example"
    },
    "technology": {
      "cms": "wordpress",
      "framework": null,
      "server": "nginx",
      "hosting": "cloudflare"
    },
    "country": "US",
    "language": "en",
    "as_of": "2026-07-21"
  }
}

Response fields

What each field in data (above) means.

FieldDescription
data.domain The domain you requested.
data.site_name Company/site display name, or null if not identified.
data.description Site description, or null if not identified.
data.logo_url URL of the site's logo, or null if not identified.
data.emails Contact email addresses found on the site; empty array if none.
data.phones Contact phone numbers found on the site; empty array if none.
data.postal_address Postal address found on the site, or null if none.
data.social_profiles Social profile URLs found on the site, keyed by platform (e.g. "linkedin", "x"); empty object if none.
data.technology Detected technology stack.
data.technology.cms Detected CMS, or null if not identified.
data.technology.framework Detected web framework, or null if not identified.
data.technology.server Detected server software, or null if not identified.
data.technology.hosting Detected hosting provider, or null if not identified.
data.country Detected country, or null if not identified.
data.language Detected primary language, or null if not identified.
data.as_of Date this card was last built from a crawl.