Use the Insights API's Company News Agents endpoint to retrieve categorized news for a specific company.
Endpoint
GET https://api.insideview.com/api/v1/insights/company/{companyId}/agents
Request
HTTP Headers
Header Name | Type | Required | Description |
accessToken | String | Yes |
Valid access token. |
Accept | String | No |
Selects the response's content type. Use below mentioned values to access New News Platform based search application/api.insights.beta+json application/api.insights.beta+xml |
URI Parameters
Parameter Name | Type | Required | Description |
companyId | Integer | Yes | A valid company ID |
Query Parameters
Parameter Name | Type | Required | Description |
days | Integer | Yes | Period length, ending with the current date to retrieve news for. Max value: 90 |
agents | String | Yes | A comma separated list of agents ID (see below) |
page | Integer | No | The page number of the result-set to return. Default: 1 |
resultsPerPage | Integer | No | The number of results in a page request. Min: 1, Max: 500, Default: 100 |
Agent Name | ID |
Leadership Changes | LEADERSHIP_CHANGES |
New Offerings | NEW_OFFERINGS |
Acquisitions | ACQUISITIONS |
Partnerships | PARTNERSHIPS |
Expanding Operations | EXPANDING_OPERATIONS |
Cost Cutting | COST_CUTTING |
Outperforming | OUTPERFORMING |
Underperforming | UNDERPERFORMING |
Company Presentation | COMPANY_PRESENTATION |
Litigation | LITIGATION |
Compliance | COMPLIANCE |
Research & Development | RESEARCH_DEVELOPMENT |
Data Security | DATA_SECURITY |
Funding Developments | FUNDING_DEVELOPMENTS |
Bankruptcy & Restructuring | BANKRUPTCY_RESTRUCTURING |
Real Estate: Deals | REALESTATE_DEALS |
Real Estate: Construction | REALESTATE_CONSTRUCTION |
Corporate Challenges | CORPORATE_CHALLENGES |
Responses
Here are the major responses the API may return.
For details on the errors, see API Error Codes.
HTTP 200
Returns either a JSON or XML data structure depending on the request Accept header.
Name | type | Description |
companyNews | Array | Array of company news |
companyNews title | String | News title |
companyNews url | String | News URL |
companyNews publicationDate | Date | Publication date and time (PST) of the article |
companyNews source | String | Article source |
companyNews agents | String | Categorization of the news |
companyNews imageUrl | String | URL of an image from the article. |
companyNews similarNewsCount | Integer | Number of similar news (not listed) |
page | Integer | Page number in the result set |
resultsPerPage | Integer | Number of search result per page |
totalResults | Integer | Total number of search results |
currentCompanyId | Integer | The current ID of the company |
Type: application/json
Schema
{
"$schema":"http://json-schema.org/draft-04/schema#",
"id":"/",
"type":"object",
"properties":{
"companyNews":{
"id":"companyNews",
"type":"array",
"items":[
{
"id":"0",
"type":"object",
"properties":{
"title":{
"id":"title",
"type":"string"
},
"url":{
"id":"url",
"type":"string"
},
"agents":{
"id":"agents",
"type":"string"
},
"publicationDate":{
"id":"publicationDate",
"type":"string"
},
"source":{
"id":"source",
"type":"string"
},
"similarNewsCount":{
"id":"similarNewsCount",
"type":"string"
},
"imageUrl":{
"id":"imageUrl",
"type":"string"
}
}
}
]
},
"page":{
"id":"page",
"type":"integer"
},
"resultsPerPage":{
"id":"resultsPerPage",
"type":"integer"
},
"totalResults":{
"id":"totalResults",
"type":"integer"
},
"companyId":{
"id":"companyId",
"type":"string"
},
"currentCompanyId":{
"id":"currentCompanyId",
"type":"integer"
}
}
}
Example
{
"companyNews": [
{
"title": "Pixel Film Studios Announces the Release of ProSidebar - Kinetic Edge Graphics for Final Cut Pro X November 22, 2015Pixel Film Studios, developer of visual effects tools for the post-production and broadcast markets, announced the availability of ProSide",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23475681757&aid=23475681757&cid=724468",
"publicationDate": "Nov 22, 2015 12:03:33 AM PST",
"source": "PRWeb",
"agents": "NEW_OFFERINGS"
},
{
"title": "LG Electronics Fails To Deliver; Cancels Rollout Of Watch Urbane 2nd Edition",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23456887528&aid=23456887528&cid=724468",
"publicationDate": "Nov 20, 2015 6:06:57 AM PST",
"source": "Bidness Etc",
"agents": "NEW_OFFERINGS"
},
{
"title": "ST JUDE MEDICAL : Announces FDA Approval of the Proclaim Elite SCS System, a Patient-Centric, Recharge-Free, Upgradeable and MR-conditional Chronic Pain Treatment Option",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23443162395&aid=23443162395&cid=724468",
"publicationDate": "Nov 19, 2015 5:09:54 AM PST",
"source": "4 Traders",
"agents": "NEW_OFFERINGS",
"similarNewsCount": "2"
},
{
"title": "Pixel Film Studios Announces the Release of ProMagnify -...",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23440169643&aid=23440169643&cid=724468",
"publicationDate": "Nov 19, 2015 12:04:55 AM PST",
"source": "Broadway World",
"agents": "NEW_OFFERINGS",
"similarNewsCount": "3"
},
{
"title": "Pixel Film Studios Announces the Release of ProText Squiggle - Picture...",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23426887964&aid=23426887964&cid=724468",
"publicationDate": "Nov 18, 2015 12:08:33 AM PST",
"source": "PRWeb",
"agents": "NEW_OFFERINGS"
},
{
"title": "Medtronic Announces FDA Approval and Launch of World's First App-Based Remote Monitoring System for Pacemakers",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23417081964&aid=23417081964&cid=724468",
"publicationDate": "Nov 17, 2015 6:03:07 AM PST",
"source": "Marketplace",
"agents": "NEW_OFFERINGS"
},
{
"title": "Apple Inc. (NASDAQ:AAPL) launches Apple Pay in Canada",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23415410585&aid=23415410585&cid=724468",
"publicationDate": "Nov 17, 2015 3:23:13 AM PST",
"source": "Octafinance",
"agents": "NEW_OFFERINGS",
"imageUrl": "http://cdn.octafinance.com/wp-content/uploads/2015/09/Apple_Oct_2014_18-1024x505.jpg"
},
{
"title": "Apple Inc. (AAPL): The New Payment Service Could Spell Doom For PayPal, Square",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23407906537&aid=23407906537&cid=724468",
"publicationDate": "Nov 16, 2015 12:23:14 PM PST",
"source": "Before It's News",
"agents": "NEW_OFFERINGS"
},
{
"title": "Apple May Break Tradition And Launch 4-inch iPhone By Mid-2016",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23406596179&aid=23406596179&cid=724468",
"publicationDate": "Nov 16, 2015 10:14:11 AM PST",
"source": "Bidness Etc",
"agents": "NEW_OFFERINGS",
"similarNewsCount": "3"
},
{
"title": "Pixel Film Studios Announces the Release of TransPanel Slide - Sliding Panel Transitions for FCPX November 15, 2015Pixel Film Studios, developer of visual effects tools for the post-production and broadcast markets, announced the...",
"url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23400457044&aid=23400457044&cid=724468",
"publicationDate": "Nov 16, 2015 12:10:45 AM PST",
"source": "PRWeb",
"agents": "NEW_OFFERINGS",
"similarNewsCount": "3"
}
],
"page": 1,
"resultsPerPage": 10,
"totalResults": 57,
"companyId":"726263",
"currentCompanyId":1755
}
Type: application/xml
Schema
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="news" type="NewsFeedDTO" />
<xs:complexType name="NewsFeedDTO">
<xs:sequence>
<xs:element name="news" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="article" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="agents" type="xs:string" />
<xs:element name="title" type="xs:string" />
<xs:element name="similarNewsCount" type="xs:string" />
<xs:element name="url" type="xs:string" />
<xs:element name="publicationDate" type="xs:string" />
<xs:element name="source" type="xs:string" />
<xs:element name="imageUrl" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="page" type="xs:int" />
<xs:element name="resultsPerPage" type="xs:int" />
<xs:element name="totalResults" type="xs:int" />
<xs:element name="companyId" type="xs:string"/>
<xs:element name="currentCompanyId" type="xs:integer"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>
Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<news>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 22, 2015 12:03:33 AM PST</publicationDate>
<source>PRWeb</source>
<title>Pixel Film Studios Announces the Release of ProSidebar - Kinetic Edge Graphics for Final Cut Pro X November 22, 2015Pixel Film Studios, developer of visual effects tools for the post-production and broadcast markets, announced the availability of ProSide</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23475681757&aid=23475681757&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 20, 2015 6:06:57 AM PST</publicationDate>
<source>Bidness Etc</source>
<title>LG Electronics Fails To Deliver; Cancels Rollout Of Watch Urbane 2nd Edition</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23456887528&aid=23456887528&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 19, 2015 5:09:54 AM PST</publicationDate>
<similarNewsCount>2</similarNewsCount>
<source>4 Traders</source>
<title>ST JUDE MEDICAL : Announces FDA Approval of the Proclaim Elite SCS System, a Patient-Centric, Recharge-Free, Upgradeable and MR-conditional Chronic Pain Treatment Option</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23443162395&aid=23443162395&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 19, 2015 12:04:55 AM PST</publicationDate>
<similarNewsCount>3</similarNewsCount>
<source>Broadway World</source>
<title>Pixel Film Studios Announces the Release of ProMagnify -...</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23440169643&aid=23440169643&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 18, 2015 12:08:33 AM PST</publicationDate>
<source>PRWeb</source>
<title>Pixel Film Studios Announces the Release of ProText Squiggle - Picture...</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23426887964&aid=23426887964&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 17, 2015 6:03:07 AM PST</publicationDate>
<source>Marketplace</source>
<title>Medtronic Announces FDA Approval and Launch of World's First App-Based Remote Monitoring System for Pacemakers</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23417081964&aid=23417081964&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<imageUrl>http://cdn.octafinance.com/wp-content/uploads/2015/09/Apple_Oct_2014_18-1024x505.jpg</imageUrl>
<publicationDate>Nov 17, 2015 3:23:13 AM PST</publicationDate>
<source>Octafinance</source>
<title>Apple Inc. (NASDAQ:AAPL) launches Apple Pay in Canada</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23415410585&aid=23415410585&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 16, 2015 12:23:14 PM PST</publicationDate>
<source>Before It's News</source>
<title>Apple Inc. (AAPL): The New Payment Service Could Spell Doom For PayPal, Square</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23407906537&aid=23407906537&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 16, 2015 10:14:11 AM PST</publicationDate>
<similarNewsCount>3</similarNewsCount>
<source>Bidness Etc</source>
<title>Apple May Break Tradition And Launch 4-inch iPhone By Mid-2016</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23406596179&aid=23406596179&cid=724468</url>
</article>
<article>
<agents>NEW_OFFERINGS</agents>
<publicationDate>Nov 16, 2015 12:10:45 AM PST</publicationDate>
<similarNewsCount>3</similarNewsCount>
<source>PRWeb</source>
<title>Pixel Film Studios Announces the Release of TransPanel Slide - Sliding Panel Transitions for FCPX November 15, 2015Pixel Film Studios, developer of visual effects tools for the post-production and broadcast markets, announced the...</title>
<url>http://my.insideview.com/iv/launchReferredArticle.do?id=23400457044&aid=23400457044&cid=724468</url>
</article>
<page>1</page>
<resultsPerPage>10</resultsPerPage>
<totalResults>57</totalResults>
<companyId>726263</companyId>
<currentCompanyId>1755</currentCompanyId>
</news>
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.