> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/parvenu-api.md).

# Parvenu API

B2B contact and company enrichment via a single API key.

Parvenu is a B2B data API for finding, enriching, and personalizing leads. One API key gets you LinkedIn profile data, work email and mobile phone lookups, company and lead search with rich filters, ICP scoring, and AI-driven copy generation, built for outbound and revenue teams.

#### Quick start

1. Sign up at parvenu.io and copy your API key from the dashboard.

{% embed url="<https://www.parvenu.io/signups>" %}

2. Get your API key and [learn how to authenticate](/getting-started/authentication.md).
3. Read the [Response Format](https://app.gitbook.com/s/tEPKyiBTVBwkpn21HLwD/getting-started/response-format) once — every endpoint returns the same envelope, so every page below reads the same way.
4. Pick an endpoint below and start enriching.

#### What you can do

**Enrichments**

Most enrichments below support two modes: **Individual Lookup** for one known person or company (synchronous, returns data directly), and **List Lookup** for every row in a Parvenu list (asynchronous, writes results back into the list).

* [Headcount Enrichment](/enrichments/headcount-enrichment.md): current employee headcount for a company.
* [Personal Email Enrichment](/enrichments/personal-email-enrichment.md): personal (non-work) email for a contact.
* [Find Email Address](/enrichments/find-email-address.md): work email from a LinkedIn URL, or from name plus company/domain.
* [Find Mobile Phone](/enrichments/find-mobile-phone.md): direct mobile number for a LinkedIn profile.
* [Profile Only](/enrichments/profile-only.md): LinkedIn profile only, no company.
* [Profile with Company](/enrichments/profile-with-company.md): full LinkedIn profile plus current employer data.
* [Company Profile](/enrichments/company-profile.md): LinkedIn company profile by company URL.
* [Enrich Company From Domain](/enrichments/enrich-company-from-domain.md): firmographics, technographics, and socials from a domain.
* [Website Lookup](/enrichments/website-enrichment.md): resolve a company website from its name or LinkedIn URL.
* [Open to Work Enrichment](/enrichments/open-to-work-enrichment.md): flag contacts with the Open to Work badge set.
* [Work History & Education](/enrichments/work-history-and-education.md): a person's employment history and education from LinkedIn.
* [LinkedIn Profile URL Finder](/enrichments/linkedin-profile-url-finder.md): resolve a LinkedIn profile URL from a name and company.
* [Post Enrichment](/enrichments/post-enrichment.md): pull recent LinkedIn posts for a contact.
* [Personalize with AI](/enrichments/personalize-with-ai.md): generate personalized copy from a prompt and lead context.
* [Research with AI](/enrichments/research-with-ai.md): answer a question with a web-search-backed model.
* [Scrape Website with AI](/enrichments/scrape-website-with-ai.md): answer a question from a company's own website.

**Search**

Discover lists of people or companies that match your filters.

* [Company Search](/search/company-search.md): filter by industry, size, country, technologies, and more.
  * [Search City Codes](/search/company-search/search-city-codes.md): look up city codes for the filters.
  * [Search States Codes](/search/company-search/search-states-codes.md): look up state codes for the filters.
  * [Search Country Codes](/search/company-search/search-countries-codes.md): look up country codes for the filters.
  * [Search Keywords](/search/company-search/search-keywords.md): look up industry / keyword codes (replaces the old industries lookup).
* [Lead Enrichment](/search/lead-enrichment.md): find contacts at companies with title, location, and industry filters.
  * [Industries](/search/lead-enrichment/industries.md): valid company\_industry values for Lead Enrichment.
  * [Search Lead Locations](/search/lead-enrichment/search-lead-locations.md): valid contact\_location values for Lead Enrichment.
* [Sales Nav Search](/search/sales-nav-search.md): search with a LinkedIn Sales Navigator people-search URL.
* [Job Search](/search/job-search.md): search or save LinkedIn job postings, with filter and date options.

**ICP Enrichment**

Turn a natural-language Ideal Customer Profile into structured filters, then score contacts against it.

* [Create ICP](/icp-enrichment/create-icp.md): build an ICP from a natural-language description.
* [List ICPs](/icp-enrichment/list-icps.md): all ICPs on your account.
* [Get ICP](/icp-enrichment/get-icp.md): fetch one ICP by id.
* [Update ICP](/icp-enrichment/update-icp.md): change an ICP's name, text, or match threshold.
* [Delete ICP](/icp-enrichment/delete-icp.md): remove an ICP by id.
* [Run Enrichment](/icp-enrichment/run-enrichment.md): start scoring contacts or a list against an ICP.
* [List Enrichments](/icp-enrichment/list-enrichments.md): your enrichment jobs.
* [Get Enrichment](/icp-enrichment/get-enrichment.md): poll a job for status and scored results.

**Get Enrichment Results**

Most search and list-scoped enrichment endpoints run asynchronously and save into a named list. Use these to retrieve and monitor results.

* [All Lists](/get-enrichment-results/all-lists.md): metadata for every list on your account.
* [Check List Status](/get-enrichment-results/check-list-status.md): see whether a specific list is still processing.
* [Download List Data](/get-enrichment-results/download-list-data.md): pull the enriched rows once a list is ready.
* [Download Jobs List](/get-enrichment-results/download-jobs-list.md): pull the scraped job posts saved on a list.

**Skills**

* [List Skills](/skills/list-skills.md): list the available Parvenu playbooks.
* [View Skill](/skills/view-skill.md): fetch the contents of a single skill.

**Account**

* [Credit Check](/account/credit-check.md): remaining credit balance on your account.

#### Credits

Parvenu uses credit-based pricing. Costs vary by endpoint, for example a verified business email is 1 credit, a mobile number is 5 credits, company search is 0.20 per company, and free helpers (city / state / country / keyword codes, list downloads, credit checks, ICP create) don't deduct any credits. See the full breakdown below.

{% embed url="<https://support.parvenu.io/settings/billing/credits>" %}