[POST] - Contact List Count

Follow

Use the Target API's Contact List Count endpoint to find how many results would be returned by a call to the Contact List endpoint with the same set of parameters.

Endpoint

POST https://api.insideview.com/api/v1/target/contacts/count

Request

HTTP Headers

Header Name Type Required Description
accessToken String Yes Valid access token.
See Authentication and Authorization Overview for more details.
Accept String No

Selects the response's content type.  
Valid values are application/json and application/xml (default).

Use below mentioned values to access New News Platform based search

application/api.news.target.contact.beta+json

application/api.news.target.contact.beta+xml

Form Parameters

Parameter Name Type Required Description
agents String No agents ID.
See API Reference data for a list of IDs.
areaCodes Integer No A comma separated list of area codes
businessTypes String No A comma separated list of business types.
Valid values are: public, private, school,government, organization
cities String No A comma separated list of cities
companyStatus String No A comma separated list of status.
Valid values are: operating, subsidiary, acquired
countries Integer No A comma separated list of country IDs.
See API Reference data for a list of IDs.
fiscalYearEnd String No Example: january
fortuneRanking String No Valid values are: fortune500, fortune1000
industries String No A comma separated list of industries IDs.
See API Reference data for a list of IDs.
isEmailRequired Boolean No If set to true, only contacts with an email address will be counted.
isPhoneRequired Boolean No If set to true, only contacts with a phone number will be counted.
jobFunctions Integer No A comma separated list of job function ID.
See API Reference data for a list of IDs.
jobLevels Integer No A comma separated list of job level ID.
See API Reference data for a list of IDs.
peopleCountries String No Comma separated list of Country Ids
peopleStates String No Comma separated list of States
peopleCities String No Comma separated list of Cities
peopleArea String No Area for the search
peopleAddress String No Address for the search
fullName String No Contact's Full name
keyword Integer No Deprecated, see titles parameter
Keyword string that will be matched against titles
keywords String No Restrict agents results to news containing the keywords passed in parameter.
companyName String No  Name of the company.
maxEmployees Integer No  
maxRevenue Integer No  
minEmployees Integer No  
minRevenue Integer No  
naics String No

A comma separated list of NAICS codes.
List of NAICS codes.

You can enter NAICS & SIC codes in two different ways:

  • Direct code – for example, enter 511210 for Software Publishers.
  • Top Level codes – for example, enter 511* for All Publishing Industries which would include 51111 – 51119 or even 5112* which would include 511210.
newsDuration Integer No A duration in days (1-30).  Works with agents parameter.
primaryIndustryOnly String No  
primaryNAICSOnly String No  
primarySICOnly String No  
regions String No A comma separated list of regions.
Valid values are: Africa, Asia, Europe, MiddleEast, NorthAmerica, Oceania, SouthAmerica
sic String No  
socialNetworks String No If set, only contacts with corresponding social handle(s) will be counted.
Valid values are: facebooklinkedintwitter
street String No Street name
state String No Comma separated list of states 
subIndustries String No A comma separated list of sub-industries IDs.
See API Reference data for a list of IDs.
titles String No Keyword string that will be matched against titles
zipCodes String No A comma separated list of zip codes.
gender String No Diversity status based on Gender
ethnicity Int No

Diversity status based on Ethnicity. Valid values are comma separated list of ethnicity ids. 

ID Values
1 Asian-Indian
2 Non-Ethnic
3 Asian-Pacific
4 Hispanic
5 African American
6 Native American
7 Asian

 

dbe Boolean No Diversity status based on Disadvantages Business Ent. 
wbe  Boolean No Diversity status based on Women Business Ent. 
mbe  Boolean No Diversity status based on Minority Business Ent. 
vbe  Boolean No Diversity status based on Veteran Business Ent.
disabled  Boolean No Diversity status based on Disabled Business Ent. 
lgbt Boolean No Diversity status based on Gay Lesbian business Ent. 

 

Responses

Here are the major responses the API may return.

for details on the errors, please refer to the API Error Codes article.

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header. 

Name type Description
resultCount Integer  

application/json Example

{
"resultCount":"6174252
}

application/xml Example

<?xml version="1.0" encoding="UTF-8"?>
<contactListCount>
   <resultCount>6174252</resultCount>
</contactListCount>

HTTP 400

Invalid query parameter(s).

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in header.

HTTP 405

Method Not Allowed - Your are not allowed to access this API.

HTTP 429

Request is throttled.

Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk