Skip to content
Websites

Get a website's contacts

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

websites/contacts/get1 credit a callv1.1.0

When to use it

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.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The site's address (https://www.acme.fr/), or its domain alone (acme.fr, read as https://acme.fr/).
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.
The country to read a national phone number in (fr: 06 12 34 56 78 is +33612345678).
1 credit a call
Code, from the fields above
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"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_gxhefvcvquqjbfihd2wjsqttjm",
  "livemode": true,
  "source": "websites",
  "operation": "contacts/get",
  "version": "1.1.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/websites/contacts/get",
  "options": {
    "website": "https://www.example-plumber.fr/",
    "country": "fr"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 1
  },
  "results": [
    {
      "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"
    }
  ]
}

Options

websitestringrequired
The site's address (https://www.acme.fr/), or its domain alone (acme.fr, read as https://acme.fr/).
max_pagesintegerDefault 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.
countrystring
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 record of results, in the envelope every call returns (Run an operation).

objectstring
websitestring
The home page read
domainstring
The site's registrable domain: acme.fr for https://www.acme.fr/.
emailslist
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).
phoneslist
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).
profileslist
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.
pageslist
Each page read, with the status it answered (0 when it did not answer).
source_urlstring
The home page these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_website422The value is neither a website's address nor a domain.
invalid_max_pages422max_pages takes 1 to 10.
website_unreachable424The website did not answer: its domain has no server, it refused the connection, or its home page is missing. Not charged.
site_unavailable503The website refused us or did not answer in time; retry later (not charged). Retryable.

Price

1 credit a call. A failed call is free. What a credit costs on each plan: Credits and pricing.

Changelog

1.1.02026-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.02026-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.