InsightSocial APILinkedIn Search People API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/linkedin/search/people?query=Bill%20Gates" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
Step-by-step: Get the employees of a LinkedIn company · Check when a LinkedIn member was last active
Returns LinkedIn members matching a name or filters, each with handle, headline, location, follower count, profile URL, and member id.
Use it to build a prospect list by job title, company, school, or location; use company/people to list one employer's staff.
Metered: 100–500 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.
Paginates by cursor: see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Name or display-name keyword to search for (e.g. 'Bill Gates').
Page number for pagination (default 1).
1 <= valueFilter by first name.
Filter by last name.
Filter by job title or headline.
Filter by current company, using a numeric company id from /v1/linkedin/company (author.id). Comma-separated for multiple.
Filter by a previously-worked company, using a numeric company id from /v1/linkedin/company (author.id).
Filter by school, using a school id from /v1/linkedin/search/schools (id).
Filter by industry, using an industry id from /v1/linkedin/search/industry (industry_id).
Filter by location, using a geocode id from /v1/linkedin/search/location (geocode).
Filter by profile language (ISO 2-letter code, e.g. 'en').
Filter by service category, using a numeric service-category id. No endpoint resolves these, so pass one you already hold.
Return people who follow a specific member, using the member's URN from /v1/linkedin/profile (author.ext.urn). This one is a URN and not a numeric id.
Set to profile (one token only) to join every row to the member's profile lookup in this one call: author.followers becomes the exact count and followers_approximate reads false on every row the lookup filled, author.following is filled with the member's connection count, and the location, joined date, country, website, cover image and profile flags land where the row lacks them.
Value in
- "profile"
Take the top N rows of this page (1 to 10). The page cursor still advances past the full page of 10, so the rows past your limit are skipped, not carried to the next page.
1 <= value <= 10The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.
Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/linkedin/search/people?query=string"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "items": [ { "author": { "id": "string", "username": "string", "display_name": "string", "avatar_url": "http://example.com", "bio": "string", "verified": true, "followers": 0, "followers_approximate": true, "following": 0, "posts_count": 0, "likes_count": 0, "url": "http://example.com", "location": "string", "external_url": "http://example.com", "private": true, "joined_at": "2019-08-24T14:15:22Z", "last_post_at": "2019-08-24T14:15:22Z", "ext": { "property1": null, "property2": null } } } ], "total": 0, "truncated": true, "ext": { "property1": null, "property2": null } }}