List Lookup

Resolve a LinkedIn profile URL for every contact in a Parvenu list. Asynchronous, writes results back into the list.

POST /find_profile_list

This is an asynchronous endpoint. It returns a job acknowledgement, not data. Poll /check_list_status until the list reports done, then fetch the rows with /download_list. Costs 0.5 credits per row, charged only when a profile is found. Results are written to the person_linkedin_url column.

This endpoint does not accept a state filter, unlike Headcount and Personal Email. Passing state returns a 400 (Extra inputs are not permitted). It processes every row in the list, unless you send saved_view.

Use this to resolve URLs for every contact in a list in one call, rather than looping over Individual Lookup per row.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
listname	string	Name of the existing Parvenu list to enrich.
saved_view	string	Optional. Name of a saved view on this list. Runs only on the contacts in that view. Don't combine with view, filter_stack or search.

Saved views. To run only on the contacts in a saved view, send its name as saved_view. See List Saved Views.

Example

Input

{
  "api_key": "your_api_key",
  "listname": "my_list"
}

Output

{
  "success": true,
  "job_id": "2aa89f93-ac88-4d84-9d8b-8814bdfc9eee",
  "status": "queued",
  "list_name": "my_list",
  "rows_selected": 10,
  "rows_fetched": 10,
  "message": "queued",
  "view": "all",
  "max_rows": 5000,
  "truncated": false,
  "credits_used": 0
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "state: Extra inputs are not permitted"
  },
  "success": false
}

Reading the acknowledgement

Field	Meaning
job_id	Identifier for this run. Always a string.
status	A job status: queued, processing, done, not_found, cancelled or error.
rows_selected	How many rows matched before the page limit was applied.
rows_fetched	How many rows this run actually picked up. This is the number that gets processed.
max_rows	The ceiling a single run will fetch.
truncated	true when the list was longer than max_rows and the run was cut to fit.

Retrieving results

• Check List Status

• Download List Data