> ## 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.

# Quickstart

## 1. Sign up

Log in at [datacircle.dev/login](https://datacircle.dev/login) with your work email (freemail addresses are refused). You start with $5 of credit, plus $20 for 24 hours if you sign up in launch week (see [Credits](/credits)).

From the API:

```bash theme={null}
curl -X POST https://api.datacircle.dev/auth/send-code/ \
  -H "Content-Type: application/json" -d '{"email": "you@company.com"}'

curl -X POST https://api.datacircle.dev/auth/verify-code/ \
  -H "Content-Type: application/json" -d '{"email": "you@company.com", "code": "123456"}'
```

The response contains your `token` (your API key).

## 2. Spend credits

Credits buy provider data at cost. Already calling HarvestAPI? Change only the host and add two headers. Same paths, same params, same response bytes:

```bash theme={null}
# Find people: heads of sales at Stripe
curl "https://api.datacircle.dev/linkedin/profile-search?search=head%20of%20sales&currentCompany=stripe" \
  -H "X-Datacircle-Provider: harvestapi" -H "X-Datacircle-Key: <api_key>"

# LinkedIn profile
curl "https://api.datacircle.dev/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/" \
  -H "X-Datacircle-Provider: harvestapi" -H "X-Datacircle-Key: <api_key>"

# Work email from a LinkedIn profile
curl "https://api.datacircle.dev/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/&findEmail=true" \
  -H "X-Datacircle-Provider: harvestapi" -H "X-Datacircle-Key: <api_key>"

# LinkedIn company
curl "https://api.datacircle.dev/linkedin/company?url=https://www.linkedin.com/company/microsoft/" \
  -H "X-Datacircle-Provider: harvestapi" -H "X-Datacircle-Key: <api_key>"
```

The body is the provider's own. Our data is in response headers: `X-Datacircle-Cost-USD` (what this call cost), `X-Datacircle-Balance-USD` (what you have left) and `X-Datacircle-Cache-Hit`. Without credit you get a 402.

## 3. Get the flat file

```bash theme={null}
curl https://api.datacircle.dev/files/ -H "Authorization: Token <api_key>"
curl -X POST https://api.datacircle.dev/files/<file_id>/download-link/ -H "Authorization: Token <api_key>"
```


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