Users

Retrieve a profile

Changed on

Retrieve the profile of a user. Ensure careful implementation of this action and consult provider limits and restrictions: https://developer.unipile.com/docs/provider-limits-and-restrictions

get/api/v1/users/{identifier}

Request

Path parameters

identifierstring required

Can be the provider’s internal id OR the provider’s public id of the requested user. LinkedIn public_id are only supported for Classic profiles. When using linkedin_api=recruiter or linkedin_api=sales_navigator, you must provide the corresponding internal LinkedIn identifier.

Query parameters

linkedin_sectionsstring[]

A list of profile sections to retrieve detailed information on a LinkedIn profile. LinkedIn may throttle heavy use of full data section requests, so pick only the sections you truly need. Select *_preview to fetch all sections with preview data (first entries as displayed in the LinkedIn profile UI), or * to fetch all sections with full data (not recommended if you’re chaining a lot of profile calls in a short period). You can also combine selectors, for example, ["*_preview", "experience", "skills"] to get all sections in preview plus experience and skills in full. In the response, you may receive empty sections if LinkedIn is throttling your requests. In such case, the throttled_sections field lists the concerned sections. To prevent this, you should add random delay between your calls, and/or not request as many sections as you use to.

linkedin_api'recruiter' | 'sales_navigator'

The LinkedIn API that should be used to get the profile (relative features must be subscribed), if different from classic.

notifyboolean

Whether the profile visit should be notified to the viewee or not. Default is false.

account_idstring required

The id of the account to perform the request from.

Response

OK. Request succeeded.

OR
OR
OR
OR

Changes

    • warning

      added the new errors/connection_limit_reached enum value to the response property for the response status

    • warning

      added the new errors/not_supported_by_provider enum value to the response property for the response status

    • warning

      added the new errors/password_reset_required enum value to the response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status