API Documentation

Getting Started

Parvenu's REST API allows you to enrich for company and contact information. We use an API key in the body for authentication.

Endpoints

Enrich a Contact

POST https://data.parvenu.io/api-product/incoming-webhook/find-emails-first-last

This endpoint allows you to get Business Emails from First Name, Last Name, and Domain.

Request Body

Name	Type	Description
api_key	string	API Key
first_name	string	The First Name you want enriched for the Business Email.
last_name	string	The Last Name you want enriched for the Business Email.
domain	string	The Domain of the Company

200 Contacts successfully retrieved.

{
	"email": "[email protected]"
}

404 Could not find a contact matching this domain query.

[]

Emails from Full Name + Domain

Enrich Domain

POST https://data.parvenu.io/api-product/incoming-webhook/enrich-company

This endpoint allows you to get contacts and their contact info from a Domain.

Request Body

Name	Type	Description
api_key	string	API Key
domain	string	The Domain you want enriched for contact info

200 Contacts successfully retrieved.

[{
	"first_name": "mickaël",
	"last_name": "marquez",
	"headline": "UX Designer",
	"job_title": "UX Designer",
	"location": "Paris et périphérie",
	"business_email": "[email protected]",
	"personal_email": null,
	"social_url": "https://www.linkedin.com/sales/people/ACwAAAxI-moB2W31Pt3aIb5FbsWQtjRZsl_qpIU,NAME_SEARCH,gRRh",
	"description": "",
	"company_name": "GitBook",
	"keywords": [],
	"connections_count": "",
	"picture": "",
	"city": "Paris et périphérie",
	"linkedin_id": 206109290,
	"skills": "",
	"past_company": [],
	"rewards": [],
	"industry": "",
	"company_domain": "gitbook.com"
}]

404 Could not find a contact matching this domain query.

[]

Don't use "https://www." when passing data to this endpoint.

Emails from Companies

Find Domain

POST https://data.parvenu.io/api-product/incoming-webhook/convert-company-names

This endpoint allows you to get Domains from a Company name.

Request Body

Name	Type	Description
api_key	string	API Key
company_name	string	The Company with a missing Domain

200

[{
	"name": "Parvenu",
	"domain": "parvenunext.com",
	"logo": "https://logo.clearbit.com/parvenunext.com"
}, {
	"name": "Parvenu Apparel",
	"domain": "parvenuapparel.com",
	"logo": "https://logo.clearbit.com/parvenuapparel.com"
}, {
	"name": "Parvenu Digital",
	"domain": "parvenudigital.com",
	"logo": "https://logo.clearbit.com/parvenudigital.com"
}, {
	"name": "Parvenu Magazine",
	"domain": "parvenumagazine.com",
	"logo": "https://logo.clearbit.com/parvenumagazine.com"
}, {
	"name": "Parvenu Management",
	"domain": "parvenumanagement.com",
	"logo": "https://logo.clearbit.com/parvenumanagement.com"
}]

404

[]

Emails from Companies

Scrape from Websites

POST https://data.parvenu.io/api-product/incoming-webhook/extract-emails-from-urls

This endpoint allows you to get emails, phone numbers, and social media URLs from Domains.

Request Body

Name	Type	Description
api_key	string	API Key
url	string	The Website you want enriched for contact info

200 Contacts successfully retrieved.

{
	"query": "https://parvenunext.com",
	"domain": "https://parvenunext.com",
	"title": "Home | Parvenu",
	"description": null,
	"keywords": null,
	"phones": "0123456789 , 016225436",
	"twitter_url": null,
	"twitter_username": null,
	"facebook_url": "https://www.facebook.com/parvenunext",
	"facebook_username": "parvenunext",
	"google_plus_url": null,
	"google_plus_username": null,
	"youtube_url": null,
	"youtube_username": null,
	"instagram_url": null,
	"instagram_username": null,
	"linkedin_url": null,
	"linkedin_username": null,
	"github_url": null,
	"github_username": null,
	"company_email": "[email protected]"
}

404 Could not find a contact matching this domain query.

[]

Use "https://www." when passing data to this endpoint.

Scrape from Domains