Use the Company Insights News detail API's endpoint to retrieve article URL of the news for a known article id. This API is used in conjunction with Company Insights News Search API.
Endpoint
POST https://api.insideview.com/api/v1/target/companies/insights/news
Request
HTTP Headers
Header Name | Type | Required | Description |
accessToken | String | Yes |
Valid access token. |
Accept | String | No | Selects the response's content type. Valid values are application/json and application/xml (default). |
Form Parameters
Parameter Name | Type | Required | Description |
articleIds | String | Yes | A comma-separated list of Article IDs retrieved from Search API. Max:10000 |
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 |
articleId | String | Article Id |
agentName | String | Agent Name |
url | String | Article launcher Url |
companyId | String | Company id |
application/json Example
{ "articles": [ { "articleId": "_BlTPgCruUChHgYmsrHJK80DgsXrUp8K1dtdF6vJlGa2FZOMKBleM6T11xdB2jdfczgM0JtxYlHfyhHa4PGH8w", "agentName": "PARTNERSHIPS", "url": "http://my.insideview.com/iv/launchReferredArticle.iv?id=26193693424&cid=726263&st=PARTNERSHI...", "companyId": "Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF" }, { "articleId": "_BlTPgCruUChHgYmsrHJK6BO4NBOcSC4IAbo4-ylhRahZ9xtY9i74nLR2Il4A2vI_z4DFTbPQRUOuvDx7bmFJQ", "agentName": "LITIGATION", "url": "http://my.insideview.com/iv/launchReferredArticle.iv?id=26200598583&cid=726263&st=LITIGATION...", "companyId": "Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF" } ] }
application/xml Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<articles>
<article>
<agentName>PARTNERSHIPS</agentName>
<articleId>_BlTPgCruUChHgYmsrHJK80DgsXrUp8K1dtdF6vJlGa2FZOMKBleM6T11xdB2jdfczgM0JtxYlHfyhHa4PGH8w</articleId>
<companyId>Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF</companyId>
<url>http://my.insideview.com/iv/launchReferredArticle.iv?id=26193693424&cid=726263&st=PARTNERSHIPS&from=api</url>
</article>
<article>
<agentName>LITIGATION</agentName>
<articleId>_BlTPgCruUChHgYmsrHJK6BO4NBOcSC4IAbo4-ylhRahZ9xtY9i74nLR2Il4A2vI_z4DFTbPQRUOuvDx7bmFJQ</articleId>
<companyId>Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF</companyId>
<url>http://my.insideview.com/iv/launchReferredArticle.iv?id=26200598583&cid=726263&st=LITIGATION&from=api</url>
</article>
</articles>
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.