datacircle

1# Datacircle
2 
3## Purpose
4Datacircle is a data co-op. Query your favorite B2B data APIs through us. Same request, same price, no markup. Right now we have 3 live LinkedIn profile APIs that we trust: Up2Data, HarvestAPI and Fetchin.
5 
6Use it when the user gives a LinkedIn profile URL and wants that person's profile (role, company, history, skills), or asks for their Datacircle balance. Each request goes to the provider and gets the profile as it is today.
7 
8## Tooling
9All commands go through `bin/datacircle.py`:
10 
11```bash
12bin/datacircle.py auth                      # verify the connection
13bin/datacircle.py balance                   # the balance in dollars, free
14bin/datacircle.py profile --url https://www.linkedin.com/in/williamhgates             # prints the price, looks nothing up
15bin/datacircle.py profile --url https://www.linkedin.com/in/williamhgates --confirm   # one paid lookup through Up2Data
16bin/datacircle.py profile --url https://www.linkedin.com/in/williamhgates --provider harvestapi --confirm
17```
18 
19## Auth
20- Provider id: `datacircle` (credential is collected as `custom.datacircle`)
21- Collection: API key via the secure credential flow (`credentials.request_api_access`)
22- Get a key: sign up at datacircle.dev with your work email. The key is on the page once you're in.
23- Allowed hosts: `api.datacircle.dev`
24- Status check: `bin/datacircle.py auth` (must return `"ok": true`)
25- Sent as `Authorization: Bearer <key>`
26 
27## Operating Rules
28…