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

# Overview

> Use the API or MCP to access your LinkedIn data

TalkToHumans is the safest and simplest LinkedIn outreach tool out there. Use it to find the right people, start conversations, follow up, and manage every reply without risky automation or complex tools.

The public API and MCP expose connected accounts, contacts, network, and conversation records.

Base URL:

```text theme={null}
https://api.talktohumans.app
```

Current public surfaces:

* API: `/v1`
* MCP: `/mcp`

## API Reference

All endpoints live under `/v1`.

### Response envelope

List endpoints return data under a `data` key:

```json theme={null}
{
  "data": {}
}
```

Errors use a structured JSON shape:

```json theme={null}
{
  "code": "bad_request",
  "message": "Invalid request parameters"
}
```

Common status codes:

| Status | Meaning                                                     |
| ------ | ----------------------------------------------------------- |
| `200`  | Request succeeded.                                          |
| `400`  | Invalid query parameter, cursor, account ID, or contact ID. |
| `401`  | Missing, malformed, invalid, or expired credential.         |
| `403`  | API access is not enabled for the workspace.                |
| `429`  | Rate limit exceeded.                                        |
| `500`  | Unexpected server error.                                    |

### Pagination

List endpoints use cursor pagination.

Request parameters:

* `limit`: defaults to `10`; maximum is `25`.
* `cursor`: pass the `data.pagination.next_cursor` value from the previous page.

Response:

```json theme={null}
{
  "pagination": {
    "limit": 10,
    "has_more": true,
    "next_cursor": "eyJ1cGRhdGVkX2F0Ijoi..."
  }
}
```