> ## Documentation Index
> Fetch the complete documentation index at: https://clair.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Website Contacts API

> Website Contacts API: extract public emails, phone numbers, and social profile URLs from a company domain. Homepage plus one same-origin contact page. 10 credits.

Live scrape of a company's **public website**. Fetches the homepage and, when
linked, a same-origin contact or about page. Returns addresses published on
those pages — `mailto`, `tel`, JSON-LD people, and social profile URLs.

It does not log in, crawl the whole site, or buy a third-party lead database.

See the [product page](https://clair.im/dashboard/apis/contacts) and
[website contacts use case](https://clair.im/resources/use-cases/website-contacts).

## Endpoint

`GET /v1/contacts` · **10 credits**

```sh theme={null}
curl -G https://api.clair.im/v1/contacts \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "domain=stripe.com"
```

## Parameters

| Parameter | Required | Contract                                                                     |
| --------- | -------- | ---------------------------------------------------------------------------- |
| `domain`  | yes      | Public hostname, with or without `https://`. IPs and localhost are rejected. |

## Response

```json theme={null}
{
  "domain": "acme.com",
  "pages": ["https://acme.com/", "https://acme.com/contact"],
  "emails": ["hello@acme.com"],
  "phones": ["+1 415 555 0100"],
  "social": [
    { "network": "linkedin", "url": "https://www.linkedin.com/company/acme", "source_url": "https://acme.com/" },
    { "network": "twitter", "url": "https://x.com/acme", "source_url": "https://acme.com/" }
  ],
  "contacts": [
    {
      "name": "Ada Lovelace",
      "role": "Founder",
      "email": "ada@acme.com",
      "phone": null,
      "source_url": "https://acme.com/"
    }
  ]
}
```

Noreply and placeholder addresses are dropped. Social share buttons are not
returned as profiles. Named `contacts[]` appear when JSON-LD or mailto labels
exist.

## What this API does not do

* It does not crawl every path on the domain.
* It does not resolve people from paid data brokers.
* It does not fetch a caller-supplied arbitrary URL outside the domain
  parameter.

Auth, credits, and error codes: [Authentication](/docs/authentication).