List Lookup

Pull recent LinkedIn posts for every contact in a Parvenu list. Asynchronous.

POST /post_list

This is an asynchronous endpoint. It returns a job acknowledgement, not data. Costs 0.10 credit per post returned, the same rate as the Individual Lookup.

Post window is relative, not absolute. posted_limit is measured backwards from when the job runs, so the same request sent on two different days covers two different date ranges. The old start_date / end_date fields have been removed, sending them now returns a 422 instead of silently applying the default window.

Use this to pull posts 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	Lead list whose rows will be enriched.
view	string	Optional. Which rows of the list to process. all (default) processes every contact in the list; verified restricts the run to contacts whose email address is verified.
posted_limit	string	Optional. How far back to look, relative to run time: any, 1h, 24h, week, month (default), 3months, 6months, year.
max_record_fetch	integer	Optional. Max posts to pull per profile. Defaults to 10.
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.

View values

Value	Processes
all	Every row in the list (default).
verified	Only rows whose email address is verified.

Response

The acknowledgement reports the job's status, which is one of queued, processing, done, not_found, cancelled or error. done means the job has finished. See Response Format for the fields every endpoint returns.

Field	Description
status	Job status at the moment of the acknowledgement.
view	Which rows were selected, all or verified.
fetched_count	Rows read from the list.
linkedin_url_count	Rows that had a LinkedIn profile URL to work with.
server_filtered_total	Rows left after the view filter.
truncated	true when the list was larger than max_rows.
credits_used	Credits charged by the acknowledgement itself, always 0 here.

Example

Input

{
  "api_key": "your_api_key",
  "listname": "my_list",
  "view": "all",
  "posted_limit": "month",
  "max_record_fetch": 3
}

Output

{
  "result": "Post enrichment (filtered) started",
  "status": "processing",
  "fetched_count": 10,
  "linkedin_url_count": 10,
  "server_filtered_total": 10,
  "truncated": false,
  "max_rows": 5000,
  "message": "Processing filtered LinkedIn post enrichment for my_list (10 profiles, max 3 posts/profile).",
  "view": "all",
  "credits_used": 0,
  "success": true
}

Error

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

Retrieving results

• Check List Status

• Download List Data