Getting Started

This overview will give you some idea of what data is available, how to find what you need and what you will see when you make an API request.

First of all and to get an API key, you have to have an account on DISCO. If you do not have one already, sign up now to get an instant access.

Steps to get your API key:

1. Log in to your account.
2. Click on the cog icon next to your logo.
3. Click on the first option (Welcome, User Name) and you will be redirected to your dashboard.
4. Click on Content API tab.
5. Copy your API key.

Endpoints

We provide several endpoints to retrieve different items:

A. All/ Filtered Content

B. Single Item (One Piece of Content)

C. Alerts

D. Saved Searches

Notes:

• For end point (A), results can be filtered using the following parameters:
  • API key
  • id
  • content_format_id_i
  • title_id_i
  • date_tdt
  • headline_s
  • publisher_s
  • topic_category_ss
  • detailed_content_format_id_i
  • language_code_s
  • meta_body_s
  • title_name_s
  • country_category_ss
  • industryterm_category_ss
• End point (A) response contains all the results but the content is infull (truncated body). End point (B) retrieves single item in full. 
• Results of end point (A) are returned as paginated list of containing, by default, 20 entries per page.

A(1). All Content

The (all content) endpoint (/getUserLatestArticles) returns all pieces of content in your API (your account). For example, let’s suppose that the API key in the link below is yours.

https://marketplace.disco.info/api/getUserLatestArticles?api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

Here the (API key) parameter retrieves all the results in your API (all the results available in your DISCO account).

A(2). Filtered Content

Now, you might want to filter down the results to something more meaningful, specifically looking for English language content that includes the word “economic” and finally you want to sort the results retrieved descendingly by date,. The example below shows how you can do that.
We will go through all the parameters you can use to filter down your results in the (search) section of this documentation. Here, we will explain only how you can use the query operators.

https://marketplace.disco.info/api/getUserLatestArticles?search_free_text=economic&languages=en&sort=DESC&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

Query operators

The search_free_text parameter supports AND, OR and NOT operators. Below we explain how you can use the mentioned as conjunctions to combine or exclude keywords in your search, resulting in more focused and productive API results.

Exact Phrase
To search for an exact phrase, write the exact phrase as is, without adding any operators or quotation marks.
Ex: Information Technology would retrieve content containing this exact phrase within the headline or body of the article.
https://marketplace.disco.info/api/getUserLatestArticles?search_free_text=information technology&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

And
The AND operator matches articles where both terms exist anywhere in the text of a single article
Ex: Omaba and Trump returns only content that contains both words; “obama” and “trump”.
https://marketplace.disco.info/api/getUserLatestArticles?search_free_text=obama and trump&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

Or
The OR operator will return results which include either, or both, of the terms.
Ex: Obama or Trump returns content that contains the word “obama”, the word “trump” or both words.
https://marketplace.disco.info/api/getUserLatestArticles?search_free_text=obama or trump&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

Not
The NOT operator excludes articles that contain the term(s) after NOT.
Ex: Obama not Trump returns content that contains the word “obama” but not the word “trump”.
https://marketplace.disco.info/api/getUserLatestArticles?search_free_text=obama not trump&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

B. Single Item:
The (single item) endpoint (/viewarticle) returns all the data we have for a given single item (piece of content) id. The parameters you should use are just your API key and the item (piece of conetnt) id as in the example below.
https://marketplace.disco.info/api/viewarticle?id=152580568&api_key=pciyVhdEo4uTxFte08Td8fKuuLksjj2ylaV6iYBwTVfgqylfx56

C. Alerts

When you create an alert on DISCO, we will send you emails when we find new results that match your search query and/or filters.
These results can be retrieved in your API as well and we will explain this further in the Alerts section of this documentation.

D. Saved Searches

Instead of writing the same query and/or entering the same filters multiple times; wasting your time and effort. You can save the searches you are using often and retrieve the results of each in a matter of a few clicks.
You can also see the results of your saved searches within your API. More details on this in the Saved Searches section of this documentation.