Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

List Lookup

Clean the Hiring title column on every row of a Parvenu list. Asynchronous, free, writes in place.

POST /normalize_hiring_titles_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. Free: nothing is charged.

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 clean.

processing_mode

string

Optional. blank_only (default), all, or first_10. See below.

view

string

Optional. Which rows of the list to process. all (default) processes every contact in the list; verified only contacts whose email address is verified.

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.

wait_for

string

Optional. Start now, but run on each contact only once another enrichment fills the field it needs: linkedin, website, email, personal_email, phone or company_from_domain. See Run After Another Enrichment.

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

Processing modes

Value
What it does

blank_only

Default. Only titles never cleaned before. This does not mean "the title column is empty".

all

Re-cleans every row from its original, so rule improvements reach rows already done.

first_10

The first 10 rows only. Use it to check the results before running a whole list.

Every row gets a line in its log, including the ones nothing changed on, saying what was done and why.

Example

Start with "processing_mode": "first_10" and read the results before running the whole list.

To try the rules on one title first, use Individual Lookup.

Retrieving results