# Website Phones, Emails and Socials API

Get the phone numbers, emails and social profiles a company publishes on its own website. One row per website with the main email and phone, every email and phone found with the page it came from, social profiles, address and logo.

**Pricing:** $0.008 per domain

**Endpoint:** `POST /v1/data/leads/contacts/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `websites` | array | Yes | Websites to look up, one per item, as a URL starting with https:// or a www. address (e.g. https://www.eff.org). Give the home page; the contact and imprint pages are found automatically. Each website returns one row; the same website listed twice returns one row. |
| `maxResults` | integer | No | How many websites to return in total. Defaults to 100; use 0 for all. |

## Example

`?wait=true` holds the request open until the run finishes (up to 60s) and returns the rows inline: one request, no polling.

```bash
curl -X POST "https://api.mindcase.co/v1/data/leads/contacts/run?wait=true" \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"websites":["..."]}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/v1/data/leads/contacts/run",
    params={"wait": "true"},
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {
    "websites": [
        "..."
    ]
}},
)
rows = resp.json()["data"]
```

## Longer runs

If the run is still going at the 60s ceiling you get back `{ job_id, status: "running" }` instead of rows (same if the result is over 100 rows; those come back `truncated`). Poll with that `job_id`:

```bash
# 1) check status
curl https://api.mindcase.co/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, SDKs, MCP): https://mindcase.co/skills.md

## Response columns

| Field | Display name | Type |
|-------|--------------|------|
| `website` | Website | url |
| `inputUrl` | Input URL | url |
| `domain` | Domain | text |
| `businessName` | Business Name | text |
| `description` | Description | text |
| `email` | Email | text |
| `phone` | Phone | phone |
| `emails` | Emails | object_array |
| `phones` | Phones | object_array |
| `socials` | Socials | object |
| `messaging` | Messaging | object |
| `address` | Address | object |
| `contactFormUrl` | Contact Form URL | url |
| `logo` | Logo | url |