Getting started

Pagination

List endpoints return a pagination object in the common envelope. Some endpoints return total: null — use hasMore and nextOffset, plus cursor where documented, instead of assuming a known total.

7Fields on the object
hasMoreThe loop condition
nullTotal, when it is unknown

The pagination object

List responses

It sits beside data in the same envelope every endpoint returns, and is null on responses that are not lists.

1{2  "success": true,3  "data": {4    "items": [5      {6        "id": "synthetic-item-01",7        "label": "Synthetic result"8      }9    ],10    "count": 1,11    "total": null12  },13  "pagination": {14    "offset": 0,15    "limit": 10,16    "returned": 1,17    "total": null,18    "hasMore": true,19    "nextOffset": 10,20    "cursor": null21  },22  "meta": {23    "operation": "search_v2_companies",24    "input": {25      "keywords": "business software",26      "offset": 0,27      "limit": 1028    }29  }30}

Fields

From the spec

Derived from the V2Pagination schema in openapi.json.

offset: integer | nullOffset used for this response page. First-page responses usually use 0.
limit: integer | nullRequested page size for this response. LinkedIn may return fewer items.
returned: integerNumber of items returned in this response.
total: integer | nullTotal visible items when LinkedIn exposes it. Search totals can be capped.
hasMore: booleanWhether another page is likely available. Use `nextOffset` or `cursor` with the same endpoint and filters to request it.
nextOffset: integer | nullOffset for the next page when offset pagination is available. Pass it back as the `offset` query parameter.
cursor: string | nullCursor/token for the next page when cursor pagination is available. Pass this exact value back as the `cursor` query parameter.

Rules

Client loop

Start with offset=0 or omit offset for the first page when supported.
When pagination.hasMore is true, request the next page with pagination.nextOffset when it is present.
If pagination.cursor is returned, pass that exact cursor value back with the same endpoint and filters — offset and cursor values are not interchangeable.
Use a bounded page or item limit for demos and background jobs.

Code samples

TypeScript

1let offset = 0;2const limit = 10;3let hasMore = true;45while (hasMore) {6  const url = new URL("https://api.envoapi.com/api/v2/search/companies");7  url.search = new URLSearchParams({8    keywords: "revenue operations",9    limit: String(limit),10    offset: String(offset),11  });1213  const res = await fetch(url, {14    headers: { "X-API-Key": process.env.ENVO_API_KEY ?? "" },15  });1617  const body = await res.json();18  hasMore = Boolean(body.pagination?.hasMore);19  offset = body.pagination?.nextOffset ?? offset + limit;2021  if (offset > 100) break; // Use a bounded page or item limit.22}

1const url = new URL("https://api.envoapi.com/api/v2/profiles/avery-chen-synthetic/posts");2url.search = new URLSearchParams({3  limit: "10",4  cursor: "cursor_synthetic_next_page",5});67const res = await fetch(url, {8  headers: { "X-API-Key": process.env.ENVO_API_KEY ?? "" },9});1011const body = await res.json();

Endpoints with paginated responses

33 endpoints

Generated from every response schema that allows the V2Pagination object.

/api/v2/profiles/{public_identifier}/sectionsSign-in required: Profile
/api/v2/profiles/{public_identifier}/positionsSign-in required: Profile
/api/v2/profiles/{public_identifier}/educationSign-in required: Profile
/api/v2/profiles/{public_identifier}/skillsSign-in required: Profile
/api/v2/profiles/{public_identifier}/certificationsSign-in required: Profile
/api/v2/profiles/{public_identifier}/organizationsSign-in required: Profile
/api/v2/profiles/{public_identifier}/languagesSign-in required: Profile
/api/v2/profiles/{public_identifier}/coursesSign-in required: Profile
/api/v2/profiles/{public_identifier}/volunteer-experienceSign-in required: Profile
/api/v2/profiles/{public_identifier}/honorsSign-in required: Profile
/api/v2/profiles/{public_identifier}/interests/companiesSign-in required: Profile
/api/v2/profiles/{public_identifier}/related/follow-recommendationsSign-in required: Profile
/api/v2/profiles/{public_identifier}/postsSign-in required: ProfileOffset · Cursor
/api/v2/profiles/{public_identifier}/commentsSign-in required: ProfileOffset · Cursor
/api/v2/profiles/{public_identifier}/reactionsSign-in required: ProfileOffset · Cursor
/api/v2/companies/by-domain: CompanyOffset
/api/v2/companies/{universal_name}/postsSign-in required: CompanyOffset · Cursor
/api/v2/companies/{universal_name}/employeesSign-in required: CompanyOffset
/api/v2/companies/{universal_name}/employee-filtersSign-in required: Company
/api/v2/companies/{universal_name}/jobsSign-in required: Company
/api/v2/companies/{universal_name}/productsSign-in required: CompanyOffset
/api/v2/search/companiesSign-in required: SearchOffset
/api/v2/search/peopleSign-in required: SearchOffset
/api/v2/search/postsSign-in required: SearchOffset
/api/v2/search/hashtags/{hashtag}Sign-in required: SearchOffset
/api/v2/search/allSign-in required: SearchOffset
/api/v2/search/filtersSign-in required: Search
/api/v2/search/typeaheadSign-in required: Search
/api/v2/search/locationsSign-in required: Search
/api/v2/jobs/search: JobOffset
/api/v2/jobs/search/filters: Job
/api/v2/posts/commentsSign-in required: PostOffset · Cursor
/api/v2/posts/reactionsSign-in required: PostCursor