Skip to main content
POST
/
accounts
/
count_profiles
Count matching profiles
curl --request POST \
  --url https://app.prontohq.com/api/v2/accounts/count_profiles \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "company_linkedin_id": "1234567",
  "title_to_include": [
    "Software Engineer",
    "Developer"
  ],
  "title_to_exclude": [
    "Junior"
  ],
  "included_locations": [
    "105015875",
    "102221843"
  ],
  "excluded_locations": [
    "103644278"
  ]
}'
{
  "total": 26,
  "title_to_include": [
    "Software Engineer",
    "Developer"
  ],
  "title_to_exclude": [
    "Junior"
  ],
  "included_locations": [
    "105015875",
    "102221843"
  ],
  "excluded_locations": [
    "103644278"
  ]
}

​
Count Profiles

The Count Profiles endpoint allows you to count the number of employee profiles matching specific criteria for a company. You can filter by job titles and locations to get precise counts of potential prospects.

​
Required Parameters

You must provide one of the following to identify the target company:
  • company_linkedin_id: The LinkedIn company identifier
  • company_linkedin_url: The full URL of the company’s LinkedIn profile

​
Location IDs Reference

Location IDs used in this endpoint can be retrieved using the Location Ids endpoint. Simply provide a location name (e.g., “San Francisco”) and the API will return all matching locations with their IDs.

​
Request Example

{
  "company_linkedin_id": "1234567",  // Required if company_linkedin_url is not provided
  "title_to_include": ["Software Engineer", "Developer"],
  "title_to_exclude": ["Junior"],
  "included_locations": ["105015875", "102221843"],
  "excluded_locations": ["103644278"]
}
Alternative company identification: 
{
  "company_linkedin_url": "https://www.linkedin.com/company/microsoft",  // Required if company_linkedin_id is not provided
  // ... other parameters ...
}

​
Response Example

{
  "total": 26,
  "title_to_include": ["Software Engineer", "Developer"],
  "title_to_exclude": ["Junior"],
  "included_locations": ["105015875", "102221843"],
  "excluded_locations": ["103644278"]
}

​
Understanding the Response

  • total: The total number of profiles matching your criteria
  • title_to_include: List of job titles that were included in the search
  • title_to_exclude: List of job titles that were excluded from the search
  • included_locations: List of Location IDs that were included
  • excluded_locations: List of Location IDs that were excluded

​
Tips

  • Use location IDs to target specific geographic areas
  • Combine title inclusions and exclusions to refine your search
  • Keep your title filters relevant to ensure accurate results

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json
  • Option 1
  • Option 2
​
company_linkedin_id
string
required

LinkedIn company identifier

Example:

"1234567"

​
title_to_include
string[]

List of job titles that were included in the search

Example:
["Software Engineer", "Developer"]
​
title_to_exclude
string[]

List of job titles that were excluded from the search

Example:
["Junior"]
​
included_locations
string[]

List of Location IDs that were included in the search

Example:
["105015875", "102221843"]
​
excluded_locations
string[]

List of Location IDs that were excluded from the search

Example:
["103644278"]

Response

Successfully counted matching profiles

​
total
integer

Total number of matching profiles

Example:

26

​
title_to_include
string[]

List of job titles that were included in the search

Example:
["Software Engineer", "Developer"]
​
title_to_exclude
string[]

List of job titles that were excluded from the search

Example:
["Junior"]
​
included_locations
string[]

List of Location IDs that were included in the search

Example:
["105015875", "102221843"]
​
excluded_locations
string[]

List of Location IDs that were excluded from the search

Example:
["103644278"]