Website contacts
The emails, phone numbers and social profiles a website publishes, with its contact page, address and company name.
GET/v1/web/contacts
Costs 1 credit per request. Only requests that return data are charged.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired |
string | Website address or bare domain, such as stripe.com. The site at that host is read; a path is ignored. |
pagesoptional |
integer | How many pages of the site to read, contact, imprint and about pages first. Default: 5. From 1 to 10. |
Example request
curl "https://pipefetch.com/v1/web/contacts?url=apify.com" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch('https://pipefetch.com/v1/web/contacts?url=apify.com', {
headers: { 'x-api-key': process.env.PIPEFETCH_API_KEY },
});
const { data, credits } = await res.json();import os, requests
res = requests.get(
"https://pipefetch.com/v1/web/contacts",
params={"url": "apify.com"},
headers={"x-api-key": os.environ["PIPEFETCH_API_KEY"]},
)
data = res.json()["data"]Example response
A real answer to the request above. Long texts and lists are shortened here.
{
"data": {
"url": "https://apify.com/",
"domain": "apify.com",
"companyName": "Apify",
"primaryEmail": "support@apify.com",
"primaryPhone": null,
"emails": [
{
"email": "support@apify.com",
"type": "role",
"onWebsiteDomain": true,
"freeProvider": false,
"mxFound": true,
"foundOn": [
"https://apify.com/",
"https://apify.com/contact"
]
},
{
"email": "hello@apify.com",
"type": "role",
"onWebsiteDomain": true,
"freeProvider": false,
"mxFound": true,
"foundOn": [
"https://apify.com/contact",
"https://docs.apify.com/legal"
]
}
],
"phones": [],
"phonesUncertain": [],
"socials": {
"linkedin": [
"https://www.linkedin.com/company/apify"
],
"facebook": [],
"instagram": [],
"twitter": [
"https://x.com/apify"
],
"youtube": [],
"tiktok": [
"https://www.tiktok.com/@apifytech",
"https://www.tiktok.com/@apifyoffice"
],
"pinterest": [],
"threads": [],
"snapchat": [],
"telegram": [],
"whatsapp": [],
"discord": [
"https://discord.gg/jyEM2PRvMU",
"https://discord.gg/w3e2v7rWDw"
],
"reddit": [],
"github": [
"https://github.com/apify"
],
"bluesky": [],
"medium": []
},
"contactPageUrl": "https://apify.com/contact",
"contactFormUrl": "https://apify.com/contact-sales",
"hasContactForm": true,
"address": "Na Příkopě 959/27, 11000, Prague, CZ",
"country": "CZ",
"language": "en",
"description": "Thousands of tools to automate your business. Get real-time web data, track competitors, generate leads, and integrate your apps and AI agents.",
"logoUrl": "https://apify.com/img/apify-logo/apify-symbol-200x200.svg",
"pagesRead": [
"https://apify.com/",
"https://apify.com/contact"
]
},
"credits": {
"used": 1,
"remaining": 99
}
}Good to know
- The home page is read first, then the pages most likely to hold contact details: contact, imprint, about, team.
- Only what the website itself publishes is returned. Nothing is guessed, and no other source is asked.
- A website with no email, phone or social profile on the pages read answers 404 no_contacts. One that does not exist or does not answer within about 20 seconds answers 404 website_unreachable. Neither costs anything.
Errors
Every error has the same shape, and none of them is charged. The full list is in the error reference.
Looking for an overview and use cases? See the Website Contacts API page.