DISCO DEVELOPERS / MARKETPLACE API

Your content.
Your workflow.

Bring licensed content into your application. Everything you need to search, discover, and retrieve content from DISCO Marketplace.

Start building Looking for the Feeds API? →

BASE URLhttps://marketplace.disco.info/api

A simple first request

GET /getUserLatestArticles

curl --get 'https://marketplace.disco.info/api/getUserLatestArticles' \
  --data-urlencode 'api_key=YOUR_API_KEY'

Search. Discover. Integrate.

01 / THE BASICS

Up and running

Your API key connects requests to the content available in your Marketplace account.

Sign in to MarketplaceLog in or create an account.
Open your dashboardUse the cog beside your logo, then select “Welcome, User Name”.
Find your API keyOpen the Content API tab and copy your key.

Authentication

Add api_key=YOUR_API_KEY to the query string of each request. The examples below use a placeholder; replace it in your own integration.

02 / CONTENT ACCESS

One list. One full item.

Start with your available content, narrow the results, then retrieve the full item you need.

GET /getUserLatestArticles

All content

Retrieve content available to your Marketplace account. List results contain previews; use the single-item endpoint for full content.

                        curl 'https://marketplace.disco.info/api/getUserLatestArticles?api_key=YOUR_API_KEY'

GET /getUserLatestArticles

Filtered content

Use the same endpoint with search terms, languages, dates, and other filters.

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

GET /viewarticle

Single item

Retrieve the full content of a specific item using its ID and your API key.

                        curl 'https://marketplace.disco.info/api/viewarticle?api_key=YOUR_API_KEY&id=152580568'

03 / EXPLORE

Build your request

Choose a few options and get a ready-to-copy example. This builder generates code locally and does not send API requests.

curl --get 'https://marketplace.disco.info/api/getUserLatestArticles' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'search_free_text=economic' \
  --data-urlencode 'languages=en' \
  --data-urlencode 'sort=DESC'

04 / FIND WHAT MATTERS

Search filters

Add these query parameters to /getUserLatestArticles to refine your results.

Find a filter

Parameter	Purpose	Example / values
`search_free_text` String	Match a query against content.	`search_free_text=obama and trump`
`content_format` Integer	Filter by content format.	`content_format= 1; 4; 5`
`sort` String	Order results by publication date.	`DESC (newest first), ASC (oldest first)`
`date_from / date_to` date	Limit results to a date range.	`date_from=December 15, 2020&date_to=January 12, 2021`
`languages` String	Filter by content language.	`languages=en`
`titles` Integer	Select content services.	`titles=4012; 4013`
`detailed_content_format` Integer	Filter by detailed content format.	`detailed_content_format=1; 9`
`country_location` String	Filter by related countries.	`country_location=UK; UAE`
`industries` Integer	Filter by related industries.	`industries[]=104&industries[]=105`
`categories_list` Integer	Filter by topic.	`categories_list[]=25&categories_list[]=29`
`companies` String	Filter by company or organisation.	`companies[]=google&companies[]=dell`

Choosing filter values

The original guide refers to the response’s trees section for accepted IDs. The current local Marketplace controller removes trees from this endpoint. Use your account’s available selections or contact the team for the correct IDs.

05 / MORE PRECISE SEARCH

Make your query work harder

Use these expressions with search_free_text. URL-encode values when constructing requests; curl --data-urlencode handles this for you.

Exact phrase

information technology

Find the phrase in the headline or body.

AND

obama and trump

Match both terms within one article.

OR

obama or trump

Match either term, or both.

NOT

obama not trump

Match the first term and exclude the second.

Group clauses

(obama or trump) not (bush or clinton)

Combine clauses using parentheses.

Combine groups

(obama or trump) and United States

Match a group together with another phrase.

Literal operators

"Obama and Trump"

Use quotation marks when an operator is part of the phrase.

Proximity

obama trump~10

Find terms within the specified distance. Distance counts term movements, so word order also matters.

06 / READ THE RESULTS

Response reference

The original guide documents the following fields. Available fields can depend on the endpoint and content format.

Find a response field

Field	Description	Type
`content_format`	Content formats	String
`detailed_content_format`	Detailed content formats	String
`languages`	Languages of the content services you have	String
`titles`	Content services you are subscribed to	String
`countries`	Countries of the content services you have	String
`industries`	Industries of the content services you have	String
`topics`	Topics of the content services you have	String
`id`	Item ID	Integer
`title_id_i`	Content service ID	Integer
`language_code_s`	Content service language	String
`image_ss`	The ID, URL and captions of the image/s	String
`video_ss`	The ID, URL and captions of the video/s	String
`audio_ss`	The ID and the URL of the audio/s	String
`date_tdt`	Item (piece of content) date	Date
`meta_body_s`	Item (piece of content) summary	String
`headline_s`	Item (piece of content) headline	String
`publisher_s`	Item (piece of content) publisher	String
`title_content_format_s`	Item (piece of content) content format	String
`title_detailed_content_format_s`	Item (piece of content) detailed content format	String
`title_name_s`	Content service name	String
`country_category_ss`	Item (piece of content) countries	String
`topic_category_ss`	Item (piece of content) topics	String
`industryterm_category_ss`	Item (piece of content) industries	String
`page_limit`	The number of items returned in this call	Integer
`current_page`	The number of the page you are browsing	Integer
`next_link`	The API link you can use to browse the next page	String
`NumFound`	The number of results available for your search overall	Integer
`previous_link`	The API link you can use to browse the previous page	String

The guide’s lookup fields include content formats, languages, titles, countries, industries, and topics. These lookup collections are omitted by the current local list controller.

07 / KEEP GOING

Walk through your results

List responses contain up to 20 items per page by default. Read NumFound for the total, current_page for your position, and follow next_link or previous_link to navigate.

Preview → full content

Use a result’s id with /viewarticle to retrieve the complete item rather than its truncated list preview.

08 / REUSE YOUR SEARCHES

From saved search to integration

Alerts

Log in and run the search you want to monitor.
Choose Alerts, then Add New Alert.
Complete the fields and save.
Reopen Alerts and select the API button beside an alert to get its generated request URL.

Saved searches

Log in and run your search.
Choose “Save this search”.
Give it a name and save.
Open Saved Searches and select the API button beside a saved search to get its generated request URL.

Both workflows reuse the search’s filters. Copy the generated API URL into your integration.

Let’s connect your content.

Questions about access, filters, or your integration?

Get in touch ↗

Adapted from the original DISCO Marketplace API guide.

Up and running

One list. One full item.

All content

Filtered content

Single item

Build your request

Search filters

Make your query work harder

Exact phrase

AND

OR

NOT

Group clauses

Combine groups

Literal operators

Proximity

Response reference

Walk through your results

From saved search to integration

Alerts

Saved searches

Let’s connect your content.

Select to proceed