# Parvenu API Docs

## Parvenu API Docs

- [Parvenu API](https://developer.parvenu.io/parvenu-api.md): B2B contact and company enrichment via a single API key.
- [Rate Limits](https://developer.parvenu.io/rate-limits.md): How Parvenu API rate limits work, the per-endpoint limits, and how to handle 429 responses.
- [Authentication](https://developer.parvenu.io/getting-started/authentication.md): Authenticate your API requests
- [Response Format](https://developer.parvenu.io/getting-started/response-format.md): Every endpoint returns the same envelope. Read this once and every other page in these docs reads the same way.
- [Find Email Address](https://developer.parvenu.io/enrichments/find-email-address.md): Find a work email address for the people you're targeting, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/find-email-address/individual-lookup.md): Look up one person's business email address from their LinkedIn profile URL, or from their name and company. Synchronous, returns the email directly.
- [List Lookup](https://developer.parvenu.io/enrichments/find-email-address/list-lookup.md): Find work email addresses for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Profile with Company](https://developer.parvenu.io/enrichments/profile-with-company.md): Fetch a LinkedIn profile plus the person's current company — one URL at a time, up to ten in one call, or across a whole Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/profile-with-company/individual-lookup.md): Fetch a LinkedIn profile plus the person's current company in one call.
- [Batch Lookup](https://developer.parvenu.io/enrichments/profile-with-company/batch-lookup.md): Fetch person + company for up to ten LinkedIn URLs in a single call. Returns every record inline — nothing is written to a list.
- [List Lookup](https://developer.parvenu.io/enrichments/profile-with-company/list-lookup.md): Enrich both the person and their current company for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Profile Only](https://developer.parvenu.io/enrichments/profile-only.md): Fetch a LinkedIn person profile (no company lookup), one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/profile-only/individual-lookup.md): Fetch one LinkedIn profile from a profile URL. Synchronous, returns the profile directly.
- [List Lookup](https://developer.parvenu.io/enrichments/profile-only/list-lookup.md): Enrich the LinkedIn profile of every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Find Mobile Phone](https://developer.parvenu.io/enrichments/find-mobile-phone.md): Find a mobile phone number for the people you're targeting, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/find-mobile-phone/individual-lookup.md): Look up one person's mobile phone number from their LinkedIn profile URL. Synchronous, returns the number directly.
- [List Lookup](https://developer.parvenu.io/enrichments/find-mobile-phone/list-lookup.md): Find mobile phone numbers for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Validate Phone](https://developer.parvenu.io/enrichments/validate-phone.md): Check whether a phone number is a real cell phone, one number at a time or across an entire Parvenu list, with your own Phone Validator key.
- [Individual Lookup](https://developer.parvenu.io/enrichments/validate-phone/individual-lookup.md): Check one phone number with your own Phone Validator key. Synchronous, returns the result directly.
- [List Lookup](https://developer.parvenu.io/enrichments/validate-phone/list-lookup.md): Check the mobile phone of every contact in a Parvenu list with your own Phone Validator key. Asynchronous, writes results back into the list.
- [Personalize with AI](https://developer.parvenu.io/enrichments/personalize-with-ai.md): AI-generated personalization for cold outreach, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/personalize-with-ai/individual-lookup.md): Generate one personalized snippet from a single prompt. Synchronous, returns the text directly.
- [List Lookup](https://developer.parvenu.io/enrichments/personalize-with-ai/list-lookup.md): Run a prompt template against every row of a Parvenu list. Asynchronous, writes results back into the list.
- [Post Enrichment](https://developer.parvenu.io/enrichments/post-enrichment.md): Pull recent LinkedIn posts for a person, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/post-enrichment/individual-lookup.md): Pull one person's recent LinkedIn posts. Synchronous, returns the posts directly.
- [List Lookup](https://developer.parvenu.io/enrichments/post-enrichment/list-lookup.md): Pull recent LinkedIn posts for every contact in a Parvenu list. Asynchronous.
- [Company Profile](https://developer.parvenu.io/enrichments/company-profile.md): Fetch a LinkedIn company profile by company URL (no person lookup), one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/company-profile/individual-lookup.md): Fetch one LinkedIn company profile by company URL. Synchronous, returns the profile directly.
- [List Lookup](https://developer.parvenu.io/enrichments/company-profile/list-lookup.md): Fetch a LinkedIn company profile for every company in a Parvenu list. Asynchronous, writes results back into the list.
- [Enrich Company From Domain](https://developer.parvenu.io/enrichments/enrich-company-from-domain.md): Look up rich company data (firmographics, technographics, socials) for one or more domains, or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/enrich-company-from-domain/individual-lookup.md): Look up rich company data for one or more domains. Synchronous, returns the profiles directly.
- [List Lookup](https://developer.parvenu.io/enrichments/enrich-company-from-domain/list-lookup.md): Enrich every row of a Parvenu list using the domain on that row. Asynchronous, writes results back into the list.
- [Website Enrichment](https://developer.parvenu.io/enrichments/website-enrichment.md): Resolve a company website from its name or LinkedIn URL, one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/website-enrichment/individual-lookup.md): Resolve one company's website from its name or LinkedIn company URL. Synchronous, returns the website directly.
- [List Lookup](https://developer.parvenu.io/enrichments/website-enrichment/list-lookup.md): Resolve a company website for every row in a Parvenu list. Asynchronous, writes results back into the list.
- [Headcount Enrichment](https://developer.parvenu.io/enrichments/headcount-enrichment.md): Append current employee headcount to the companies you're targeting, one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/headcount-enrichment/individual-lookup.md): Look up one company's current employee headcount from its domain. Synchronous, returns the headcount directly.
- [List Lookup](https://developer.parvenu.io/enrichments/headcount-enrichment/list-lookup.md): Append current employee headcount to every company in a Parvenu list. Asynchronous, writes results back into the list.
- [Personal Email Enrichment](https://developer.parvenu.io/enrichments/personal-email-enrichment.md): Find personal, non-work email addresses for the people you're targeting, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/personal-email-enrichment/individual-lookup.md): Look up one person's personal, non-work email address from their LinkedIn profile URL. Synchronous, returns the email directly.
- [List Lookup](https://developer.parvenu.io/enrichments/personal-email-enrichment/list-lookup.md): Find personal, non-work email addresses for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Open to Work Enrichment](https://developer.parvenu.io/enrichments/open-to-work-enrichment.md): Flag which contacts you're targeting have the Open to Work badge set, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/open-to-work-enrichment/individual-lookup.md): Check whether one person has the Open to Work badge set on their LinkedIn profile. Synchronous, returns the flag directly.
- [List Lookup](https://developer.parvenu.io/enrichments/open-to-work-enrichment/list-lookup.md): Flag every contact in a Parvenu list who has the Open to Work badge set. Asynchronous, writes results back into the list.
- [Research with AI](https://developer.parvenu.io/enrichments/research-with-ai.md): Run a web-search-backed AI prompt to answer a question with current sources, one prompt at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/research-with-ai/individual-lookup.md): Run one web-search-backed research prompt and get the answer back directly. Synchronous.
- [List Lookup](https://developer.parvenu.io/enrichments/research-with-ai/list-lookup.md): Run a web-search-backed research prompt against every row of a Parvenu list. Asynchronous, writes results back into the list.
- [Scrape Website with AI](https://developer.parvenu.io/enrichments/scrape-website-with-ai.md): Read a company website and answer a prompt from its contents, one site at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/scrape-website-with-ai/individual-lookup.md): Read one website and answer a prompt from its contents. Synchronous, but slow.
- [List Lookup](https://developer.parvenu.io/enrichments/scrape-website-with-ai/list-lookup.md): Read every row's company website and answer a prompt from its contents. Asynchronous, writes results back into the list.
- [Work History & Education](https://developer.parvenu.io/enrichments/work-history-and-education.md): Pull a person's work history and education from LinkedIn, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/work-history-and-education/individual-lookup.md): Pull one person's work history and education from their LinkedIn profile. Synchronous, returns the data directly.
- [List Lookup](https://developer.parvenu.io/enrichments/work-history-and-education/list-lookup.md): Pull work history and education for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [LinkedIn Profile URL Finder](https://developer.parvenu.io/enrichments/linkedin-profile-url-finder.md): Resolve a person's LinkedIn profile URL from their name and company, one contact at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/linkedin-profile-url-finder/individual-lookup.md): Resolve one person's LinkedIn profile URL from their name and company. Synchronous, returns the URL directly.
- [List Lookup](https://developer.parvenu.io/enrichments/linkedin-profile-url-finder/list-lookup.md): Resolve a LinkedIn profile URL for every contact in a Parvenu list. Asynchronous, writes results back into the list.
- [Company News](https://developer.parvenu.io/enrichments/company-news.md): Find a company's recent news with a web-search-backed model, one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/company-news/individual-lookup.md): Find one company's recent news from its domain and get it back directly. Synchronous.
- [List Lookup](https://developer.parvenu.io/enrichments/company-news/list-lookup.md): Find recent news for every company in a Parvenu list. Asynchronous, writes results back into the list.
- [Normalize Contact Names](https://developer.parvenu.io/enrichments/normalize-contact-names.md): Repair a contact's name — honorifics, trailing credentials, nicknames and capitalisation — one name at a time or across an entire Parvenu list. Free.
- [Individual Lookup](https://developer.parvenu.io/enrichments/normalize-contact-names/individual-lookup.md): Repair one contact name and get it back directly. Synchronous and free.
- [List Lookup](https://developer.parvenu.io/enrichments/normalize-contact-names/list-lookup.md): Repair the contact names on every row of a Parvenu list. Asynchronous, free, writes in place.
- [Normalize Company Names](https://developer.parvenu.io/enrichments/normalize-company-names.md): Repair a company name — leftover website text, taglines, legal suffixes and capitalisation — one at a time or across an entire Parvenu list. Free.
- [Individual Lookup](https://developer.parvenu.io/enrichments/normalize-company-names/individual-lookup.md): Repair one company name and get it back directly. Synchronous and free.
- [List Lookup](https://developer.parvenu.io/enrichments/normalize-company-names/list-lookup.md): Repair the company names on every row of a Parvenu list. Asynchronous, free, writes in place.
- [Normalize Titles](https://developer.parvenu.io/enrichments/normalize-titles.md): Clean a contact's job title, one title at a time or across a whole Parvenu list. Free.
- [Individual Lookup](https://developer.parvenu.io/enrichments/normalize-titles/individual-lookup.md): Clean one job title and get it back directly. Synchronous and free.
- [List Lookup](https://developer.parvenu.io/enrichments/normalize-titles/list-lookup.md): Clean the contact's job title on every row of a Parvenu list. Asynchronous, free, writes in place.
- [Normalize Hiring Titles](https://developer.parvenu.io/enrichments/normalize-hiring-titles.md): Clean the job title a contact's company is hiring for, one title at a time or across a whole Parvenu list. Free.
- [Individual Lookup](https://developer.parvenu.io/enrichments/normalize-hiring-titles/individual-lookup.md): Clean one hiring title and get it back directly. Synchronous and free.
- [List Lookup](https://developer.parvenu.io/enrichments/normalize-hiring-titles/list-lookup.md): Clean the Hiring title column on every row of a Parvenu list. Asynchronous, free, writes in place.
- [Job Function Breakdown](https://developer.parvenu.io/enrichments/job-function-breakdown.md): Count a company's people by LinkedIn job function, one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/job-function-breakdown/individual-lookup.md): Break one company's people down by LinkedIn job function, from its LinkedIn URL or its website. Synchronous, returns the counts directly.
- [List Lookup](https://developer.parvenu.io/enrichments/job-function-breakdown/list-lookup.md): Break every company in a Parvenu list down by LinkedIn job function. Asynchronous, writes results back into the list.
- [Technology Stack](https://developer.parvenu.io/enrichments/technology-stack.md): See which tools a company's website runs, one company at a time or across an entire Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/enrichments/technology-stack/individual-lookup.md): Look up which tools one company's website runs. Synchronous, returns the technologies directly.
- [List Lookup](https://developer.parvenu.io/enrichments/technology-stack/list-lookup.md): Look up which tools every company website in a Parvenu list runs. Asynchronous, writes results back into the list.
- [Find Hiring Manager](https://developer.parvenu.io/enrichments/find-hiring-manager.md): Find who to email about a job a company is hiring for, with a valid email, one company at a time or across a whole list of job posts.
- [Individual Lookup](https://developer.parvenu.io/enrichments/find-hiring-manager/individual-lookup.md): Find one company's hiring manager and get them back directly. Synchronous.
- [List Lookup](https://developer.parvenu.io/enrichments/find-hiring-manager/list-lookup.md): Find the hiring manager at every company on a list and add them to it. Asynchronous.
- [Create ICP](https://developer.parvenu.io/icp-enrichment/create-icp.md): Create an ICP from a natural-language description; returns the saved ICP and its id.
- [List ICPs](https://developer.parvenu.io/icp-enrichment/list-icps.md): List every ICP on your account.
- [Get ICP](https://developer.parvenu.io/icp-enrichment/get-icp.md): Fetch one of your ICPs by id.
- [Update ICP](https://developer.parvenu.io/icp-enrichment/update-icp.md): Update an ICP's name, natural-language text, and/or match threshold.
- [Run Enrichment](https://developer.parvenu.io/icp-enrichment/run-enrichment.md): Start an enrichment job that scores contacts (inline or a Parvenu list) against an ICP.
- [List Enrichments](https://developer.parvenu.io/icp-enrichment/list-enrichments.md): List your ICP enrichment jobs.
- [Get Enrichment](https://developer.parvenu.io/icp-enrichment/get-enrichment.md): Poll an enrichment job for status and scored results.
- [Delete ICP](https://developer.parvenu.io/icp-enrichment/delete-icp.md): Delete one of your ICPs by id.
- [Multi-ICP Score](https://developer.parvenu.io/icp-enrichment/multi-icp-score.md): Check one contact against 2 to 10 of your ICPs and get the best fit, or No match.
- [Multi-ICP Score (List)](https://developer.parvenu.io/icp-enrichment/multi-icp-score-list.md): Check every contact in a list against 2 to 10 of your ICPs and write the best fit into the list.
- [List Skills](https://developer.parvenu.io/skills/list-skills.md): List the available Parvenu skill playbooks.
- [View Skill](https://developer.parvenu.io/skills/view-skill.md): Read the full markdown of a single Parvenu skill playbook.
- [Company Search](https://developer.parvenu.io/search/company-search.md): Search companies with industry, employee, location, and technology filters.
- [Search City Codes](https://developer.parvenu.io/search/company-search/search-city-codes.md): Look up Parvenu city slug codes by name. Free helper for /company\_search.
- [Search States Codes](https://developer.parvenu.io/search/company-search/search-states-codes.md): Look up state slug codes by name. Free helper for /company\_search.
- [Search Countries Codes](https://developer.parvenu.io/search/company-search/search-countries-codes.md): Look up country slug codes by name. Free helper for /company\_search.
- [Search Keywords](https://developer.parvenu.io/search/company-search/search-keywords.md): Look up keyword / industry codes for Company Search and Lead Enrichment filters. Free helper.
- [Lead Enrichment](https://developer.parvenu.io/search/lead-enrichment.md): Search and enrich leads by company, industry, job title, location, and more.
- [Industries](https://developer.parvenu.io/search/lead-enrichment/industries.md): Valid company\_industry filter values for the Lead Enrichment endpoint.
- [Search Lead Locations](https://developer.parvenu.io/search/lead-enrichment/search-lead-locations.md): Fuzzy-search the allowed contact\_location values used by Lead Enrichment. Free helper.
- [Sales Nav Search](https://developer.parvenu.io/search/sales-nav-search.md): Input a Sales Navigator lead search URL and process the contacts into a list.
- [Job Search](https://developer.parvenu.io/search/job-search.md): Search LinkedIn job postings and get the results back directly, or save them into a Parvenu list.
- [Individual Lookup](https://developer.parvenu.io/search/job-search/individual-lookup.md): Run a synchronous LinkedIn jobs search and get the results back in the response. Nothing is saved.
- [List Lookup](https://developer.parvenu.io/search/job-search/list-lookup.md): Run a LinkedIn jobs search and save the results into a Parvenu list.
- [List Schedules](https://developer.parvenu.io/search/job-search/list-schedules.md): Every saved job search schedule on the account.
- [Create a Schedule](https://developer.parvenu.io/search/job-search/create-a-schedule.md): Save a job search that re-runs on a schedule into a list.
- [Update or Pause a Schedule](https://developer.parvenu.io/search/job-search/update-or-pause-a-schedule.md): Change a schedule's settings, or pause and resume it.
- [Delete a Schedule](https://developer.parvenu.io/search/job-search/delete-a-schedule.md): Remove a schedule and its run history.
- [Run a Schedule Now](https://developer.parvenu.io/search/job-search/run-a-schedule-now.md): Start one run of a saved schedule straight away.
- [Schedule Run History](https://developer.parvenu.io/search/job-search/schedule-run-history.md): What each recent run found - jobs, contacts and usable emails.
- [Maps Search](https://developer.parvenu.io/search/maps-search.md): Search Maps for local businesses and save the places into a Parvenu list.
- [Lookalike Audience](https://developer.parvenu.io/search/lookalike-audience.md): Find companies similar to a set of seed companies, one page at a time.
- [Lookalike Audience List](https://developer.parvenu.io/search/lookalike-audience-list.md): Find companies similar to a set of seed companies and save them into a Parvenu list.
- [All Lists](https://developer.parvenu.io/get-enrichment-results/all-lists.md): List all enrichment lists under your account, with metadata and download URLs for each.
- [Check List Status](https://developer.parvenu.io/get-enrichment-results/check-list-status.md): Track the progress of your submitted list using this endpoint.
- [Running Enrichments](https://developer.parvenu.io/get-enrichment-results/running-enrichments.md): See every enrichment running on a list right now, from any door.
- [Stop an Enrichment](https://developer.parvenu.io/get-enrichment-results/stop-an-enrichment.md): Stop an enrichment that is running on a list. Nothing more is looked up or charged.
- [Download List Data](https://developer.parvenu.io/get-enrichment-results/download-list-data.md): Once the enrichment is complete, use this endpoint to retrieve your results.
- [Download Jobs List](https://developer.parvenu.io/get-enrichment-results/download-jobs-list.md): Download the job posts saved on a specific list.
- [Credit Check](https://developer.parvenu.io/account/credit-check.md): Check the remaining credit balance in your Parvenu account.
- [Manage Lists](https://developer.parvenu.io/manage-lists.md): Create lists, add and update contacts, and change what is in a list after it has been built.
- [Create a List](https://developer.parvenu.io/manage-lists/create-a-list.md): Create an empty list by name, ready to add contacts to.
- [Add a Contact](https://developer.parvenu.io/manage-lists/add-a-contact.md): Add one contact you already have to a list, without enriching it.
- [Add Contacts in Bulk](https://developer.parvenu.io/manage-lists/add-contacts-in-bulk.md): Add up to 5,000 contacts you already have to a list in one call.
- [Update a Contact](https://developer.parvenu.io/manage-lists/update-a-contact.md): Change or clear fields on a contact that is already in a list.
- [Update Contacts in Bulk](https://developer.parvenu.io/manage-lists/update-contacts-in-bulk.md): Change or clear fields on up to 5,000 contacts in a list in one call.
- [Remove a Contact](https://developer.parvenu.io/manage-lists/remove-a-contact.md): Permanently remove one contact from a list, by email, LinkedIn URL, phone or name.
- [Remove Contacts in Bulk](https://developer.parvenu.io/manage-lists/remove-contacts-in-bulk.md): Permanently remove many contacts from a list in one call.
- [Move a Contact](https://developer.parvenu.io/manage-lists/move-a-contact.md): Move one contact out of a list and into another, keeping every column and its enrichment history.
- [Move Contacts in Bulk](https://developer.parvenu.io/manage-lists/move-contacts-in-bulk.md): Move many contacts out of one list and into another in a single call.
- [List Saved Views](https://developer.parvenu.io/manage-lists/list-saved-views.md): List the saved views you can use. Send one as saved\_view on any list enrichment to run it on just that view's contacts.
- [Custom Columns](https://developer.parvenu.io/manage-lists/custom-columns.md): See, add, change and delete a list's own columns. Fill them with custom\_fields on Update a Contact. Every download returns them.