Minerva Documentation

Minerva specializes in people data enrichment, offering access to detailed and accurate information including granular demographics, property information, professional data and contact details (emails and phone numbers).

Getting Started

Our API is secured using Bearer (OAuth) , as well as API (x-api-key) tokens. Follow these steps to authenticate and begin accessing data:

1. Token Use

   1. OAuth - Token: Use the /v1/get-token endpoint to acquire a Bearer token. Tokens are valid for 12 hours, after which a new token must be requested. OAuth Tokens should be added to the request-headers like so:

      "Authorization": "Bearer <REPLACE_WITH_RETRIEVED_OAUTH_TOKEN>"
      "Content-Type": "application/json" 

   2. Static - Token: Use the provided static API-Token ( x-api-key) in your header. This token does not expire and must be stored safely. Static Tokens should be added to request-headers like so:

      "x-api-key": "<REPLACE_WITH_PROVIDED_STATIC_API_TOKEN>"
      "Content-Type": "application/json"

2. Access Data Once authenticated, you can:

   • Use the /v1/resolve endpoint to generate a persistent identifier for your internal records, using provided customer records

   • Use the /v1/enrich endpoint to retrieve complete user profiles with all available data fields

   • Use the /v1/get_li_contact_info endpoint to enhance user LinkedIn usernames to retrieve contact details for that individual using our proprietary b2b2c identity graph