> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Website Metadata API

> Reads a company's own website and returns what the site says about the company: name, legal name, description, logo, founding date, address, social links and the web technologies it runs. Pass domains. Fields the site does not publish come back blank.

`POST /v1/data/leads/company-research/run`

**Pricing:** $0.01 per companie ($10.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**domains** `string[]` *required*

One or more domains. One request reads them all.

**maxPagesPerDomain** `integer` (default: 3)

How many pages to read on each domain, 1 to 10 (the home page first, then linked about and contact pages). Defaults to 3.

Min `1`; max `10`.

**includeTechHints** `boolean` (default: true)

Include Tech Hints.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/leads/company-research/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "domains": [
      "monzo.com",
      "stripe.com",
      "plausible.io"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/leads/company-research/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "domains": [
        "monzo.com",
        "stripe.com",
        "plausible.io"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/leads/company-research/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "domains": [
    "monzo.com",
    "stripe.com",
    "plausible.io"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one companie, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `domain` | Domain | text |
| `companyName` | Company Name | text |
| `legalName` | Legal Name | text |
| `description` | Description | text |
| `website` | Website | url |
| `logo` | Logo | image |
| `foundingDate` | Founding Date | text |
| `address` | Address | text |
| `country` | Country | text |
| `phones` | Phones | array |
| `emails` | Emails | array |
| `socials` | Socials | object |
| `profileLinks` | Profile Links | array |
| `technologies` | Technologies | array |
| `language` | Language | text |
| `contactPageUrl` | Contact Page URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "leads/company-research",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "socials": {
        "linkedin": "https://www.linkedin.com/company/monzo-bank",
        "x": "https://x.com/monzo",
        "facebook": "https://www.facebook.com/monzobank",
        "instagram": "https://www.instagram.com/monzo",
        "youtube": null,
        "tiktok": null,
        "github": null,
        "pinterest": null
      },
      "logo": "https://monzo.com/static/images/monzo-logo-stacked.svg",
      "emails": [
        "help@monzo.com"
      ],
      "companyName": "Monzo Bank",
      "foundingDate": "2015-02-18",
      "language": "en-GB",
      "phones": [],
      "country": null,
      "domain": "monzo.com",
      "technologies": [
        "Next.js",
        "Amazon CloudFront"
      ],
      "legalName": null,
      "description": "Making money work for everyone",
      "profileLinks": [
        "https://www.facebook.com/monzobank",
        "https://twitter.com/monzo"
      ],
      "website": "https://monzo.com/",
      "address": "Broadwalk House, 5 Appold St, London, EC2A 2AG",
      "contactPageUrl": null
    }
  ]
}
```

## Related APIs

For firmographics, funding and headcount from data providers use [`companies/enrichment`](https://docs.mindcase.co/apis/companies/enrichment); for the site's phones and emails use [`leads/contacts`](https://docs.mindcase.co/apis/leads/contacts).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.