InsideView is continuously maintaining and enhancing its API. Therefore, it is normal for bug fixes and backwardly-compatible enhancements to appear without any change in the major version of the API. Specifically, your application should be resilient to the appearance of:
- Additional endpoints
- Additional optional fields in requests
- Additional optional fields in responses
- Additional error codes
- Wording changes in the explanatory text of existing error codes
Generally speaking, your code should be resilient insofar as it ignores fields that it isn't utilizing or expecting, and handles errors using standard HTTP/REST conventions. InsideView intends to confine its API fixes and enhancements within a major version such that code that is resilient in these ways for backward compatibility for the lifetime of a major version.
Release History
v201 - 2022-06-27
In this release we've made updates to API Matching and API Fields.
API Branch Matching
Previously, our API only matched against companies that were part of a Family Tree (e.g. subsidiaries.) This release includes new API Fields that enables Branch matching. Use these fields to match against companies in specific branch locations.
- New API Fields
API Field Label |
Definition |
businessStructure |
The organizational structure of a company (global parent, uncategorized, subsidiary, group, branch, independent) |
companyStatusV2 |
Company status (operating, non-Operating, acquired, liquidating, outOfBusiness, unassigned) |
companyTypeV2 |
Company type (public, private, government, organization, unknown) |
siteCount |
Number of company sites |
siteLocationCount |
Number of company sites that has site related information |
siteTypes |
Type of a site |
API Field Updates
One field has a spelling change and must be replaced as soon as possible. Four fields have new versions and must be replaced by December 31, 2022.
- Updated API Field
Previous API Field |
New API Field |
Forfeiting and Factoring |
Forfaiting and Factoring |
- API Fields to replace by December 31, 2022
Previous API Field |
New API Field |
companyStatus |
companyStatusv2 |
companyType |
companyTypeV2 |
employments jobFunctions |
employment jobFunctionsV2 |
employments jobLevels |
employments jobLevelsV2 |
v192 - 2021-09-04
Enhancements to Technographics
InsideView APIs now allow you to view updated tech install data from DemandMatrix to help you win more business by identifying companies that use relevant technologies in your market.
Use the productIds parameter to retrieve the technologies used by companies that are pre-defined by a CSM or an account admin in the Tech Settings for your account.
Note: If your account admin or InsideView CSM does not enable the Tech Profiler feature, or does not set up with your relevant list of technologies then no technographics data will be retrieved in the response. You must ask your CSM to enable the Tech Profiler feature at an account-level during the initial account set up.
In List Build APIs, you can now view technologies using the predefined list in the productIds field with a comma-separated product IDs. The categoryIds and subCategoryIds parameters are no longer accepted as an input .
This enhanced technographics is available in the following API endpoint calls:
Data API Endpoints
- [GET] - Company Insights Tech Profile API: Shows the latest technographics data in productIds field in response.
- [POST] - Company Insights Tech Profile Job: Shows the latest technographics data in productIds field in a .CSV response file.
Target API Endpoints
- [GET] - Company Insights Tech Profile API: Shows the latest technographics data in productIds field in response.
- [POST] - Target Company Insights Tech Profile Job: Shows the latest technographics data in productIds field in a .CSV response file.
- [POST]- Company List (List Build): Allows you to filter company/contact data based on productIds and other parameters.
- [POST] - Company List Count: Filter the technographics data using the productIds parameter.
- [POST] - Company Lookup: Filter the technographics data using the productIds parameter.
- [POST] - Contact List: Filter the technographics data using the productIds parameter..
- [POST] - Contact List Count: Filter the technographics data using the productIds parameter.
- [POST] - Asynchronous (batch) Target Company List Build API: Filter the technographics data using the productIds parameter.
- [POST] - Asynchronous (batch) Target Contact List Build API: Filter the technographics data using the productIds parameter.
v191 - 2021-08-07
Search Executives Who Have Mobile Phone Numbers
Mobile phone numbers are now available via the InsideView APIs for customers and partners who have purchased Elite or the mobile phone add-on to Enterprise. The phoneType parameter retrieves the Mobile Number of an executive, provided one is available in our database, which increases the probability of directly reaching your customers and prospects by phone.
In Subscription APIs, you can now subscribe to the field executiveMobileNo for subscriptionType=people. When you subscribe to this field, notification alerts are triggered in case of value change.
This new parameter is available in the following API endpoint calls:
Data API Endpoints
- [GET] - Contact Search: The phoneType parameter accepts the new value as MOBILE.
- [GET] - Contact Details: Shows the Mobile Number in response.
- POST - Contact Details Job: Shows the Mobile Number in a .CSV response file.
- [GET] - People Details API: Shows the Mobile Number in response.
Target API Endpoints
- [GET] - New Contact Details: Shows the Mobile Number in response.
- [POST] - New Contact Details Job: Shows the Mobile Number in a .CSV response file.
- [POST] - Contact List: The phoneType parameter accepts the new value as MOBILE.
- [POST] - Contact List Count: The phoneType parameter accepts the new value as MOBILE. Shows the Mobile Number in a .CSV response file.
- [GET] - Contact Lookup: The phoneType parameter accepts the new value as MOBILE. Shows the Mobile Number in response.
- [POST] - Asynchronous (batch) Target Contact List Build API: The phoneType parameter accepts the new value as MOBILE. Shows the Mobile Number in a .CSV response file.
Subscription API Endpoints
In Subscription APIs, when the Display Mobile Phone (executiveMobileNo) field is enabled at the account level, then when you create/update subscriptions a notification alert is sent whenever there is an update available.
When the Display Mobile Phone (executiveMobileNo) field is disabled at the account level, you will not be notified of any changes that happen to the Mobile Number field.
- [POST] - Create Subscription: Accepts the executiveMobileNo field in the fields parameter for subscriptionType=people.
- [PUT] - Update Subscription: Accepts the executiveMobileNo field in the fields parameter for subscriptionType=people.
- [POST] - Create Subscription Job: Accepts the executiveMobileNo field in the fields parameter for subscriptionType=people.
- [PUT] - Update Subscription Job: Accepts the executiveMobileNo field in the fields parameter for subscriptionType=people.
v190 - 2021-07-10
Filter Contacts with new Job Function and Job Level Parameters
You can now search executives using our newest version of job function and job levels parameters -- jobFunctionsV2 or jobLevelsV2, which allows you to search executives with the better and more granular categorization of job functions and job levels.
These new parameters are available in the following API endpoint calls:
Data API Endpoints
- [GET] - Contact Details: Shows jobFunctionsV2 and jobLevelsV2 in response.
- POST - Contact Details Job: Shows jobFunctionsV2 and jobLevelsV2 in a .CSV response file.
- [POST] - Bulk Contact Fetch API: Shows jobFunctionsV2 and jobLevelsV2 in response.
- [GET] - People Details API: Shows jobFunctionsV2 and jobLevelsV2 in response.
Enrich API Endpoints
- [POST] - Enrich: Shows jobFunctionsV2 and jobLevelsV2 in response.
Target API Endpoints
- GET - Contact Lookup: Accepts new request parameters. Shows jobFunctionsV2 and jobLevelsV2 in response.
- [POST] - Contact Lookup: Shows jobFunctionsV2 and jobLevelsV2 in a .CSV response file.
- [GET] - New Contact Details: Shows jobFunctionsV2 and jobLevelsV2 in response.
- [POST] - New Contact Details Job: Shows jobFunctionsV2 and jobLevelsV2 in a .CSV response file.
- [POST] - Asynchronous (batch) Target Contact List Build API: Accepts jobFunctionsV2 and jobLevelsV2 request parameters. Shows jobFunctionsV2 and jobLevelsV2 in a .CSV response file.
- [POST] - Contact List: Accepts new request parameters.
- [POST] - Contact List Count: Accepts new request parameters. Shows jobFunctionsV2 and jobLevelsV2 in a .CSV response file.
v183 - 2021-01-09
Bulk Company and Contact Fetch APIs
InsideView is delighted to introduce bulkCompany and bulkContact API endpoints.
The bulkCompany endpoint will fetch the company details for the company IDs that are requested from the InsideView database. You can pass a maximum of 50 companyIds to fetch their companies details.
The bulkContact endpoint will fetch the contact details for the contact IDs that are requested from the InsideView database. You can pass a maximum of 50 contactIds to fetch their details.
Note: These new endpoints are available at a cost and consume API credits based on the number of companies and contact fetched.
If you enter duplicate IDs only one ID is accepted. If you enter Alphanumeric IDs, an invalid error is returned. If the IDs are not present in the database, the “company not present or contact not present” error appears.
Data API Endpoints
For more information, read the following KB articles:
- POST] - Bulk Company Fetch API - Fetches the company details based on the companyId if company data exists in InsideView.
- [POST] - Bulk Contact Fetch API - Fetches the contact details based on the contactId if contact data exists in InsideView.
View Total Company and Contact Results
The Company AutoComplete API now returns a total number of companies and contact results. You can pass totalCompanyResults and totalContactResults parameters to retrieve these results.
You can also set the page count value in response using the page field. For more information, read the article [GET] - Company AutoComplete API in our Knowledge Base.
v182 - 2020-12-05
View Companies with a Phone Number
A new hasPhone request parameter is introduced in Company List and company Lookup APIs to let you filter companies with phone numbers that are available in the InsideView database. When you pass the hasPhone parameter as true, InsideView API will return only companies that have a phone number. If you pass it as false, InsideView API will show all companies that have no phone numbers.
The hasPhone parameter is now accepted in the following Target API endpoints:
- [POST] - Company List (List Build)
- [POST] - Company LookUp
- [POST] - Company List Count
- [POST] - Asynchronous (batch) Target Company List Build API
View Contacts with a Phone Number or Email ID
A new hasContactInfo request parameter is introduced to let you filter contacts with either a phone number or email ID that is available in the InsideView database. When you pass the hasContactInfo parameter as true, InsideView API will show only contacts that have either a direct or corporate phone (hasPhone) number or email ID (hasEmail) as true. If hasContactInfo is false, contact records in response will neither have phone nor email ID.
The hasContactInfo parameter is now accepted in the following Target API endpoints:
- [POST] - Contact List
- [POST] - Contact LookUp
- [POST] - Contact List Count
- [POST] - Contact LookUp Job
v181 - 2020-11-07
Company Matcher Lite
InsideView is delighted to introduce the new Company Matcher Lite endpoint, which is the same as the Company Matcher endpoint except it returns limited company fields such as:
- "name",
- "street",
- "city",
- "state",
- "zip",
- "country",
- "companyId"
To learn how to use this endpoint, read the article [POST] - Company Matcher Lite [Charter] in our Knowledge Base.
v1.79 - 2020-09-12
Company Match Explanation
A new explainMatch request parameter is introduced to let you view the reason/explanation for the company matches returned by InsideView Company Matcher API. The match explanation helps you to have a better understanding of why a particular company has matched for your input.
The reason/explanation for a matched record is a combination of field-level match reasons.
View Companies with a Website URL
A new hasWebsite request parameter is introduced to let you view companies for which website URL is available in the InsideView database. When you pass the hasWebsite parameter as true, InsideView API will show only companies which have website URL. If you pass it as false, InsideView API will show all companies including those which have no website URLs.
The hasWebsite parameter is now accepted in the following Target API endpoints
- [POST] - Company List
- [POST] - Company List Count
- [POST] - Asynchronous (batch) Target Company List Build API
Note: The website URL will be visible in the API response.
v1.78 - 2020-08-15
String-Based Company ID Support
InsideView is delighted to introduce support for the string-based companyId to retrieve the contact details ID instead of integer ID.
InsideView [GET] - Contact Lookup API endpoint accepts the string and integer CompanyId types.
v1.76 - 2020-07-04
Company ID Management
At InsideView, we continually refresh and grow our company database, and sometimes that means we need to merge or delete the duplicate company IDs.
InsideView is delighted to introduce the new companyId endpoint that will retrieve the current company ID only for an existing company that is merged with the new ID. Using the companyId endpoint you can search all old company IDs associated with a single companyID.
Note: These new endpoints are available free of cost and do not consume any API credits. A bulk version of this API endpoint accepts a list of up to 1000 companyIds.
InsideView APIs have also introduced a new response parameter “currentCompanyId” in all our Company related API endpoints, which will be populated only if the requested CompanyID is outdated.
Here are the API endpoints, which now supports the new currentCompanyId response parameter:
Data API Endpoints
- [GET] - Company Ids - Populates the currentCompanyId if an existing companyId is merged.
- [POST] - Company Ids - Shows all old company IDs associated with a single companyID.
- [GET] - Company Details - Populates the current companyId if an existing companyId is merged.
- [GET] - Company Details Job Results - Shows currentCompanyId in a .CSV response file. Populates the currentCompanyId only for the merged companyId.
- [GET] - Company Family Tree - Populates the currentCompanyId if an existing companyId is merged in requestCompany object.
- [GET] - Company Family Tree Job Results -Shows currentCompanyId in a .CSV response file. Populates the currentCompanyId only for the merged companyId.
- [GET] - Company Competitor Information API - Populates the currentCompanyId if an existing companyId is merged.
- [GET] - Company News Feed API - Populates the currentCompanyId if an existing companyId is merged
- [GET] - Company logos API - Populates the currentCompanyId if an existing companyId is merged.
- [GET] - Company Insights Tech Profile API - Populates the currentCompanyId if an existing companyId is merged.
Target API Endpoints
- [GET] - Contact Lookup - Populates the currentCompanyId if an existing companyId is merged.
- [GET] - Contact Lookup Job Results - Shows currentCompanyId in a .CSV response file. Populates the currentCompanyId only for the merged companyId.
Insights API Endpoints
- [GET] - Company News Agents Count - Populates the currentCompanyId if an existing companyId is merged.
- [GET] - Company News Agents - Populates the currentCompanyId if an existing companyId is merged.
Subscription API Endpoints
- Company Subscriptions - sends a notification alert when the companyId is modified or merged.
- News Subscriptions - Adds the currentCompanyId in the notification alert. Sends a notification alert when the companyId is modified or merged.
- FamilyTree Subscriptions - sends a notification alert when the companyId is modified or merged.
v1.75 - 2020-05-23
Search for Executives by Email Validation Status and Confidence Score
You can search for executives based on their email validation status -- either ValidEmail or ValidDoma
You can also narrow your executive search to those contacts that have a match confidence score that's acceptable to you. Use the new minContactConfidenceScore
These new parameters are accepted in the following API calls:
Data API Endpoints
- [GET] - Contact Search : Accepts new request parameters
- [GET] - Contact Details: Shows emails and email validation status in response.
- [POST] - Contact Details Job: Shows email validation status in a .CSV response file.
Target API Endpoints
- [GET] - Contact Lookup: Accepts new request parameters. Shows email hash and email validation status in response.
- [POST] - Contact Lookup Job: Accepts new request parameters. Shows email validation status in a .CSV response file.
- [GET] - New Contact Details: Shows email and email validation status in response.
- [POST] - New Contact Details Job: Shows email validation status in a .CSV response file.
- [POST] - Contact List: Shows email validation status in response.
- [POST] - Contact List Count: Accepts new request parameters.
Asynchronous (Batch) API Endpoints
- [POST] - Asynchronous (batch) Target Contact List Build API: Accepts new request parameters. Every Bulk API shows an extra column for emailValidationStatus.
v1.73 - 2020-02-23
NAICS Code Standardization and Wild Card Support
You can now use the wild card parameter (*) for building a list of companies with partial NAICS 2017 codes in the InsideView Target company list build APIs endpoint. With wild card character, you can find better company results in your list build with the standardized 6-digit NAICS codes.
For example, you can build a list of companies using the 2361* code, which will return the following NAICS company codes:
- 23611 - Residential Building Construction
- 236115 - New Single-Family House Construction (except for Sale Builders)
- 236116 - New Multifamily Housing Construction (except for Sale Builders)
- 236117 - New Housing for Sale Builders
- 236118 - Residential Remodelers
The wildcard parameter is now accepted in the [POST] - Company List API.
v1.71 - 2020-02-01
Filter and Find Executive’s with titles
A new titles request parameter is introduced in Contact Search API, which lets you filter and find executives with their Job Titles such as CEO, CFO, CTO, Managing Director, and other titles. The titles parameter retrieves job titles and increases the probability of finding executives that you wish to target for better business outreach.
The titles parameter is now accepted in the [GET] - Contact Search API.
Find Company’s Ticker Details
The tickers parameter shows the company’s stock market listing information. The tickers parameter retrieves the company’s ticker name and the stock market exchange where the company is listed to let you visualize the company’s stock market performance and their business trends.
The tickers parameter is now accepted in the [POST] - Company Matcher API Charter API.
v1.69 - 2019-12-07
InsideView APIs now allow you to access direct phone number(s) of executives provided, the direct number exists in the InsideView database.
This quarter we are happy to announce the following enhancements in our Contact APIs:
Request for Corporate and Direct Phone Numbers of Executives
A new phoneType request parameter in contact APIs now lets you access the CORPORATE and DIRECT phone numbers of an executive. The phoneType parameter retrieves direct phone numbers and increases the probability of directly contacting your prospect for better business outreach.
The phoneType parameter is accepted in the following Contact APIs:
Data API Endpoints
Enrich API Endpoints
Target API Endpoints
- [GET] - Contact Lookup
- [GET] - Contact Lookup Job Results
- [GET] - New Contact Details
- [POST] - Contact List
- [POST] - Contact List Count
- [POST] - New Contact Details Job
v1.62 - 2019-05-25
We have been steadily working for the past few months to offer new options to enrich contact and company information with our Contacts OnDemand database. The OnDemand database offers companies and contacts that are not available via InsideView applications.
This month we are introducing a new API to enrich from extended database:
Enrich Data from Extended DB (BETA Release)
Use the Enrich Data from ExtendedDB endpoint to enrich company and contact data with a single query. This endpoint enables your users to enrich contact and company data immediately based on inputs from OnDemand database.
Additional matches can be found for a contact and company when use [POST] - Enrich Data from Extended DB instead of [POST]- Enrich endpoint.
Please note that this endpoint is still under BETA phase. For more information, read the endpoint article [POST] - Enrich Data from Extended DB in our Knowledge Base.
v1.61 - 2019-04-28
Matcher API enhancement
the Company Matcher API will now return Rank field value for a company. This value is generated based on the match score and input request parameters. A higher rank indicates a better match result. Please note that this endpoint is still under Beta phase.
v1.60 - 2019-03-30
Target Contact List Build API - Technologies Used Improvements
The Target Contact List Build API now allows you to filter contacts based on the technologies used by their Company. The Contact List Build API now lets you retrieve contacts using the 30 product categories and 737 sub-categories for frontend and backend hardware and software technologies that are available in InsideView’s Tech Profiler add-on.
You can define product category and sub-category parameters in Target Contact List API using the following new filter options:
- categoryIds
- subCategoryIds
- productIds
See the endpoint documentation for more details.
v1.58 - 2019-02-02
Subscription API for Family Tree (GA Release)
The subscription API for family tree is now GA released.
Support for Direct Phone Numbers of Executives
InsideView APIs now return direct phone number(s) of executives provided, the direct number exists in the InsideView database. With this feature, you will now have access to the direct phone number of an executive. InsideView’s Direct Phone Number feature will increase the probability of directly contacting your prospect for better business outreach.
v1.53 - 2018-09-22
This month the following enhancements are introduced:
Subscription API for Family Tree (Beta Release)
A new companyFamilyTree subscription API now lets you monitor changes in familyTree of an Ultimate Parent Company that you are following. This is a new Subscription Type API sends alerts to subscribers if any Company is either added or removed from a Family Tree.
You can also set up the frequency (weekly, monthly or yearly) for subscription alerts. This API accepts only Ultimate Parent Company ID for Family Tree subscriptions.
v1.50 - 2018-06-23
We have been steadily working on API backend development for over a year now to build microservices based architecture in order to support faster feature development and scale. We are back now to introduce customer facing features with new releases.
This month we have below enhancements:
Contact Details with Contact Confidence Score
Next time you get details from our Contact Details API, one of the details will be a confidence score. This serves as an indicator of how confident you can be in the contact accuracy.
Company Matcher as a Service
Company Matching will now have a higher match rate due to a new matching algorithm. This is a new API endpoint that can be used exclusively to perform Company Matching. Please reach out to your account manager if you wish to get access to this endpoint.
v1.35 - 2017-05-06
This month we have two significant enhancements :
- Company Social Handles - Company fetch endpoints and Company List build calls will now include social handles (Facebook, Twitter, Blog, URL) when available, making it easier for end users to follow their prospects.
- Company Name in Target Company List Build - Target company list build call will now include the company name as part of the results.
v1.33 - 2017-03-18
This month we’re excited to introduce a new field in our collection of Company details API.
- companyTaxId - Company Tax Id is now available as part of Company details API for US companies when available.
v1.30 - 2016-12-19
Internal release for upcoming features.
v1.29 - 2016-11-19
This month we’re excited to introduce a new API to our collection.
- Contact Async List build API - The InsideView API now has the capability to do an async contact list build. This feature will allow you to run time consuming queries in an offline manner.
v1.28 - 2016-10-22
This month we’re excited to introduce the following key improvements to our API
- FamilyTree bulk API is a new API endpoint allowing you to get family tree data in bulk
- Competitive company information is now available via a new API endpoint for public companies. To access this information, use:
- For normal companyId: https://api.insideview.com/api/v1/company/{companyId}/competitors
- For new companyId: https://api.insideview.com/api/v1/target/companies/{scrambledId}/competitors
- Contact Geo information has been added to the Bulk Contact Lookup API
v1.27 - 2016-9-24
In This release we have introduced several enhancements.
- Local contact geo location is now available to use in the Target Contact List Build API, Data Contact Search API, and People Details APIs. You can do a list build by using “peopleArea”as a filter, and when you want to narrow the list further to contacts who also have headquarters in another specific location, you can do so by combining “peopleArea” with company “cities.”
- Asynchronous (batch) Target Company List Build API can now be used to build lists that exceed the 100K limit on the standard list build API.
- Target Contact List Build API responses will now include “peopleId.”
- Data Company Search API now supports searching by zip code and country filters together.
- Enrich API (+Bulk) offers a new filter for “contactMatching.” You can choose to match on active employments only (default), inactive ones, or all.
- In situations where a bulk job is interrupted, it will now resume from the point where it stopped.
v1.26 - 2016-8-28
In this release we have introduced two new functionalities:
· News Search with company IDs (previously only with new company IDs)
· Full Name search functionality in Contact Search, Target Contact Search and Lead Enrich APIs.
v1.25 - 2016-7-30
In This release we have introduced several enhancements.
- Wrong Info Feedback API for Contacts
- Last month we introduced the Company Wrong Info Feedback API and now you can help us keep our contacts clean, as well. These new endpoints allow you to submit updated information and track the status of feedback you provide.
- Target Company Lookup API Enhancements
- This API now supports tech profiles, diversity information, and company name filters.
- Contact Full Name
- Contact Full Name is now available in the response for all APIs that return FirstName and LastName. The list includes: Data Contact Details (normal and bulk), Data People Details, Target Contact List Build, and Target New Contact Details (normal and bulk).
- Enrich API
- The Enrich API will now match your data to inactive (past) contacts, when the information is available.
v1.24 - 2016-7-02
In this release we have introduced new endpoints for submitting Wrong Information to InsideView as well as new filters based on Diversity Data for list build APIs. We have also exposed a new custom header for extracting Target Company Insights based on enhanced logic. For more details please visit the company insights news page.
- Company Wrong Info Feedback API - With this new API, you can help us keep our database clean by reporting wrong company information. The new endpoints allow you to submit updated information and also track the status of feedback you provided.
- Now you can collect diversity information as part of a company fetch (+Bulk) or any relevant Target API. Diversity information includes such things as ethnicity and minority business status.
v1.23 - 2016-6-12
This month, we have a couple of exciting API enhancements to share with you.
- We’re now offering a People Subscription API on a charter basis and are looking for a handful of partners who would like to try it out. The API sends an alert when there is any change to an individual’s profile - as identified by a People ID - indicating which field has changed. You can then choose whether or not to fetch the updated record.
- All Bulk APIs now include an optional webhook that will notify you when your job is complete. No need to keep polling the server to determine when your job is done. Note: It’s important to validate the webhook when you create the job, as you will not be able to modify it after the job is created.
v1.22 - 2016-5-07
In this release we have done several enhancements in our APIs.
- Search with company name is now supported for Target List Build APIs.
- Added jobLevels, jobFunctions in response of Enrich API and its bulk version.
- News Alert fetch with timestamp - return standard ISO format instead of long format.
NEW ENDPOINT :TechProfile API with normal companyId in Data APIs.
v1.21 - 2016-4-16
In this release, we have introduced several new APIs:
-
Reference API for TechProfile
-
API to fetch TechProfile details of a company using new id.
-
API (Target Company Insights News Search API) to search company news at granular level using new company id.
-
API (Target Company Insights News details API) to get company news based on articleIds (get articleIds using Target Company Insights News Search API).
-
Subscription API – New API to get granular details about alerts
Note: The capability to fetch TechProfile details is available only for Target Company List API and not for Target Contact List API.
New Improvements:
- We have also added new filters in Target company list api: “categoryIds”, “subCategoryIds” & “productIds”.
- New fields “firstName” & “lastName” in response of Target Contact List API.
- New field “peopleId” in response of all contact fetch related endpoints including enrich.
- Support for Multiple states in Target company and contact list APIs.
v1.20 - 2016-3-12
In this release, we have introduced reference APIs for Job levels and Job functions along with Charter release of People Fetch APIs.
- Reference API’s for jobLevel and jobFunction.
- Adding “jobLevels”, “jobFunctions” fields in contact fetch (+Bulk) , target contact fetch (+Bulk) APIs.
- People Fetch API - {{url}}/v1/people/{peopleId}
v1.19 - 2016-2-13
In this release, we have introduced new API to get Tech profile for a given company. We have also introduced validation of webhooks for Subscription APIs.
- Tech Profile API - {{url}}/v1/company/{companyId}/insights/techProfile
v1.18 - 2016-1-23
In this release, we have introduced one new APIs to fetch company logos. Logos are available in three different sizes. Please note that not all companies have logos.
- Company Logo API - {{url}}/v1/company/{companyId}/logos
v1.17 - 2015-12-19
Internal release for upcoming features.
v1.16 - 2015-11-28
In this release, we have introduced two new APIs for company and contact news.
- Company News Feed API - {{url}}/v1/company/{companyId}/newsFeed
- Contact News Feed API - {{url}}/v1/contact/{contactId}/newsFeed
v1.15 - 2015-11-07
Usability Improvements
- Include Job Level and Job Function attributes in Target Contact Lookup API response.
- revenueRange, employeeRange, foundationDate is added in company related endpoints.
This release also kick starts the Free API trial program and Subscription API Charter program.
v1.14 - 2015-10-10
Family Tree API - Company Family Tree
- New Family Tree API -{{url}}/v1/company/{companyId}/familyTree
Usability Improvements
-
Target contact List Build – The parameters “companyIdsToInclude” and “companyIdsToExclude” supports both Scrambled CompanyIds and normal CompanyIds.
v1.13 - 2015-09-12
Company Lookup API - Company Lookup
- New end point {{url}}/v1/target/company/lookup
Usability Improvements
- Consumption History Usage API ( URL is appended to the response )
- Show credits consumed for all bulk jobs in list all bulk jobs List Bulk Jobs
Error handling for Bulk Job API's
- Company/Contact Bulk Company - API / Bulk Contact - API
- Enrich Bulk Enrich API - CSV
- Target Company/Contact Bulk Get New Contact Target API / Bulk New Company Details
- Target Company LookUp Bulk Contact Lookup Target API [People tab]
v1.12 - 2015-08-08
In This release we continue to improve our API capabilities by supporting additional filters and fields. We have also introduced the bulk API version for new company details endpoint.
- Richer filters
- Enrich APIs allow the following new filters:
- isContactRequire
- isEmailRequired
- isPhoneRequired
- Target Contact List APIs allow the following new filters:
- companyIdsToExclude
- companyIdsToInclude
- Enrich APIs allow the following new filters:
- Richer responses
- Contact related APIs
- age (Data Contacts Details API, Enrich API, Target New Contact Details API)
- salary (Data Contacts Details API, Enrich API, Target New Contact Details API)
- salaryCurrency (Data Contacts Details API, Enrich API, Target New Contact Details API)
- Company related APIs
- mostRecentQuarter (Data Company Details API, Enrich API, Target New Company Details API)
- Contact related APIs
- New Endpoint - Target New Company Details
- Fixed bugs
v1.11 - 2015-07-11
The main goal with v1.11 is to bring a host of small enhancements both in terms of richer filters and richer responses. Please see each endpoint documentation for more details.
Note: for each modification, both the regular and the bulk versions received the enhancements.
- Richer filters
- Contact related APIs allow the following new filters:
- isPhoneRequired (Target Contact List API, Target Contact Lookup API)
- isEmailRequired (Target Contact List API, Target Contact Lookup API)
- active (Data Contact Search API, Target Contact List API, Target Contact Lookup API)
- companyIdsToInclude (Target Contact List API): allows finding contacts within a set of companies
- Contact related APIs allow the following new filters:
- Richer responses
- Contact related APIs
- active (Data Contacts Details API, Target Contact Lookup API, Target New Contact Details API)
- Contact Lookup API, Target New Contact Details API)
- hasPhone (Data Contact Search API, Target Contact List API)
- hasEmail (Data Contact Search API, Target Contact List API)
- Company related APIs
- parentCompanyName (Enrich API, Data Company Details API, Target New Company Details API)
- parentCompanyCountry (Enrich API, Data Company Details API, Target New Company Details API)
- ultimateParentCompanyName (Enrich API, Data Company Details API, Target New Company Details API)
- ultimateParentCompanyCountry (Enrich API, Data Company Details API, Target New Company Details API)
- zip (Target Company List API)
- Contact related APIs
- Target New Contact Details API: new query parameter retrieveCompanyDetails: optionally fetch company details when fetching new contact details
See [GET] - New Contact Details for more details
- Administration APIs: added a new API to list current and past job submitted from various bulk APIs
See the documentation for more details
- Fixed bugs
v1.10.1 - 2015-06-16
- Fixed some bugs
v1.10.0 - 2015-05-16
- First 2 APIs in the new Person API collection
- Person Search API – find a person based on his or her email address or name.
See [GET] - Person Search for more details. - Person Details API – retrieve up to a dozen details about a person, including photo, bio, education details, and more.
See [GET] - Person Details for more details.
- Person Search API – find a person based on his or her email address or name.
- Target API enhancements
- Get up to 500 Contact and Company List API responses on a page.
See the documentation for more details.
- Get up to 500 Contact and Company List API responses on a page.
- Enrich API enhancements
- See matching scores and select a minimum score for the API to return a result.
See the documentation for more details. - Track match rates and view results with the API Usage API.
See [GET] - API Usage for more details.
- See matching scores and select a minimum score for the API to return a result.
- Admin API additions to fetch reference data
- Countries List API – retrieve the list of available countries and their codes.
See [GET] - Countries List more details. - Industries List API – retrieve the list of industries and sub-industries, and their codes.
See [GET] - Industries List for more details.
- Countries List API – retrieve the list of available countries and their codes.
- Fixed some bugs
v1.9.0 - 2015-04-18
- Added British SIC code and description to the following API responses:
- Fixed some bugs
v1.8.0 - 2015-04-04
- Internationalization: some endpoints have been updated in order to support the standard Accept-Language HTTP header. It allows to retrieve a localized version industry and subIndustry fields and to have revenues in a currency corresponding to the locale passed. The currency is indicated in a new field, revenueCurrency.
The following locales are supported: en-en, en-uk, en-ie, de-de, fr-fr, nl-nl and sp-sp.
See Internationalization Support for more details, including the list of endpoints impacted. - Endpoints supporting internationalization also include the following new attributes: industryCode and subIndustryCode
See API Reference Data for the list of industry and sub-industry codes. - Fixed some bugs
v1.7.0 - 2015-02-21
- Released in the Insights API collection a set of API to access and manage InsideView for Sales users watchlists
See the documentation for more details - Added an attribute to the Company News Agent API in the Insights API Collection: imageUrl. It provide a link to an image associated with the news article.
See [GET] - Company News Agents for more details - Added some attributes to the Contact Lookup API in the Target API collection: hasPhone, hasEmail, hasTwitterHandle, hasLinkedInHandle, hasFacebookHandle.
These attributes help making the decision to fetch the details of a specific lookup results to access valuable information.
See [GET] - Contact Lookup for more details - The Bulk Contact Lookup API in the Target API collection is GA.
See the documentation for more details - Fixed some bugs
v1.6.0 - 2015-01-31
- Released bulk version of the TargetAPI Collection's Contact Lookup endpoint in BETA
See the endpoint documentation for more details - Fixed some bugs
v1.5.0 - 2015-01-03
- Released the Contact List endpoints in the Target API Collection:
- Contact List API. It allows retrieving a list of contacts using advanced search parameters.
See [POST] - Contact List for more details - Contact List Count API. It allows counting the number of results a Contact List API call would retrieve.
See [POST] - Contact List Count for more details
- Contact List API. It allows retrieving a list of contacts using advanced search parameters.
- Added an attribute to the Target API collection's Contact Lookup endpoint response: an MD5 hash of the contact email, allowing to detect contacts you already own.
See [GET] - Contact Lookup for more details - Released bulk version of the Target API Collection's New Contact Details endpoint.
See the endpoint documentation for more details - Fixed some bugs
- Added Endpoints List to help navigating the API endpoints documentation
v1.4.0 - 2014-12-06
- Released the Company List endpoints in the Target API Collection:
- Company List API. It allows retrieving a list of companies using advanced search parameters.
See [POST] - Company List (List Build) for more details - Company List Count API. It allows counting the number of results a Company List API call would retrieve.
See [POST] - Company List Count for more details - New Company Details API. It allows retrieving the full details of a company found using the Company List API.
See [GET] - New Company Details for more details
- Company List API. It allows retrieving a list of companies using advanced search parameters.
- Fixed some bugs
v1.3.0 - 2014-11-01
- Released the first 2 API in the Insights API collection - please note that these endpoints are beta endpoints:
- Company News Agents API. It allows retrieving news feed sorted by our standard smart agents for a specific company.
See [GET] - Company News Agents for more details - Company News Agents Count API. It allows counting news per standard smart agents for a specific company.
See [GET] - Company News Agents Count for more details
- Company News Agents API. It allows retrieving news feed sorted by our standard smart agents for a specific company.
- Fixed some bugs
v1.2.0 - 2014-10-03
- Released an Administration API: Usage API. It allows retrieving details on your past API usage as well as some details on your API credits consumption.
See [GET] - API Usage for more details - Fixed some bugs
v1.1.1 - 2014-09-05
- CORS is now supported. Please contact InsideView Support for enabling and configuring this feature
- Fixed some bugs
v1.1 - 2014-08-09
- The API documentation (https://api.insideview.com) have been moved to the Knowledge Base (InsideView API).
The full API documentation is now conveniently available in one place. - Added bulk version of the Contact Details API, Company Details API and Enrich API. These API allow to group and execute asynchronously up to 10,000 queries.
See Using the Bulk APIs for more details. - Added first API in the Target API collection: Contact Lookup API. It allows searching new contact by job level, job function or title in a specific company. The New Contact Details API allows fetching full details of a contact found through the Contact Lookup API.
See Using the Target API for more details. - Improved error messages by provide an InsideView error code to provide easier way to handle various error conditions for each HTTP status.
See API Errors Codes article for more details. - Fixed some bugs.
Known Issues
- CORS is not supported.
v1.0.1 - 2014-07-04
- Added a new optional parameter active to contacts API to allow returning only contacts with active or inactive employment records. When the parameter is omitted both active and inactive ones are returned
- Improved search results relevance for the contacts API
- Fixed some bugs
Known Issues
- CORS is not supported.