Filters
Filters are passed as query parameters to control which articles are returned. Their order does not matter, but when chaining filters, only articles satisfying all filters (AND logic) are returned.
Article types
Section titled “Article types”Filter by article type using the articleTypes parameter. By default, all types are included.
Available values (comma-separated): article, video, gallery, report, pressrelease, podcast
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&articleTypes=article,video"Topics
Section titled “Topics”Filter by topic using the includeTopics parameter with a comma-separated list of topic IDs.
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&includeTopics=1,4,5"See Appendix A: Topics for the full list of topic IDs.
Companies
Section titled “Companies”Include or exclude articles by specific companies using includeCompanies and excludeCompanies parameters (comma-separated company IDs).
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&includeCompanies=1&excludeCompanies=8,12"See Appendix B: Organisations for the full list of company IDs.
Exclude sources by domain
Section titled “Exclude sources by domain”Use the additionalSources parameter with a comma-separated list of domains to exclude.
The parameter matches against the start of the article URL, so:
bbc.comexcludes all BBC articlesnews.bbc.com,sport.bbc.comexcludes specific subdomainsbbc.com/entertainment/excludes a specific section
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&additionalSources=bbc.com"Paywalled articles
Section titled “Paywalled articles”Exclude articles behind paywalls using includePaywalled. Paywalled articles are included by default.
| Value | Behaviour |
|---|---|
1 | Include paywalled articles (default) |
0 | Exclude paywalled articles |
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&includePaywalled=0"Registration required articles
Section titled “Registration required articles”Exclude articles requiring free registration using includeRegistration. Included by default.
| Value | Behaviour |
|---|---|
1 | Include registration-required articles (default) |
0 | Exclude registration-required articles |
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&includeRegistration=0"iFrameable sources
Section titled “iFrameable sources”Exclude articles from sources that don’t allow iFraming using excludeNonIframeableSources.
| Value | Behaviour |
|---|---|
0 | Include non-iframeable articles (default) |
1 | Exclude non-iframeable articles |
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&excludeNonIframeableSources=1"Non-HTTPS sources
Section titled “Non-HTTPS sources”Exclude articles from websites that don’t use HTTPS using excludeNonHttpsSources. This prevents browser security warnings about insecure resources.
| Value | Behaviour |
|---|---|
0 | Include non-HTTPS articles (default) |
1 | Exclude non-HTTPS articles |
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&excludeNonHttpsSources=1"Search terms
Section titled “Search terms”Use the searchTerms parameter with a comma-separated list of keywords to filter articles by headline or introduction.
curl "https://widget.slipcase.com/api/v2/feed/?apiKey=YOUR_API_KEY&searchTerms=yacht,boat"