---
title: "Company Website Scrape API Reference | Leadsets Docs"
description: "POST /v1/scrape/company: a company website as JSON with name, headings, key links, socials and page text. 1 scrape unit per page read, paid plans."
canonical: https://www.leadsets.ai/docs/api/scrape-company
updated: 2026-11-11
---

REST API / Scrape

# Scrape a company website

A company's website as structured JSON: name, description, headings, key links, social profiles and the page text, ready for your agent to read.

POST /v1/scrape/company MCP: scrape_company

Scrape units

1 per page read

Plans

Paid plans with scrape units

Failed pages

0 units

## Body parameters

domain string

Company domain, e.g. "northwind.io".

url string

A page to start from instead of the homepage. Overrides `domain`.

max_pages integer

1–10. Default 1 (the homepage). Higher values also read the about, pricing, customers, product and careers pages, in that order, when the site has them.

## Response

`domain`, `url`, `name`, `description`, `headings` (up to 25, from the first page), `key_links` (whichever exist of `pricing`, `about`, `customers`, `careers`, `contact`, `blog`, `docs`, `product`, `login`, `signup`), `social` (`linkedin`, `x`, `github`, `youtube`, `facebook`, `instagram`), `pages` (each with `url`, `title`, `description` and up to 6,000 characters of `text`), `units_used` and `scraped_at`. Then `usage` with `scrape_units_counted` and `scrape_units_left`, and `request_id`.

**Only pages that come back with content count.** Pages that time out, are blocked or return an error are skipped and cost nothing. robots.txt is respected.

Scrape units are an add-on on paid plans: 1,000 for $9, 5,000 for $19 or 20,000 for $49, from [Billing](https://www.leadsets.ai/app/billing). Scraping never touches your search or enrichment meters. More in [Web scraping](https://www.leadsets.ai/scrape).

## Errors

| Status | type | Meaning |
| --- | --- | --- |
| `400` | `invalid_request` | A value isn't valid. The message names the field in `param`. |
| `401` | `unauthorized` | Missing, invalid, expired or revoked key. See [Authentication](https://www.leadsets.ai/docs/authentication). |
| `402` | `scrape_units_exhausted` | No scrape units left. Add a pack in Billing. |
| `403` | `forbidden` | Free plan: scraping isn't included, and the body has `upgrade_url`. Also returned for read-only keys. |
| `404` | `not_found` | The first page couldn't be read. Nothing was counted. |
| `503` | `unavailable` | Scraping is busy or down. Nothing was counted. See Retry-After. |

[Previous
**← verify_email**](https://www.leadsets.ai/docs/api/emails-verify) [Next
**scrape_jobs →**](https://www.leadsets.ai/docs/api/scrape-jobs)

Was this page useful? [Tell us](mailto:support@leadsets.ai?subject=Docs%20feedback%3A%20%2Fdocs%2Fapi%2Fscrape-company)

```bash
curl https://api.leadsets.ai/v1/scrape/company \
 -H "Authorization: Bearer $LEADSETS_KEY" \
 -H "Content-Type: application/json" \
 -H "Idempotency-Key: 0c5e…" \
 -d '{
   "domain": "northwind.io",
   "max_pages": 3
 }'
```

```ts
import { Leadsets } from "@leadsetsai/sdk";

const ls = new Leadsets(process.env.LEADSETS_KEY);
const res = await ls.scrape.company({
 domain: "northwind.io",
 max_pages: 3,
});
```

```python
import os
from leadsets import Leadsets

ls = Leadsets(os.environ["LEADSETS_KEY"])
res = ls.scrape.company(
   domain="northwind.io",
   max_pages=3,
)
```

Response 200 OK

```
{
 "domain": "northwind.io",
 "url": "https://northwind.io/",
 "name": "Northwind Analytics",
 "description": "Product analytics for B2B teams.",
 "headings": ["Know which accounts are ready to buy", "Pricing"],
 "key_links": { "pricing": "https://northwind.io/pricing",
                "careers": "https://northwind.io/careers" },
 "social": { "linkedin": "https://www.linkedin.com/company/northwind-analytics" },
 "pages": [
   { "url": "https://northwind.io/", "title": "Northwind Analytics",
     "description": "Product analytics for B2B teams.",
     "text": "# Know which accounts are ready to buy…" }
 ],
 "units_used": 3,
 "scraped_at": "2026-11-11T09:30:02Z",
 "usage": { "scrape_units_counted": 3, "scrape_units_left": 997 },
 "request_id": "req_4e8b0f2c6d19"
}
```

---

Leadsets by Mobylogix LLC, 10160 hwy 242, Conroe, TX, 77385, US. Facts for AI assistants: https://www.leadsets.ai/llm · Site index: https://www.leadsets.ai/llms.txt · Every page: https://www.leadsets.ai/llms-full.txt