> ## Documentation Index > Fetch the complete documentation index at: https://idle.docs.datacircle.dev/llms.txt > Use this file to discover all available pages before exploring further. # Enrich one LinkedIn profile > iBlinked's own request (https://api.iblinked.fr/v1/enrich/single), sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: iblinked`. Nothing else changes. ## OpenAPI ````yaml /openapi.json post /v1/enrich/single openapi: 3.1.0 info: title: Datacircle API version: '1' servers: - url: https://idle.api.datacircle.dev security: - token: [] tags: - name: Datacircle description: 'Your Datacircle account: credits, checkout, files, invites, API key.' - name: iBlinked description: >- LinkedIn Profile API: iBlinked's own request, sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: iblinked`. - name: Up2Data description: >- LinkedIn Profile API: Up2Data's own request, sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: up2data`. paths: /v1/enrich/single: post: tags: - iBlinked summary: Enrich one LinkedIn profile description: >- iBlinked's own request (https://api.iblinked.fr/v1/enrich/single), sent to api.datacircle.dev with your Datacircle key and `X-Data-Provider: iblinked`. Nothing else changes. parameters: - name: X-Data-Provider in: header required: true description: >- names the provider: `iblinked`. With the host, the only change from the provider's own request. schema: type: string enum: - iblinked default: iblinked example: iblinked requestBody: required: true content: application/json: schema: type: object required: - token properties: token: type: string description: >- the LinkedIn profile slug or member token, as in iBlinked's docs (e.g. `williamhgates`) include: type: array items: type: string description: >- as in iBlinked's docs; Datacircle always asks iBlinked for `all`, at the same one-credit price additionalProperties: false example: token: williamhgates include: - all responses: '200': description: >- iBlinked's answer plus `datacircle_meta`; a profile iBlinked can't find is `data.found: false`, not charged content: application/json: schema: $ref: '#/components/schemas/IBlinkedEnrichResponse' '400': description: No `token`, or a body that isn't a JSON object content: application/json: schema: $ref: '#/components/schemas/Error' '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 USD (`balance_usd` in `GET /credits/`). `POST /checkout/` buys more. additionalProperties: false x-codeSamples: - lang: bash label: curl source: |- curl -X POST "https://idle.api.datacircle.dev/v1/enrich/single" \ -H "Authorization: Token $DATACIRCLE_API_KEY" \ -H "X-Data-Provider: iblinked" \ -H "Content-Type: application/json" \ -d '{"token": "williamhgates", "include": ["all"]}' - lang: python label: Python source: |- import os import requests response = requests.post( "https://idle.api.datacircle.dev/v1/enrich/single", headers={"Authorization": f"Token {os.environ['DATACIRCLE_API_KEY']}", "X-Data-Provider": "iblinked"}, json={'token': 'williamhgates', 'include': ['all']}, ) print(response.json()) components: schemas: IBlinkedEnrichResponse: type: object description: >- iBlinked's own response to POST /v1/enrich/single, plus `datacircle_meta` required: - success - data - error - metadata - datacircle_meta properties: success: type: boolean description: >- iBlinked's own flag: `true` when it answered, a profile it can't find included (`data.found: false`). data: anyOf: - $ref: '#/components/schemas/IBlinkedProfile' - $ref: '#/components/schemas/IBlinkedNotFound' description: >- The profile, or `{"found": false, "token": ...}` when iBlinked has no such profile (not charged). error: type: - string - object - 'null' description: iBlinked's error; `null` when there is none. metadata: type: object properties: last_refreshed_at: type: string description: When iBlinked last read this profile from LinkedIn (ISO 8601). request_id: type: string description: >- iBlinked's id of this request: quote it to report a wrong answer. served_from: type: string description: >- Where iBlinked served this answer from: `cache` (its stored copy, as fresh as `last_refreshed_at`), or `not_found`. tier: type: string description: iBlinked's price tier for this answer, e.g. `cache`. unit_cost: type: number description: >- iBlinked's price of one profile, in iBlinked credits. What you were charged is `datacircle_meta.credits_cost`: 0.001 USD per credit iBlinked billed, 0 when it billed none (not found, or Datacircle answered from what it holds). additionalProperties: false description: iBlinked's metadata about this answer. datacircle_meta: $ref: '#/components/schemas/DatacircleMeta' additionalProperties: false Error: type: object required: - error properties: error: type: string description: What went wrong, in plain words. IBlinkedProfile: description: iBlinked's profile, as iBlinked answers it type: object properties: certifications: type: array items: type: object properties: authority: type: string description: Who issued it. company_id: type: - number - 'null' description: >- LinkedIn company id of the issuer; `0` or `null` when LinkedIn links none. ended_on: type: - string - 'null' description: When it expires, as LinkedIn shows it; `null` when it doesn't. license_number: type: - string - 'null' description: License or credential number; `null` when not listed. name: type: string description: The certification's name. position: type: number description: Its order on the profile, from 0. started_on: type: - string - 'null' description: >- When it was issued, as LinkedIn shows it; `null` when not listed. url: type: - string - 'null' description: The credential's URL; `null` when not listed. additionalProperties: false description: Licenses and certifications on the profile; empty when none. courses: type: array items: type: object properties: name: type: string description: The course's name. number: type: - string - 'null' description: The course's number; `null` when not listed. position: type: number description: Its order on the profile, from 0. additionalProperties: false description: Courses listed on the profile; empty when none. current_companies: type: array items: type: object properties: company_id: type: - number - 'null' description: >- LinkedIn company id; `null` when the company has no LinkedIn page. company_name: type: string description: The company's name as on the profile. entreprise: type: - object - 'null' properties: company_type: type: string description: >- The company's type as on its LinkedIn page, e.g. `Privately Held`, `Public Company`, `Nonprofit`. country_code: type: string description: Headquarters country, ISO 3166-1 alpha-2 (e.g. `US`). description: type: string description: The About text of the company's LinkedIn page. follower_count: type: - number - 'null' description: >- Followers of the company's LinkedIn page; `null` when unknown. founded_year: type: - number - 'null' description: Year the company was founded; `null` when not listed. hq_city: type: string description: Headquarters city. hq_region: type: - string - 'null' description: Headquarters state or region; `null` when not listed. industry: type: string description: The company's LinkedIn industry. linkedin_url: type: string description: The company's LinkedIn page URL. logo_url: type: - string - 'null' description: >- The company's logo (a LinkedIn CDN link, which expires); `null` when there is none. name: type: string description: The company's name. region: type: string description: >- iBlinked's world region of the headquarters, e.g. `na` (North America). revenue_range: type: - string - number - boolean - 'null' description: >- The company's revenue range when iBlinked has one; `null` otherwise. slug: type: string description: 'The company page''s slug: linkedin.com/company/.' specialties: type: - array - 'null' items: type: string description: >- Specialties listed on the company's LinkedIn page; `null` when none. staff_count: type: number description: LinkedIn members who list this company as their employer. staff_count_range: type: string description: The company's size band on LinkedIn, e.g. `51-200`. tagline: type: - string - 'null' description: The company page's tagline; `null` when none. website_url: type: - string - 'null' description: The company's website; `null` when not listed. additionalProperties: false description: The company's LinkedIn page; `null` when it has none. is_top_card: type: boolean description: >- `true` when LinkedIn shows this company in the profile's header. titles: type: array items: type: string description: The member's current titles at this company. additionalProperties: false description: Every company the member works at now, one entry per company. current_company_id: type: - number - 'null' description: >- LinkedIn company id of the member's main current company; `null` when it has no LinkedIn page. current_company_name: type: string description: The member's main current company. current_title: type: string description: The member's title at `current_company_name`. first_name: type: string description: The member's first name. follower_count: type: number description: The member's LinkedIn followers. geo_id: type: number description: LinkedIn's geo id of `location`. headline: type: string description: The line under the member's name on the profile. honors: type: array items: type: object properties: issued_on: type: string description: When it was received, as LinkedIn shows it (e.g. `04/2024`). issuer: type: - string - 'null' description: Who gave it; `null` when not listed. position: type: number description: Its order on the profile, from 0. title: type: string description: The honor's title. additionalProperties: false description: Honors and awards on the profile; empty when none. industry: type: string description: The member's LinkedIn industry. industry_id: type: number description: LinkedIn's id of `industry`. job_function: type: - string - 'null' description: >- iBlinked's job function for the member's current role; `null` when it has none. last_name: type: string description: The member's last name. last_refreshed_at: type: string description: When iBlinked last read this profile from LinkedIn (ISO 8601). location: type: string description: The member's location as LinkedIn shows it. location_country: type: string description: Country of `location`, ISO 3166-1 alpha-2 (e.g. `US`). member_id: type: number description: The member's numeric LinkedIn id. num_connections: type: number description: The member's LinkedIn connections, as iBlinked read them. patents: type: array items: type: object properties: $type: type: string description: LinkedIn's internal type of the record. id: type: number description: LinkedIn's id of the patent. inventors: type: array items: type: object properties: $type: type: string description: LinkedIn's internal type of the record. linkedInMember: type: string description: LinkedIn URN of the inventor's member profile. linkedInMemberUrn: type: string description: >- LinkedIn URN of the inventor's member profile (same as `linkedInMember`). member: type: string description: LinkedIn URN of the inventor's profile. memberUrn: type: string description: >- LinkedIn URN of the inventor's profile (same as `member`). additionalProperties: false description: The patent's inventors who are on LinkedIn. issuer: type: string description: Patent office, as a country code (e.g. `us`). pending: type: boolean description: '`true` for an application not granted yet.' title: type: string description: The patent's title. additionalProperties: false description: Patents on the profile; empty when none. personal_website: type: - string - 'null' description: The website the member lists on the profile; `null` when none. photo_root_url: type: - string - 'null' description: >- First part of the photo URL: `photo_root_url` + `photo_segment` = `photo_url`; `null` when no photo. photo_segment: type: - string - 'null' description: >- Second part of the photo URL (size and signature); `null` when no photo. photo_url: type: - string - 'null' description: >- The member's profile photo (a LinkedIn CDN link, which expires); `null` when no photo. publications: type: array items: type: object properties: authors_count: type: number description: How many authors the publication lists. description: type: - string - 'null' description: The publication's description; `null` when none. name: type: string description: The publication's title. position: type: number description: Its order on the profile, from 0. published_on: type: - string - 'null' description: >- When it was published, as LinkedIn shows it; `null` when not listed. publisher: type: - string - 'null' description: Its publisher; `null` when not listed. url: type: - string - 'null' description: Its URL; `null` when not listed. additionalProperties: false description: Publications on the profile; empty when none. recommendations: type: array items: type: object properties: created: type: number description: When it was written, Unix time in milliseconds. recommender_urn: type: string description: LinkedIn URN of who wrote it. relationship: type: string description: >- How the recommender knew the member, as LinkedIn's code (e.g. `RECOMMENDER_SENIOR_THAN_RECOMMENDEE`). text: type: string description: The recommendation's text. additionalProperties: false description: Recommendations the member received; empty when none. region: type: string description: iBlinked's world region of the member, e.g. `na` (North America). sections: type: object properties: educations: type: array items: type: object properties: activities: type: - string - 'null' description: Activities and societies; `null` when not listed. degree_name: type: - string - 'null' description: The degree; `null` when not listed. description: type: - string - 'null' description: The entry's description; `null` when none. ecole: type: - object - 'null' properties: address_country: type: string description: The school's country, ISO 3166-1 alpha-2 (e.g. `US`). address_locality: type: string description: The school's city. address_postal: type: - string - 'null' description: The school's postal code; `null` when not listed. address_region: type: - string - 'null' description: The school's state or region; `null` when not listed. address_street: type: - string - 'null' description: The school's street address; `null` when not listed. description: type: string description: The About text of the school's LinkedIn page. linkedin_url: type: string description: The school's LinkedIn page URL. logo_url: type: string description: >- The school's logo (a LinkedIn CDN link, which expires). school_type: type: string description: >- The school's type as on its LinkedIn page, e.g. `Educational Institution`. slogan: type: - string - 'null' description: The school page's tagline; `null` when none. slug: type: string description: 'The school page''s slug: linkedin.com/school/.' staff_count: type: number description: >- LinkedIn members who list this school as their employer. student_count: type: - string - number - boolean - 'null' description: The school's students when listed; `null` otherwise. website: type: string description: The school's website. additionalProperties: false description: The school's LinkedIn page; `null` when it has none. ended_on: type: - string - 'null' description: >- When it ended, `YYYY-MM-DD` (January 1st when LinkedIn shows only a year); `null` when not listed. field_of_study: type: - string - 'null' description: The field of study; `null` when not listed. grade: type: - string - number - boolean - 'null' description: The grade; `null` when not listed. is_top_card: type: boolean description: >- `true` when LinkedIn shows this school in the profile's header. kind: type: string description: iBlinked's kind of entry, e.g. `institution`. school_id: type: - number - 'null' description: >- LinkedIn id of the school; `null` when it has no LinkedIn page. school_name: type: string description: The school's name as on the profile. started_on: type: - string - 'null' description: >- When it started, `YYYY-MM-DD` (January 1st when LinkedIn shows only a year); `null` when not listed. additionalProperties: false description: Education history; empty when none. experiences: type: array items: type: object properties: company_id: type: - number - 'null' description: >- LinkedIn company id; `null` when the company has no LinkedIn page. company_name: type: string description: The company's name as on the profile. description: type: - string - 'null' description: The role's description; `null` when none. employment_status: type: - string - 'null' description: >- The employment type (e.g. full-time, part-time); `null` when not listed. ended_on: type: - string - 'null' description: >- When the role ended, `YYYY-MM-DD`; `null` for a current role. entreprise: type: - object - 'null' properties: company_type: type: string description: >- The company's type as on its LinkedIn page, e.g. `Privately Held`, `Public Company`, `Nonprofit`. country_code: type: - string - 'null' description: Headquarters country, ISO 3166-1 alpha-2 (e.g. `US`). description: type: string description: The About text of the company's LinkedIn page. follower_count: type: - number - 'null' description: >- Followers of the company's LinkedIn page; `null` when unknown. founded_year: type: - number - 'null' description: Year the company was founded; `null` when not listed. hq_city: type: - string - 'null' description: Headquarters city. hq_region: type: - string - 'null' description: Headquarters state or region; `null` when not listed. industry: type: string description: The company's LinkedIn industry. linkedin_url: type: string description: The company's LinkedIn page URL. logo_url: type: - string - 'null' description: >- The company's logo (a LinkedIn CDN link, which expires); `null` when there is none. name: type: string description: The company's name. region: type: string description: >- iBlinked's world region of the headquarters, e.g. `na` (North America). revenue_range: type: - string - number - boolean - 'null' description: >- The company's revenue range when iBlinked has one; `null` otherwise. slug: type: string description: 'The company page''s slug: linkedin.com/company/.' specialties: type: - array - 'null' items: type: string description: >- Specialties listed on the company's LinkedIn page; `null` when none. staff_count: type: number description: >- LinkedIn members who list this company as their employer. staff_count_range: type: string description: The company's size band on LinkedIn, e.g. `51-200`. tagline: type: - string - 'null' description: The company page's tagline; `null` when none. website_url: type: - string - 'null' description: The company's website; `null` when not listed. additionalProperties: false description: The company's LinkedIn page; `null` when it has none. is_current: type: boolean description: '`true` for a role the member still holds.' is_top_card: type: boolean description: >- `true` when LinkedIn shows this company in the profile's header. location: type: - string - 'null' description: Where the role is; `null` when not listed. started_on: type: string description: >- When the role started, `YYYY-MM-DD` (January 1st when LinkedIn shows only a year). title: type: string description: The member's title in this role. additionalProperties: false description: Work history, current roles included; empty when none. languages: type: array items: type: object properties: name: type: string description: The language. proficiency: type: - string - 'null' description: >- LinkedIn's proficiency code, e.g. `ELEMENTARY`, `NATIVE_OR_BILINGUAL`; `null` when the member chose none. additionalProperties: false description: Languages on the profile; empty when none. skills: type: array items: type: object properties: assessment_verified: type: - boolean - 'null' description: >- `true` when the member passed LinkedIn's assessment for this skill; `null` when unknown. endorsement_count: type: number description: How many members endorsed this skill. name: type: string description: The skill. additionalProperties: false description: Skills on the profile; empty when none. additionalProperties: false description: The profile's education, experience, languages and skills. seniority: type: - string - 'null' description: >- iBlinked's seniority level for the member's current role; `null` when it has none. served_from: type: string description: >- Where iBlinked served this profile from, e.g. `cache` (its stored copy, as fresh as `last_refreshed_at`). slug: type: string description: 'The profile''s public slug: linkedin.com/in/.' sub_role: type: string description: iBlinked's normalized `current_title`, lowercase (e.g. `co chair`). summary: type: - string - 'null' description: The profile's About text; `null` when empty. test_scores: type: array items: type: - string - number - boolean - 'null' - object description: Test scores on the profile; empty when none. token: type: string description: >- iBlinked's id of the profile, the LinkedIn member token (`ACoAA…`): send it as `token` to fetch the same profile. volunteering: type: array items: type: object properties: cause: type: string description: The cause, as LinkedIn's code (e.g. `environment`). company_id: type: - number - 'null' description: >- LinkedIn company id of the organization; `null` when it has no LinkedIn page. company_name: type: string description: The organization. description: type: - string - 'null' description: The description; `null` when none. ended_on: type: - string - 'null' description: >- When it ended, as LinkedIn shows it (e.g. `01/2020`); `null` when ongoing. position: type: number description: Its order on the profile, from 0. role: type: string description: The member's role. started_on: type: string description: When it started, as LinkedIn shows it (e.g. `11/2018`). additionalProperties: false description: Volunteering on the profile; empty when none. websites_extra: type: array items: type: object properties: category: type: string description: LinkedIn's category of the website, e.g. `COMPANY`. url: type: string description: The website. additionalProperties: false description: Other websites on the profile; empty when none. required: - certifications - courses - current_companies - current_company_id - current_company_name - current_title - first_name - follower_count - geo_id - headline - honors - industry - industry_id - job_function - last_name - last_refreshed_at - location - location_country - member_id - num_connections - patents - personal_website - photo_root_url - photo_segment - photo_url - publications - recommendations - region - sections - seniority - served_from - slug - sub_role - summary - test_scores - token - volunteering - websites_extra additionalProperties: false IBlinkedNotFound: description: iBlinked has no such profile; not charged type: object properties: found: type: boolean description: 'Always `false`: iBlinked has no such profile. Not charged.' token: type: string description: The `token` you sent. required: - found - token additionalProperties: false DatacircleMeta: type: object description: Datacircle's only addition to the provider's answer required: - provider - credits_cost - credits_remaining properties: provider: type: string enum: - iblinked - up2data description: which provider answered credits_cost: type: number description: >- the credit this call cost, in USD: the provider's price, no markup; 0 when Datacircle answers from what it already holds credits_remaining: type: number description: >- the credit you have left after this call, in USD (`balance_usd` in `GET /credits/`) additionalProperties: false securitySchemes: token: type: apiKey in: header name: Authorization description: '`Token `' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.