# Websites: Get a website's contacts

`websites/contacts/get` · version 1.1.0 · pilot · 1 credits a call

The emails, phone numbers and profiles (social networks, directories) a company's website shows, each with its page.

Categories: Lead generation

## When to use

You have a company's website (a Google Maps place's `website_url`, a domain) and need how to reach it: its emails, phone numbers and its profiles elsewhere (Facebook, Instagram, LinkedIn, X, YouTube, TikTok, GitHub, Discord..., and directories: Google Maps, Yelp, Trustpilot, TripAdvisor). One call reads the home page and the site's contact, legal notice and about pages. Each email says whether it is on the site's own domain, at a free mailbox, or a role address (contact@): a legal notice also shows its web designer's or its chamber's. Nothing is verified with a third party.

## Call

```bash
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"source": "websites", "operation": "contacts/get", "options": {"website": "https://www.example-plumber.fr/", "country": "fr"}}'
```

The answer's `next` is the whole call for the following page: send it as it is. `null` on the last page.

Beside `options`, the call takes:

| Parameter | Type | Description |
|---|---|---|
| `fields` | array of string | The record fields to keep, by path (`title`, `address.city`); `object`, `id` and `position` always come. Left out: every field. |

## Options

| Option | Type | Required | Default | Description |
|---|---|---|---|---|
| `website` | string | yes |  | The site's address (https://www.acme.fr/), or its domain alone (acme.fr, read as https://acme.fr/). |
| `max_pages` | integer, 1 to 10 |  | `4` | The pages read at most: the home page, then those its links name as contact, legal notice (mentions légales, Impressum) or about, in that order. 4 by default. A home page that only frames another address, or refreshes to it (a domain its registrar forwards), is read at that address. |
| `country` | string |  |  | The country to read a national phone number in (fr: 06 12 34 56 78 is +33612345678). Left out, a number is given as E.164 only when it says its country (+33, 0033); always as written too. |

## Record

Each item of `results`. Every field is always present, `null` when the site gives nothing.

| Field | Type | Description |
|---|---|---|
| `object` | `"website_contacts"` |  |
| `website` | string (uri) | The home page read |
| `domain` | string | The site's registrable domain: acme.fr for https://www.acme.fr/. |
| `emails` | array | Every address the pages show: their mailto links (those a site builder keeps in the page's scripts too), the addresses Cloudflare hides from bots (decoded), their schema.org data and their text (name [at] acme.fr read too); any other address inside a page's scripts, only on the site's own domain; never a theme's sample (info@yourcompany.com). |
| `emails[].address` | string | Lower-cased. |
| `emails[].domain` | string |  |
| `emails[].own_domain` | boolean | On the site's own domain (or one of its subdomains). |
| `emails[].free_provider` | boolean | At a free mailbox: Gmail, Outlook, Orange, GMX... |
| `emails[].generic` | boolean | A role address, not a person: contact@, info@, accueil@... |
| `emails[].found_on` | array of string | The pages that show it. |
| `phones` | array | The numbers the pages give to call: their tel: links (those a site builder keeps in the page's scripts too), their schema.org `telephone`, and a number written right after a phone label (Tél., Phone:, Telefon, Teléfono, Mobile...); never another number of the text (a SIRET, a VAT number, opening hours), nor a theme's sample (123-456-7890). |
| `phones[].number` | string | null | E.164 (+33612345678), when the number says its country or `country` was given and the number is written that country's way; else null. A 0 kept after the country (+33 0 1..., +49 (0)89...) is dropped. |
| `phones[].as_written` | string |  |
| `phones[].found_on` | array of string |  |
| `profiles` | array | The company's pages on other sites the pages link to: social networks and the directories people book or read reviews on; never a share button, a post, a video or a site's home. |
| `profiles[].site` | `facebook`, `instagram`, `linkedin`, `x`, `youtube`, `tiktok`, `pinterest`, `whatsapp`, `threads`, `bluesky`, `snapchat`, `telegram`, `discord`, `github`, `medium`, `substack`, `reddit`, `twitch`, `vimeo`, `xing`, `google_maps`, `yelp`, `trustpilot`, `tripadvisor` |  |
| `profiles[].url` | string (uri) |  |
| `profiles[].found_on` | array of string |  |
| `pages` | array | Each page read, with the status it answered (0 when it did not answer). |
| `pages[].url` | string (uri) |  |
| `pages[].status` | integer |  |
| `source_url` | string (uri) | The home page these values were read from. |
| `observed_at` | string (date-time) | When they were read |

Example:

```json
{
  "object": "website_contacts",
  "website": "https://www.example-plumber.fr/",
  "domain": "example-plumber.fr",
  "emails": [
    {
      "address": "contact@example-plumber.fr",
      "domain": "example-plumber.fr",
      "own_domain": true,
      "free_provider": false,
      "generic": true,
      "found_on": [
        "https://www.example-plumber.fr/",
        "https://www.example-plumber.fr/contact"
      ]
    },
    {
      "address": "webmaster@example-agency.fr",
      "domain": "example-agency.fr",
      "own_domain": false,
      "free_provider": false,
      "generic": true,
      "found_on": [
        "https://www.example-plumber.fr/mentions-legales"
      ]
    }
  ],
  "phones": [
    {
      "number": "+33612345678",
      "as_written": "06 12 34 56 78",
      "found_on": [
        "https://www.example-plumber.fr/"
      ]
    }
  ],
  "profiles": [
    {
      "site": "facebook",
      "url": "https://www.facebook.com/exampleplumber",
      "found_on": [
        "https://www.example-plumber.fr/"
      ]
    },
    {
      "site": "google_maps",
      "url": "https://g.page/example-plumber",
      "found_on": [
        "https://www.example-plumber.fr/contact"
      ]
    }
  ],
  "pages": [
    {
      "url": "https://www.example-plumber.fr/",
      "status": 200
    },
    {
      "url": "https://www.example-plumber.fr/contact",
      "status": 200
    },
    {
      "url": "https://www.example-plumber.fr/mentions-legales",
      "status": 200
    }
  ],
  "source_url": "https://www.example-plumber.fr/",
  "observed_at": "2026-11-10T18:00:00Z"
}
```

## Price



## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `invalid_website` | 422 | no | The value is neither a website's address nor a domain. |
| `invalid_max_pages` | 422 | no | `max_pages` takes 1 to 10. |
| `website_unreachable` | 424 | no | The website did not answer: its domain has no server, it refused the connection, or its home page is missing. Not charged. |
| `site_unavailable` | 503 | yes | The website refused us or did not answer in time; retry later (not charged). |
| `missing_api_key` | 401 | no | No API key: send it as `Authorization: Bearer <key>`. |
| `invalid_api_key` | 401 | no | The key is not valid, or not anymore. |
| `insufficient_credits` | 402 | no | The call costs more credits than are left. |
| `unknown_operation` | 404 | no | No such source and operation in the catalog. |
| `timeout` | 408 | yes | The call did not finish within its deadline (not charged). |
| `invalid_body` | 422 | no | The body is not a call: source, operation, options. |
| `invalid_options` | 422 | no | An option is missing or out of its contract; `param` names it. |
| `invalid_idempotency_key` | 400 | no | The Idempotency-Key header is not printable ASCII, or too long. |
| `concurrency_limit` | 429 | yes | The plan's calls at a time are all in progress (Free 1, Starter 2, Pro 10, Team 50); retry when one has finished (not charged, never queued). |
| `service_busy` | 503 | yes | Too many calls at once on the account; retry in a few seconds. |
| `balance_unavailable` | 503 | yes | The balance could not be read; retry in a few seconds. |

## Changelog

- **1.1.0** (2026-11-12): More phones and a few more emails, read as a person reads them: a number written after its label (Tél., Phone:, Telefon...), the mailto and tel: links a site builder keeps in the page's scripts, links written without quotes, a home page that frames another address. On 9,864 company websites of 45 countries, a phone on 71.8 % of the sites read, from 65.1 % (82 % from 71 % in France), and in E.164 on 69.9 %, from 54.8 %: numbers with a 0 kept after their country (+33 0 1...) are given right, and `country` reads 45 countries' numbers. Doctolib is no longer among the profiles. A page heavy with inline images no longer takes seconds to read.
- **1.0.0** (2026-11-10): First version on the API v2, in place of the v1 Contact Details Scraper: one site a call, its emails, phones and profiles (25 social networks and directories), each with the page it is on.

Schema: https://api.lobstr.io/v2/catalog/websites/contacts/get · All operations: https://api.lobstr.io/v2/catalog.md
