Scrape contact details from a website via API

1curl -X POST https://YOUR_API_HOST/v1/website-contacts-scraper \
2  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"domain":"python.org","max_pages":5}'

1{
2  "found": true,
3  "data": {
4    "emails": [],
5    "phones": [],
6    "social_profiles": [
7      { "platform": "linkedin", "handle": "company/python-software-foundation",
8        "url": "https://www.linkedin.com/company/python-software-foundation" },
9      { "platform": "x", "handle": "ThePSF", "url": "https://x.com/ThePSF" }
10    ],
11    "pages_scanned": [
12      "https://www.python.org/",
13      "https://www.python.org/about/",
14      "https://www.python.org/about/apps/",
15      "https://www.python.org/about/quotes/",
16      "https://www.python.org/about/gettingstarted/"
17    ],
18    "scanned_at": "2026-10-18T02:06:05.039Z"
19  },
20  "sources": ["https://www.python.org"]
21}

1curl -X POST https://YOUR_API_HOST/v1/website-scraper \
2  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"url":"https://example.com","format":"markdown"}'

1{
2  "found": true,
3  "data": {
4    "final_url": "https://example.com/",
5    "status": 200,
6    "title": "Example Domain",
7    "description": null,
8    "canonical": null,
9    "language": "en",
10    "headings": [],
11    "format": "markdown",
12    "content": "This domain is for use in documentation examples without needing permission. ...",
13    "content_truncated": false,
14    "links": { "internal": [], "external": [] },
15    "images": 0,
16    "word_count": 25,
17    "fetched_at": "2026-10-18T02:06:04.110Z"
18  },
19  "sources": ["https://example.com"]
20}

1const response = await fetch('https://YOUR_API_HOST/v1/website-contacts-scraper', {
2  method: 'POST',
3  headers: {
4    Authorization: `Bearer ${process.env.LOOKVALID_API_KEY}`,
5    'Content-Type': 'application/json',
6  },
7  body: JSON.stringify({ domain: 'python.org', max_pages: 5 }),
8});
9const body = await response.json();
10​
11if (response.status === 503) {
12  // The site was slow or answered with a temporary status. Nothing was charged.
13  console.log('retry later with a pause');
14} else if (response.status === 400) {
15  console.log('bad input', body.error.code, body.error.fix);
16} else if (!body.found) {
17  console.log('nothing to read:', body.reason); // free, and cached
18} else {
19  console.log(body.data.emails, body.data.phones, body.data.social_profiles);
20}