List Lookup

Run a LinkedIn jobs search and save the results into a Parvenu list.

POST /jobs_search_list

Costs 0.1 credit per job. credits_used is the amount deducted, and it is the number of billed jobs multiplied by credits_per_row. Rows dropped by exclude_staffing_company are not billed, and with unique_jobs (on by default) you are billed only for the postings actually inserted, not for duplicates that were skipped.

Unlike most other list-scoped endpoints this one responds synchronously with the search result — there is no job acknowledgement and nothing to poll /check_list_status for. Retrieve saved postings any time afterwards with Download Jobs List.

max_results has a minimum of 10. The job search provider will not run a smaller batch, so anything below it is rejected. Ten jobs is 1 credit, which is the cheapest possible test run.

Same search filters as Individual Lookup, plus listname to save the results and unique_jobs to skip postings already saved for that list.

LinkedIn's job search matches the employer name, not the posting text. Searching ZoomInfo returns ZoomInfo's own job ads, not jobs that mention ZoomInfo as a required tool, and quoting a phrase does not change that. To find postings that mention something, save a broad title-filtered set and search the description_text field of the downloaded rows.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
listname	string	Name of the list to save the jobs found to.
unique_jobs	boolean	Optional, defaults to true. Skips jobs already saved on this list and bills only the ones inserted. Set false to save and bill every job returned, including repeats.
url	string	Optional. Pre-built LinkedIn jobs search URL. If provided, the structured filters below are ignored.
keywords	string	Optional. Keyword query string for the jobs search. Matched against the employer name — see the note above.
location_geo_id	string	Optional. LinkedIn geoId for the location filter, e.g. "103644278" for United States.
time_posted	string	Optional. One of Any Time, Past 24 Hours, Past Week, Past Month.
job_types	array of strings	Optional. Subset of Full-time, Part-time, Contract, Temporary, Volunteer, Internship.
experience_levels	array of strings	Optional. Subset of Internship, Entry level, Associate, Mid-Senior level, Director, Executive.
salary_min	string	Optional. One of Any, $40,000+, $60,000+, $80,000+, $100,000+, $120,000+, $140,000+, $160,000+, $180,000+, $200,000+.
max_results	integer	Optional. Maximum jobs to find. Defaults to 100, minimum 10.
exclude_staffing_company	boolean	Optional, defaults to false. Drop jobs posted by staffing, recruiting and RPO firms. See below.

Excluding staffing companies

LinkedIn has no filter for this, so it is applied to the jobs found after the search, by matching each hiring company's description against a staffing keyword list. Excluded rows are not saved and not billed, and the response reports rows_excluded. The match is deliberately broad — a product company whose description talks about hiring or talent may be dropped too.

Response

The job postings found are under data, in the same shape as Individual Lookup. See Response Format for the fields every endpoint returns.

Field	Description
total	Jobs returned by the run.
rows_fetched	Jobs found before filtering.
rows_saved	Jobs written to the list.
rows_excluded	Jobs dropped as staffing companies.
credits_per_row	Credit cost of one billed job.
list_name	The list the jobs were saved to.
search_url	The LinkedIn search URL the run used.

Example

Input

{
  "api_key": "your_api_key",
  "keywords": "Sales Operations",
  "time_posted": "Past Week",
  "max_results": 10,
  "listname": "my_jobs_list",
  "exclude_staffing_company": true
}

Output

{
  "status": "success",
  "data": [
    {
      "job_id": "4438294673",
      "job_title": "Director, Sales Operations",
      "organization_name": "Angi",
      "job_location": "Denver, CO",
      "job_url": "https://www.linkedin.com/jobs/view/director-sales-operations-at-angi-4438294673",
      "posted_at": "2026-09-10",
      "employment_type": "Full-time",
      "seniority": "Director"
    }
  ],
  "credits_used": 0.6,
  "credits_remaining": 4822.4,
  "total": 6,
  "rows_fetched": 10,
  "rows_saved": 6,
  "rows_excluded": 4,
  "credits_per_row": 0.1,
  "list_name": "my_jobs_list",
  "search_url": "https://www.linkedin.com/jobs/search/?keywords=Sales+Operations&f_TPR=r604800",
  "message": "Job search completed",
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "max_results: Input should be greater than or equal to 10"
  },
  "success": false
}

Retrieving results

• Download Jobs List