Article Object

The article object provides details about an article supplied by the Slipcase news service. This documentation describes the object as returned by the JSON output format. The RSS output follows RSS 2.0 with an additional image per item.

Attributes

Attribute	Type	Description
id	integer	Unique Slipcase identifier for the article
heading_md5	string	MD5 hash of the article heading, useful for caching strategies
heading	string	Article title. No HTML markup
slug	string	URL-friendly version of the heading for deep-linking to Slipcase.com or your own application
organisation	object	Publisher information. See Organisation Object
excerpt	string	Article introduction, max 255 characters, no HTML. Ends with ”…” if truncated
topics	array	Collection of Topic objects assigned to this article
paywalled	boolean	Whether the article requires a paid subscription to view
registration_required	boolean	Whether the article requires free registration to view
web_url	string	URL to view the full article (routed via Slipcase.com)
domain	string	Website hosting the article. Display to users, but link to web_url
published_date	datetime	ISO 8601 date and time the article was published on Slipcase
article_type	string	One of: article, video, gallery, report, pressrelease, podcast
geographies	array	Geographic tags for the article. See Geography Object. Only present when tags exist

Images

All images are hosted by Slipcase — your application does not need to store any image assets locally.

Attribute	Description
featured_image_url	Main article image (landscape rectangle)
organisation_logo_url	Square logo/icon for the article’s publisher
organisation_cover_url	Hero-style image for the publisher, suitable for profile pages

Push API payload

When using the Push API integration, article objects are delivered in a flat JSON format with the following attributes:

Attribute	Type	Description
id	integer	Unique Slipcase article identifier
heading	string	Article title (no HTML)
excerpt	string	Short introduction, max 255 characters
body	string | null	Full article body (HTML). Null for link-only articles
featured_image	string | null	Main article image URL
additional_images	array | null	Additional image URLs (available for some sources)
date	string	Publication date in YYYY-MM-DD format
url	string	Slipcase-routed URL to the full article
article_type	string	One of: article, video, gallery, report, pressrelease, podcast
article_format	integer	1 = link-only (no body text), 2 = full-text
topics	string[]	Topic names assigned to the article
organisation_logo_url	string | null	Publisher logo URL (null for default publisher)
organisation_name	string | null	Publisher name (null for default publisher)
external_url	string | null	Original source URL
paywalled	boolean	Whether the source article is behind a paywall
registration_required	boolean | null	Whether the source requires free registration

Note

The push payload differs from the pull API response. Push payloads include body, additional_images, article_format, and external_url which are not present in pull responses. Pull responses include heading_md5, slug, organisation (as a nested object), web_url, domain, and published_date which are not present in push payloads.