> ## 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. # Enrich one LinkedIn profile > Send Up2Data's own request (`POST https://api.up2data.ai/v1/profiles/enrich`) to api.datacircle.dev, with your Datacircle key in `Authorization` and `X-Data-Provider: up2data`. The path and the body stay the same. We charge $0.002375 per profile Up2Data finds, with no markup. ## OpenAPI ````yaml /openapi.json post /v1/profiles/enrich openapi: 3.1.0 info: title: Datacircle API version: '1' description: >- Datacircle is a data co-op. Step 1: Query your favorite B2B data APIs through us. Same request, same price, no markup. Step 2: You're DONE. Every morning, you get the flat file of your data plus everyone else's. You send the provider's own request to api.datacircle.dev, with your Datacircle key. That's the only change. Right now we have 3 live LinkedIn profile APIs that we trust: Up2Data, HarvestAPI and Fetchin. Each request goes to the provider and gets the profile as it is today. Add \$50 to your account: you get \$50 of API PLUS the flat file. Sign up at datacircle.dev with your work email: a \$5 credit, that's 2,105 LinkedIn profiles at \$2.375 per 1,000. Use it from Claude, ChatGPT or Cursor: add api.datacircle.dev/mcp as an MCP server. The docs: [docs.datacircle.dev](https://docs.datacircle.dev). termsOfService: https://datacircle.dev/terms contact: name: Datacircle url: https://datacircle.dev email: wayne@datacircle.dev x-logo: url: https://datacircle.dev/favicon.png altText: Datacircle servers: - url: https://api.datacircle.dev security: - token: [] tags: - name: Datacircle description: 'Your Datacircle account: balance, adding funds, files, API key.' - name: Up2Data description: >- LinkedIn Profile API: Up2Data's own request, sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: up2data`. - name: HarvestAPI description: >- LinkedIn Profile API: HarvestAPI's own request, sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: harvestapi`. - name: Fetchin description: >- LinkedIn Profile API: Fetchin's own request, sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: fetchin`. externalDocs: description: Datacircle docs url: https://docs.datacircle.dev paths: /v1/profiles/enrich: post: tags: - Up2Data summary: Enrich one LinkedIn profile description: >- Send Up2Data's own request (`POST https://api.up2data.ai/v1/profiles/enrich`) to api.datacircle.dev, with your Datacircle key in `Authorization` and `X-Data-Provider: up2data`. The path and the body stay the same. We charge $0.002375 per profile Up2Data finds, with no markup. parameters: - name: X-Data-Provider in: header required: true description: >- Names the provider: `up2data`. This header and the host are the only changes from the provider's own request. schema: type: string enum: - up2data default: up2data example: up2data requestBody: required: true content: application/json: schema: type: object required: - url properties: url: type: string description: >- The profile's LinkedIn URL (`https://www.linkedin.com/in/williamhgates`). Up2Data refuses a bare public identifier with its own `400` fields: type: array items: type: string description: >- Restrict response to these top-level fields. Same cost. Listing `followers_count` or `connections_count` also opts into the extra scrape. Listing `skill_endorsements` also opts into the full-skills scrape. with_followers_and_connections: type: boolean default: false description: > Include `followers_count` and `connections_count`. Off by default: those numbers are a second LinkedIn request, not part of the main profile scrape. Same price. Extra latency. with_full_skills_and_endorsements: type: boolean default: false description: >- Return every skill LinkedIn shows (up to LinkedIn's 50-skill cap) plus `skill_endorsements`. Off by default: without it you get the first 20 skills, and turning it on adds a second LinkedIn request. It costs nothing extra but takes longer. additionalProperties: false example: url: https://www.linkedin.com/in/williamhgates responses: '200': description: Up2Data's answer plus `datacircle_meta` content: application/json: schema: $ref: '#/components/schemas/Up2DataEnrichResponse' example: data: url: https://www.linkedin.com/in/williamhgates full_name: … first_name: … last_name: … public_identifier: … headline: … location: city: … region: … country: … raw: … about: … urn: … linkedin_id: … profile_urn: … positions: - title: … company: … company_url: … linkedin_id: … position_id: … started_at: … ended_at: null company_industry: … company_headcount: … company_logo_url: … current_company: name: … url: … linkedin_id: … title: … started_at: … logo_url: … industry: … headcount: … education: - school: … education_id: … school_logo_url: … started_at: … ended_at: … primary_locale: … is_premium: true is_open_to_work: false profile_picture_url: … scraped_at: … meta: creditsUsed: 1 billed: true reason: profile_found datacircle_meta: provider: up2data cost_usd: 0.002375 balance_usd: 4.997625 '400': description: >- Not charged. A body that isn't a non-empty JSON object, or an `X-Data-Provider` value that isn't `up2data`, `harvestapi` or `fetchin` (`Error`). Or Up2Data's own `400`, passed on (`Up2DataError`, `error.type: invalid_request`): a `url` that isn't a LinkedIn profile URL, a field Up2Data doesn't take content: application/json: schema: anyOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/Up2DataError' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Balance too low content: application/json: schema: type: object required: - error - balance_usd properties: error: type: string description: >- Why the call was refused: your balance can't cover it. Not charged. balance_usd: type: number description: >- Your balance now, in dollars (`balance_usd` in `GET /balance/`). `POST /checkout/` adds funds. additionalProperties: false '404': description: >- No `X-Data-Provider` header, or a path Datacircle doesn't call for that provider (e.g. `X-Data-Provider: harvestapi` on `/v1/profiles/enrich`). Not charged content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: >- Up2Data can't reach that profile (private, deleted or unreachable). Not charged content: application/json: schema: $ref: '#/components/schemas/Up2DataError' '429': description: >- Datacircle's daily Up2Data limit, for your account or for everyone (it resets at 00:00 UTC), or Up2Data's own rate limit. Not charged content: application/json: schema: anyOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/Up2DataError' '502': description: >- Up2Data's own server failed three times in a row: its gateway answered an error page each time, and Datacircle sent the same request again twice before passing the last page on. Not charged. Send the same request again. A gateway's `503` or `504` page passes on the same way, with its status. '503': description: >- Up2Data hasn't answered within 45 s, retries included, or can't be reached: Datacircle stops waiting. Not charged. Send the same request again. content: application/json: schema: type: object description: >- Datacircle's own answer when the provider hasn't answered within 45 s, retries included, or can't be reached. Not charged. required: - error - balance_usd properties: error: type: string description: What went wrong, in plain words. balance_usd: type: number description: >- Your balance now, in dollars (`balance_usd` in `GET /balance/`). additionalProperties: false x-codeSamples: - lang: bash label: curl source: |- curl -X POST "https://api.datacircle.dev/v1/profiles/enrich" \ -H "Authorization: Token $DATACIRCLE_API_KEY" \ -H "X-Data-Provider: up2data" \ -H "Content-Type: application/json" \ -d '{"url": "https://www.linkedin.com/in/williamhgates"}' - lang: python label: Python source: |- import os import requests response = requests.post( "https://api.datacircle.dev/v1/profiles/enrich", headers={"Authorization": f"Token {os.environ['DATACIRCLE_API_KEY']}", "X-Data-Provider": "up2data"}, json={'url': 'https://www.linkedin.com/in/williamhgates'}, ) print(response.json()) components: schemas: Up2DataEnrichResponse: type: object required: - data - meta - datacircle_meta properties: data: $ref: '#/components/schemas/Up2DataProfile' meta: $ref: '#/components/schemas/Up2DataMeta' datacircle_meta: $ref: '#/components/schemas/DatacircleMeta' additionalProperties: false Error: type: object required: - error properties: error: type: string description: What went wrong, in plain words. Up2DataError: type: object properties: error: type: object properties: type: type: string enum: - invalid_request - invalid_api_key - insufficient_credits - not_found - unprocessable_target - rate_limited - internal_error - upstream_error - upstream_timeout description: 'Up2Data''s error type: what went wrong (docs.up2data.ai/errors).' message: type: string description: What went wrong, in Up2Data's words. additionalProperties: false description: Up2Data's error. meta: $ref: '#/components/schemas/Up2DataMeta' datacircle_meta: $ref: '#/components/schemas/DatacircleMeta' additionalProperties: false description: Up2Data's own error answer, plus `datacircle_meta` required: - error Up2DataProfile: type: object properties: url: type: string description: Canonical profile URL. public_identifier: type: string description: 'The profile''s slug: `linkedin.com/in/`.' linkedin_id: type: string description: Numeric LinkedIn member ID. full_name: type: string description: The member's full name. first_name: type: string description: The member's first name. last_name: type: string description: The member's last name. headline: type: string description: The line under the member's name on the profile. location: type: object properties: city: type: string description: City. region: type: string description: State or region. country: type: string description: Country name (e.g. `United States`). raw: type: string description: >- The location exactly as LinkedIn shows it (e.g. "Greater Seattle Area"), before parsing. additionalProperties: false description: >- Where the member is: `raw` as LinkedIn shows it, parsed into `city`, `region` and `country`. current_company: type: object properties: name: type: string description: The company's name. url: type: string description: The company's LinkedIn page URL. title: type: string description: The member's title there. started_at: type: string description: When the role started, `YYYY-MM` or `YYYY`. linkedin_id: type: string description: Numeric LinkedIn organization ID. logo_url: type: string description: The company's logo (a LinkedIn CDN link, which expires). industry: type: string description: The company's LinkedIn industry. headcount: type: string description: The company's size band on LinkedIn, e.g. `10001+`. additionalProperties: false description: The member's current role and its company. positions: type: array items: type: object properties: title: type: string description: The member's title in this role. company: type: string description: The company's name. company_url: type: string description: The company's LinkedIn page URL. linkedin_id: type: string description: Numeric LinkedIn organization ID for this role's company. position_id: type: string description: LinkedIn's id of this role (`urn:li:fsd_profilePosition:...`). started_at: type: string description: When the role started, `YYYY-MM` or `YYYY`. ended_at: type: - string - 'null' description: >- When the role ended, `YYYY-MM` or `YYYY`. `null` for a current role. description: type: string description: The role's description. skills: type: array items: type: string description: Skills the member tied to this role. company_industry: type: string description: The company's LinkedIn industry. company_headcount: type: string description: The company's size band on LinkedIn, e.g. `10001+`. company_logo_url: type: string description: The company's logo (a LinkedIn CDN link, which expires). additionalProperties: false description: Full experience history, current roles included. education: type: array items: type: object properties: school: type: string description: The school's name. degree: type: string description: The degree. field: type: string description: The field of study. activities: type: string description: Activities and societies. education_id: type: string description: >- LinkedIn's id of this entry (`urn:li:fsd_profileEducation:...`). school_logo_url: type: string description: The school's logo (a LinkedIn CDN link, which expires). description: type: string description: The entry's description. started_at: type: string description: When it started, `YYYY-MM` or `YYYY`. ended_at: type: - string - 'null' description: When it ended, `YYYY-MM` or `YYYY`. `null` when ongoing. additionalProperties: false description: Education history. skills: type: array items: type: string description: > Capped at the first 20 unless `with_full_skills_and_endorsements` is true, in which case every skill LinkedIn exposes is returned (up to LinkedIn's own 50-skill cap). skill_endorsements: type: array description: >- Present when `with_full_skills_and_endorsements` is true (or listed in `fields`). items: type: object properties: name: type: string description: The skill. endorsement_count: type: integer description: How many members endorsed it. additionalProperties: false about: type: string description: The profile's About section. urn: type: string description: | `urn:li:member:{id}` on enrich. profile_urn: type: string description: > `urn:li:fsd_profile:{ACo…}`, the profile id Sales Navigator and LinkedIn messaging use. languages: type: array items: type: string description: Language names listed on the profile. Omitted when none are listed. language_proficiencies: type: array description: >- The same languages as `languages`, with the proficiency the member chose, when they chose one. items: type: object properties: name: type: string description: The language. proficiency: type: string enum: - NATIVE_OR_BILINGUAL - FULL_PROFESSIONAL - PROFESSIONAL_WORKING - LIMITED_WORKING - ELEMENTARY description: >- The proficiency the member chose. Omitted when they chose none. additionalProperties: false certifications: type: array items: type: object properties: name: type: string description: The certification's name. authority: type: string description: Who issued it. issued_at: type: string description: When it was issued, `YYYY-MM` or `YYYY`. expires_at: type: string description: When it expires, `YYYY-MM` or `YYYY`. url: type: string description: The credential's URL. linkedin_id: type: string description: >- Numeric LinkedIn company id of the issuing organization, when listed. license_number: type: string description: License or credential number, when listed on the certificate. additionalProperties: false description: Licenses and certifications on the profile. publications: type: array items: type: object properties: title: type: string description: The publication's title. publisher: type: string description: Its publisher. published_at: type: string description: When it was published, `YYYY-MM` or `YYYY`. url: type: string description: Its URL. description: type: string description: Its description. authors: type: array items: type: object description: A person credited on a publication or patent. properties: name: type: string description: The person's name. public_identifier: type: string description: >- Their profile's slug (`linkedin.com/in/`), when they are on LinkedIn. headline: type: string description: Their profile's headline, when they are on LinkedIn. additionalProperties: false description: Its authors. additionalProperties: false description: Publications on the profile. patents: type: array items: type: object properties: title: type: string description: The patent's title. number: type: string description: The patent or application number (e.g. `10,127,086`). issuer: type: string description: Patent office country code as LinkedIn lists it (e.g. "us"). issued_at: type: string description: When it was issued, `YYYY-MM` or `YYYY`. description: type: string description: Its description. inventors: type: array items: type: object description: A person credited on a publication or patent. properties: name: type: string description: The person's name. public_identifier: type: string description: >- Their profile's slug (`linkedin.com/in/`), when they are on LinkedIn. headline: type: string description: Their profile's headline, when they are on LinkedIn. additionalProperties: false description: Its inventors. additionalProperties: false description: Patents on the profile. awards: type: array items: type: object properties: title: type: string description: The award's title. issuer: type: string description: Who gave it. issued_at: type: string description: When it was received, `YYYY-MM` or `YYYY`. description: type: string description: Its description. additionalProperties: false description: Honors and awards on the profile. primary_locale: type: string description: LinkedIn primary locale as `language_COUNTRY`, e.g. `en_US`. is_premium: type: boolean description: '`true` when the member has LinkedIn Premium.' is_open_to_work: type: boolean description: '`true` when the member shows they are open to work.' connections_count: type: integer description: >- Included when `with_followers_and_connections` is true (or listed in `fields`). followers_count: type: integer description: >- Included when `with_followers_and_connections` is true (or listed in `fields`). scraped_at: type: string format: date-time description: When Up2Data scraped this profile from LinkedIn (ISO 8601). profile_picture_url: type: string description: LinkedIn headshot CDN URL. additionalProperties: false description: >- Up2Data's profile record, every field as Up2Data documents it (docs.up2data.ai). `fields` in the request restricts it to the fields listed. Up2DataMeta: type: object description: >- Up2Data's billing metadata, minus `creditsRemaining`, `requestId` and `latencyMs` (our account with Up2Data, not yours) properties: creditsUsed: type: integer description: >- Up2Data credits this call used (1 per profile found). What it costs you is `datacircle_meta.cost_usd`: $0.002375 per Up2Data credit billed: type: boolean description: >- Whether Up2Data billed this call (`false`: it didn't, and you weren't charged). What this call costs you is `datacircle_meta.cost_usd` reason: type: string description: >- Why Up2Data billed this call or not, in its words, e.g. `profile_found`. additionalProperties: false DatacircleMeta: type: object description: Datacircle's only addition to the provider's answer required: - provider - cost_usd - balance_usd properties: provider: type: string enum: - up2data - harvestapi - fetchin description: Which provider answered cost_usd: type: number description: 'What this call cost, in dollars: the provider''s price, no markup' balance_usd: type: number description: >- Your balance after this call, in dollars (`balance_usd` in `GET /balance/`) additionalProperties: false securitySchemes: token: type: http scheme: bearer description: >- Your API key: `Authorization: Bearer `. `Authorization: Token ` works too. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.