[GET] - Company News Agents

  • Updated

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.
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.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-prod​uction 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-prod​uction 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-prod​uction and broadcast markets, announced the availability of ProSide</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23475681757&amp;aid=23475681757&amp;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&amp;aid=23456887528&amp;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&amp;aid=23443162395&amp;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&amp;aid=23440169643&amp;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&amp;aid=23426887964&amp;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&amp;aid=23417081964&amp;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&amp;aid=23415410585&amp;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&amp;aid=23407906537&amp;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&amp;aid=23406596179&amp;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-prod​uction and broadcast markets, announced the...</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23400457044&amp;aid=23400457044&amp;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.