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

# Files

> The free dataset and the daily Parquet file of every profile fetched through Datacircle.

```bash theme={null}
curl https://api.datacircle.dev/files/ -H "Authorization: Token $DATACIRCLE_API_KEY"
```

Each file has a `rank` (its tier), `row_count`, `size_bytes`, `sha256`, `created_at`, and `allowed`, which says whether this workspace may download it:

| Tier | What | Who |
| - | - | - |
| `free` | the 10M+ US B2B leads dataset: a 2.8 GB zip of two Parquet files, 11.1M people and 1.75M companies | everyone |
| `large` | the 50M+ US B2B dataset: an 11.9 GB zip of `person_us.parquet` and `company_us.parquet` | 3 people you invited signed up, or your workspace bought \$50 of credit |
| `sample` | the first 1,000 rows of today's profile file | everyone |
| `full` | every public profile anyone fetched through Datacircle, as one Parquet file | 3 people you invited signed up, or your workspace bought \$50 of credit |

Every morning a new file is published. Each one is a full snapshot of everything so far, so you only ever need the latest.

```bash theme={null}
curl -X POST https://api.datacircle.dev/files/$FILE_ID/download-link/ \
  -H "Authorization: Token $DATACIRCLE_API_KEY"
```

Returns a download `url` valid for one hour, or `403` if the file is not unlocked for this workspace.

## Invites

```bash theme={null}
curl https://api.datacircle.dev/me/invites/ -H "Authorization: Token $DATACIRCLE_API_KEY"
```

Returns your `invite_link`, how many people you invited have `signed_up` (verified their work email), and how many are `needed` (3). Send the link; once 3 have signed up, `large` and `full` unlock for you.

The file only holds public LinkedIn profile fields. It never contains who fetched what, emails of Datacircle users, costs or any credential.

```python theme={null}
import pandas as pd
profiles = pd.read_parquet("linkedin_profiles_full.parquet")
```


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