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: 30 |
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: 50, Default: 10 |
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, 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 |
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 |
application/json Example
{ "companyNews": [ { "title": "Google said to buy office buildings for RM1.9bil", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19347156172&cid=736233", "publicationDate": "Oct 23, 2014 10:51:00 PM PDT", "source": "KiniBiz", "agents": "ACQUISITIONS" }, { "title": "Google Said to Buy Redwood City Offices for $585 Million", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19346813726&cid=736233", "publicationDate": "Oct 23, 2014 9:54:00 PM PDT", "source": "Bloomberg", "agents": "ACQUISITIONS" }, { "title": "Firebase acquired by Google", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19330083354&cid=736233", "publicationDate": "Oct 22, 2014 8:52:00 AM PDT", "source": "Individual.com", "agents": "ACQUISITIONS" }, { "title": "Google buys Firebase to add real-time sync & store capabilities to its Cloud Platform", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19328853169&cid=736233", "publicationDate": "Oct 22, 2014 6:43:00 AM PDT", "source": "ServicesAngle", "agents": "ACQUISITIONS" }, { "title": "Google Acquires Firebase To Shore Up App Development Platform", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19328800188&cid=736233", "publicationDate": "Oct 22, 2014 6:38:00 AM PDT", "source": "Bidness Etc", "agents": "ACQUISITIONS", "similarNewsCount": "3" }, { "title": "Himax Technologies Tumbles; Google Won't Boost Stake", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19327737383&cid=736233", "publicationDate": "Oct 22, 2014 4:37:00 AM PDT", "source": "Benzinga.com", "agents": "ACQUISITIONS" }, { "title": "Google Buys Firebase to Add Cloud-Computing Mobile Tools", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19319789202&cid=736233", "publicationDate": "Oct 21, 2014 10:49:00 AM PDT", "source": "BusinessWeek", "agents": "ACQUISITIONS", "similarNewsCount": "2" }, { "title": "Report: Google taps Android exec to lead Chrome engineering team", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19306120365&cid=736233", "publicationDate": "Oct 20, 2014 6:45:00 AM PDT", "source": "SNL Financial", "agents": "LEADERSHIP_CHANGES" }, { "title": "White House nominates former Google exec to lead US patent office", "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19282765680&cid=736233", "publicationDate": "Oct 17, 2014 12:56:00 PM PDT", "source": "Big News Network", "agents": "LEADERSHIP_CHANGES" } ], "page": 1, "resultsPerPage": 9, "totalResults": 9,
"companyId": 726263,
"currentCompanyId": 1755 }
application/xml Example
<?xml version="1.0" encoding="UTF-8"?> <news> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 23, 2014 10:51:00 PM PDT</publicationDate> <source>KiniBiz</source> <title>Google said to buy office buildings for RM1.9bil</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19347156172&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 23, 2014 9:54:00 PM PDT</publicationDate> <source>Bloomberg</source> <title>Google Said to Buy Redwood City Offices for $585 Million</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19346813726&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 22, 2014 8:52:00 AM PDT</publicationDate> <source>Individual.com</source> <title>Firebase acquired by Google</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19330083354&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 22, 2014 6:43:00 AM PDT</publicationDate> <source>ServicesAngle</source> <title>Google buys Firebase to add real-time sync & store capabilities to its Cloud Platform</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19328853169&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 22, 2014 6:38:00 AM PDT</publicationDate> <similarNewsCount>3</similarNewsCount> <source>Bidness Etc</source> <title>Google Acquires Firebase To Shore Up App Development Platform</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19328800188&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 22, 2014 4:37:00 AM PDT</publicationDate> <source>Benzinga.com</source> <title>Himax Technologies Tumbles; Google Won't Boost Stake</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19327737383&cid=736233</url> </article> <article> <agents>ACQUISITIONS</agents> <publicationDate>Oct 21, 2014 10:49:00 AM PDT</publicationDate> <similarNewsCount>2</similarNewsCount> <source>BusinessWeek</source> <title>Google Buys Firebase to Add Cloud-Computing Mobile Tools</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19319789202&cid=736233</url> </article> <article> <agents>LEADERSHIP_CHANGES</agents> <publicationDate>Oct 20, 2014 6:45:00 AM PDT</publicationDate> <source>SNL Financial</source> <title>Report: Google taps Android exec to lead Chrome engineering team</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19306120365&cid=736233</url> </article> <article> <agents>LEADERSHIP_CHANGES</agents> <publicationDate>Oct 17, 2014 12:56:00 PM PDT</publicationDate> <source>Big News Network</source> <title>White House nominates former Google exec to lead US patent office</title> <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19282765680&cid=736233</url> </article> <page>1</page> <resultsPerPage>9</resultsPerPage> <totalResults>9</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.
Comments
0 comments
Please sign in to leave a comment.