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

post
Enrich a Contact

https://trial.parvenunext.com/api-product/incoming-webhook/find-emails-first-last
This endpoint allows you to get Business Emails from First Name, Last Name, and Domain.
Request
Response
Request
Body Parameters
api_key
required
string
API Key
first_name
required
string
The First Name you want enriched for the Business Email.
last_name
required
string
The Last Name you want enriched for the Business Email.
domain
required
string
The Domain of the Company
Response
200: OK
Contacts successfully retrieved.
{
"email": "[email protected]"
}
404: Not Found
Could not find a contact matching this domain query.
[]

post
Enrich Domain

https://trial.parvenunext.com/api-product/incoming-webhook/enrich-company
This endpoint allows you to get contacts and their contact info from a Domain.
Request
Response
Request
Body Parameters
api_key
required
string
API Key
domain
required
string
The Domain you want enriched for contact info
Response
200: OK
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: Not Found
Could not find a contact matching this domain query.
[]

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

post
Find Domain

https://trial.parvenunext.com/api-product/incoming-webhook/convert-company-names
This endpoint allows you to get Domains from a Company name.
Request
Response
Request
Body Parameters
api_key
required
string
API Key
company_name
required
string
The Company with a missing Domain
Response
200: OK
[{
"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: Not Found
[]

post
Scrape from Websites

https://trial.parvenunext.com/api-product/incoming-webhook/extract-emails-from-urls
This endpoint allows you to get emails, phone numbers, and social media URLs from Domains.
Request
Response
Request
Body Parameters
api_key
required
string
API Key
url
required
string
The Website you want enriched for contact info
Response
200: OK
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: Not Found
Could not find a contact matching this domain query.
[]

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