Quickstart - Datacircle

Log in at 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). From the API:

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:

# 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

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>"