Skip to content
Examples

Get Results

Retrieve scraped data from LinkedIn Search Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your LinkedIn Search Scraper runs. Three row types share the same table, one per search: person, company, post. Fields marked "people rows", "company rows" or "post rows" are left empty on the other types.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

pageintegerquery

Page number (default: 1).

Result Fields

Common

record_typestring

Type of row: person, company or post, following the LinkedIn search that was given as input.

record_idstring

Stable LinkedIn id of the row, prefixed by its type so people, companies and posts never collide: person:{member id or public identifier}, company:{company id or universal name}, post:{activity id}.

source_urlstring

The LinkedIn search URL that was given as task input and produced this row.

search_keywordsstring

Keywords actually sent to LinkedIn for this search.

locationstring

Location as displayed on the search card: member location for people rows, headquarters city for company rows.

is_verifiedboolean

Whether LinkedIn displays the verified badge on the person or the company.

followers_textstring

Follower count exactly as written on the search card, free text (e.g. 35K followers). Filled on company rows, and on people rows where LinkedIn shows the social proof line (roughly a quarter of them, rounded).

People rows

profile_idstring

LinkedIn internal member id of the profile.

public_identifierstring

Public profile slug used in the profile URL.

profile_urlstring

Direct URL to the LinkedIn profile.

full_namestring

Full name of the person as displayed by LinkedIn.

first_namestring

First name, split from the full name on the first space.

last_namestring

Last name, split from the full name on the first space.

headlinetext

Profile headline, free text as written by the member.

photo_urlstring

URL of the profile picture, empty when the member has none.

connection_degreestring

Connection degree between the connected LinkedIn account and the person (1st, 2nd, 3rd+).

is_premiumboolean

Whether LinkedIn displays the premium badge on the person.

open_to_workboolean

Whether LinkedIn shows the Open To Work badge for this person. Read for free from every people search row; the Profile Details add-on can also confirm it from the profile page.

abouttext

About section of the profile. Filled by the Profile Details add-on.

current_positiontext

Current job title and company. Filled by the Profile Details add-on.

is_creatorboolean

Whether the profile is in LinkedIn creator mode. Filled by the Profile Details add-on.

background_photo_urlstring

Cover photo of the profile. Filled by the Profile Details add-on.

experiencejson

Work experience entries. Filled by the Profile Details add-on.

educationjson

Education entries. Filled by the Profile Details add-on.

skillsjson

Skills listed on the profile. Filled by the Profile Details add-on.

Company rows

company_idstring

Numeric LinkedIn id of the company.

universal_namestring

Slug of the company LinkedIn page.

company_urlstring

URL of the company LinkedIn page.

company_namestring

Name of the company as displayed by LinkedIn.

logo_urlstring

URL of the company logo.

industrystring

Industry line shown on the company search card, and the company page industry when the Company Details add-on is on.

employee_count_textstring

Employee count exactly as written on the company search card, free text (e.g. 10,001+ employees).

description_snippettext

Short description shown on the company search card.

websitestring

Company website. Filled by the Company Details add-on.

taglinetext

Company tagline. Filled by the Company Details add-on.

descriptiontext

Full About text of the company page. Filled by the Company Details add-on.

founded_yearinteger

Year the company was founded. Filled by the Company Details add-on.

employee_countinteger

Number of employees LinkedIn associates with the company page. Filled by the Company Details add-on.

followers_countinteger

Number of followers, as an integer. Filled by the Company Details add-on for companies, and on a people row only when the search card shows an exact, unrounded number.

company_sizestring

Company size range as written by LinkedIn (e.g. 5,001-10,000 employees). Filled by the Company Details add-on.

company_typestring

Company type (Privately Held, Public Company...). Filled by the Company Details add-on.

headquartersstring

Headquarters as written on the company page. Filled by the Company Details add-on.

hq_streetstring

Headquarters street address. Filled by the Company Details add-on.

hq_localitystring

Headquarters city. Filled by the Company Details add-on.

hq_regionstring

Headquarters region or state. Filled by the Company Details add-on.

hq_postal_codestring

Headquarters postal code. Filled by the Company Details add-on.

hq_countrystring

Headquarters country. Filled by the Company Details add-on.

phonestring

Phone number published on the company page. Filled by the Company Details add-on.

cover_imagestring

Cover image of the company page. Filled by the Company Details add-on.

locationsjson

Offices listed on the company page. Filled by the Company Details add-on.

specialtiesjson

Specialties listed on the company page. Filled by the Company Details add-on.

similar_pagesjson

Similar company pages suggested by LinkedIn. Filled by the Company Details add-on.

showcase_pagesjson

Showcase pages of the company. Filled by the Company Details add-on.

affiliated_pagesjson

Affiliated pages of the company. Filled by the Company Details add-on.

productsjson

Products listed on the company page. Filled by the Company Details add-on.

Post rows

post_idstring

LinkedIn activity id of the post.

post_urlstring

Permalink of the post.

share_urlstring

Pretty share URL of the post, as used by the LinkedIn share button.

post_contenttext

Full text of the post.

posted_atdatetime

Publication date and time of the post in UTC, decoded from its LinkedIn activity id.

author_namestring

Name of the post author, person or company.

author_public_identifierstring

Public slug of the post author.

author_urlstring

LinkedIn URL of the post author.

author_headlinetext

Headline of the post author as shown above the post.

author_avatar_urlstring

Profile picture of the post author.

author_typestring

Whether the post author is a person or a company.

post_imagesjson

Images attached to the post.

shares_countinteger

Number of reposts of the post. Read from the post card when greater than zero, refreshed by the Post Engagement add-on.

likes_countinteger

Number of reactions on the post. Filled by the Post Engagement add-on.

comments_countinteger

Number of comments on the post. Filled by the Post Engagement add-on.

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"record_type": "person", "record_id": "person:ACoAACrQ6T4BqCXCOj_ofEXvV9FS46fRs4o2I6o", "profile_url": "https://www.linkedin.com/in/nada-adel-mohamady", "full_name": "Nada Adel", "headline": "Software Engineer @ Microsoft", "location": "Egypt", "connection_degree": "3rd+", "search_keywords": "software engineer"}]}