v1

latestOpenAPI 3.0.02026-07-141011946.5 KB
Datagma

Find People

Allows you to identify individuals working in specific job titles within a given company. The query can return up to 10 people. A successful search costs 10 credits, while an unsuccessful search (no results) costs 1 credit.

get/api/ingress/v1/find_people

Query parameters

apiIdstring password required

Your API key. Can be found here https://app.datagma.com/user-api

currentJobTitlestring

Current Job Title - You can separate different job titles using 'OR' (e.g., head of OR chief OR CEO).

linkedinIdstring

Enter the company's LinkedIn ID if available (e.g., 1441, 2728700…). It is the most accurate input you can use.

domainstring

Enter the domain name if available (e.g., algolia.com, ubisoft.com…). It is less accurate than the LinkedIn ID, but more accurate than the company name

currentCompaniesstring

Enter the company name (e.g., Algolia, Ubisoft…). This is less accurate compared to using the domain or LinkedIn ID

countriesstring

Country. Please use the country name in minimal letters (e.g., united states, france, germany...)

fuzzyboolean

When set to true, the endpoint performs a fuzzy search, which broadens the scope of the results by allowing approximate matches. This is useful for finding results that may not exactly match the search criteria. However, enabling this parameter can reduce precision, potentially returning more irrelevant results. Default is false.

debugboolean

We are working on a feature to filter out non-relevant job titles. Set this parameter to true to disable filtering and retrieve all results

Response

A successful response.

listOfInvalidDataInputstring[]
listOfValidLinkedInIdstring[]