[GET] - Watchlist Feed{Deprecated} – InsideView

Use the Watchlist Feed endpoint to retrieve the activity stream for companies included in the selected Watchlist of an InsideView for Sales user.

Note: In order to be able to use this API, you will need:

a special API key, linked to your InsideView for Sales account
InsideView for Sales admin privileges to generate an "admin" consent to access user data through the API.

See Authentication and Authorization Overview for more details.

Endpoint

GET https://api.insideview.com/api/v1/insights/watchlist/feed

Request

HTTP Headers

Header Name	Type	Required	Description
accessToken	String	Yes	Valid access token with code grant. 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).

Query Parameters

Parameter Name	Type	Required	Description
userEmail	String	Yes	Email address of the InsideView Sales user you want to retrieve the list of watchlists for. The email address should match the one registered in InsideView Sales application for the user.
watchlistIds	String	No	A comma separated list of Watchlist Ids
agents	String	No	A comma separated list of agents ID (see below) See API Reference Data the list of Agents.
page	Integer	No	Default value: 1
resultsPerPage	Integer	No	Default value: 10, Max value: 500

Responses

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header.

Name	type	Description
companyActivityStream	Array	Array of company activity stream
companyActivityStream>companyId	String
companyActivityStream>companyName	String
companyActivityStream>agents	Array	Array of agents
companyActivityStream>title	String
companyActivityStream>articleDate	Date
companyActivityStream>articleUrl	String
companyActivityStream>source	String

application/json example

{
    "companyActivityStream":[
        {
            "companyId":"730247",
            "companyName":"Amazon.com, Inc.",
            "agents":[
                "REALESTATE_CONSTRUCTION"
            ],
            "title":"ANDIAMO : Partners Signs Long-Term Lease at 17 State Street through Savills Studley",
            "articleDate":"Dec 30, 2014 5:05:51 AM PST",
            "articleUrl":"http://ct.moreover.com/?a=19994944476&p=1l3&v=1&x=xdnLAYEZLR77P4msPv_A-A",
            "source":"4 Traders"
        },
        {
            "companyId":"726263",
            "companyName":"Microsoft Corporation",
            "title":"Microsoft Corporation New Browser: “Spartan”",
            "articleDate":"Dec 30, 2014 4:59:57 AM PST",
            "articleUrl":"http://ct.moreover.com/?a=19994896070&p=1l3&v=1&x=5GAB82X9GrMXXyviNh3k4A",
            "source":"Bidness Etc"
        },
        {
            "companyId":"726263",
            "companyName":"Microsoft Corporation",
            "title":"Microsoft recognizes 9 Bangladeshis as MIE experts",
            "articleDate":"Dec 30, 2014 4:51:30 AM PST",
            "articleUrl":"http://ct.moreover.com/?a=19994835979&p=1l3&v=1&x=DBzvUwGi3O7xakVtbNWAcQ",
            "source":"Bangladesh Sangbad Sangstha"
        }
    ],
    "page":"1",
    "resultsPerPage":"3"
}

application/xml example

<?xml version="1.0" encoding="UTF-8"?>
<activityStreamFeedList>
    <companyActivityStream>
        <companyId>730247</companyId>
        <companyName>Amazon.com, Inc.</companyName>
        <agents>REALESTATE_CONSTRUCTION</agents>
        <title>ANDIAMO : Partners Signs Long-Term Lease at 17 State Street through Savills Studley</title>
        <articleDate>Dec 30, 2014 5:05:51 AM PST</articleDate>
        <articleUrl>http://ct.moreover.com/?a=19994944476&amp;p=1l3&amp;v=1&amp;x=xdnLAYEZLR77P4msPv_A-A</articleUrl>
        <source>4 Traders</source>
    </companyActivityStream>
    <companyActivityStream>
        <companyId>726263</companyId>
        <companyName>Microsoft Corporation</companyName>
        <title>Microsoft Corporation New Browser: “Spartan”</title>
        <articleDate>Dec 30, 2014 4:59:57 AM PST</articleDate>
        <articleUrl>http://ct.moreover.com/?a=19994896070&amp;p=1l3&amp;v=1&amp;x=5GAB82X9GrMXXyviNh3k4A</articleUrl>
        <source>Bidness Etc</source>
    </companyActivityStream>
    <companyActivityStream>
        <companyId>726263</companyId>
        <companyName>Microsoft Corporation</companyName>
        <title>Microsoft recognizes 9 Bangladeshis as MIE experts</title>
        <articleDate>Dec 30, 2014 4:51:30 AM PST</articleDate>
        <articleUrl>http://ct.moreover.com/?a=19994835979&amp;p=1l3&amp;v=1&amp;x=DBzvUwGi3O7xakVtbNWAcQ</articleUrl>
        <source>Bangladesh Sangbad Sangstha</source>
    </companyActivityStream>
    <page>1</page>
    <resultsPerPage>3</resultsPerPage>
</activityStreamFeedList>

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 404

Invalid ID, record not found.

HTTP 429

Request is throttled.

Articles in this section

[GET] - Watchlist Feed{Deprecated}