The Connections API returns a list of 1st degree connections for a user who has granted access to his/her account. You can control the fields you want to have returned and the number of connections returned for each call.
- You must use an access token to make an authenticated call on behalf of a user
- You cannot "browse connections." That is, you can only get the connections of the user who granted your application access. You cannot get connections of that user's connections (2nd degree connections).
This API requires the following permissions (see Member Permissions)
|r_network||Required to retrieve 1st degree connections|
Please reference the limits applied to this API
You can use any of three ways of identifying the authenticated user: ~, member ID, or public profile URL.
These must all be URL encoded before using them.
If you don't specify any parameters in the URL, you get full details of all connections. Misspelled parameter names are ignored.
In addition to the parameters listed here, you may also specify field selectors to return just the fields you want.
|start||No||Starting location within the result set for paginated returns. Ranges are specified with a starting index and a number of results (count) to return. The default value for this parameter is 0.|
|count||No||Ranges are specified with a starting index and a number of results to return. You may specify any number. Default and max page size is 500. Implement pagination to retrieve more than 500 connections.|
|modified||No||Values are updated or new.|
|modified-since||No||Value as a Unix time stamp of milliseconds since epoch.|
Sample Return XML
A successful call returns an XML document in the following format:
<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
Finding New Connections
If your application iteratively polls to find the latest set of a member's connections, please make a call like:
Where modified-since is the time you last made the request. (In miliseconds since epoch.) This provides you with the most efficient set of results in the least amount of time.
Returned Member URL Resources
For your convenience, the XML returns two URLs that let you easily display a standard profile.
- api-standard-profile-url is the URL you use to return a standard profile.
- site-standard-profile-url is URL you use to display a standard profile on LinkedIn.com