RSS Feed API Documentation
RSS Feed API Documentation
Endpoint
GET https://content.api.sandbox.sportal365.com/editorial-content/rss
Description
This endpoint provides an RSS feed of editorial content, allowing you to retrieve and filter various types of content such as articles, videos, galleries, and liveblogs.
Note: This endpoint is versatile and can be used to create RSS feeds for different purposes:
- A general feed for all editorial content on your website
- A specific feed for a particular category or section of your site
- A targeted feed based on tags or other criteria
By adjusting the query parameters, you can customize the feed to match the content structure of your website.
Important: For most use cases, you should include status=active&published_at=active
in your query parameters to filter out content that is not meant to appear publicly.
Required Headers
- Project: Your project identifier (string)
Required Query Parameters
- title: The title for the RSS feed (string)
- link: The link to the section on your website (string)
- description: A brief description of the RSS feed (string)
Example:
https://content.api.sandbox.sportal365.com/editorial-content/rss?title=Sportal365%20Sports%20News&link=https://demo.sportal365.com/football/&description=Latest%20sports%20news%20and%20updates&status=active&published_at=active
Optional Query Parameters
Content Filtering
-
entity_type: Filter by content types (array of strings)
- Possible values: ARTICLE, VIDEO, GALLERY, LIVEBLOG
- Default: Returns all types
- Example:
entity_type=ARTICLE,VIDEO
-
category_ids: Filter by category IDs (string, comma-separated)
- Example:
category_ids=123,456,789
- Example:
-
tag_type: Filter by tag type (string)
- Must be used in conjunction with
tag_ids
- Example:
tag_type=EDITORIAL_TAG
- Must be used in conjunction with
-
tag_ids: Filter by tag IDs (string, comma-separated)
- Must be used in conjunction with
tag_type
- Example:
tag_ids=101,102,103
- Must be used in conjunction with
-
content: Control whether full article content is included in the RSS feed (string)
- Possible values:
body
- Default: Not included (only title, description, and metadata)
- Example:
content=body
- New Feature: When set to
body
, the RSS feed will include the full HTML content of articles in<content:encoded>
tags
- Possible values:
Other Filters
- limit: Number of items to return (string, default: "10")
- page: Page number for pagination (string, default: "1")
- sort_order: Sort order (string, default: "DESC")
- team_ids: Filter by team IDs (string, comma-separated)
- coach_ids: Filter by coach IDs (string, comma-separated)
- player_ids: Filter by player IDs (string, comma-separated)
- competition_ids: Filter by competition IDs (string, comma-separated)
- sport_event_ids: Filter by sport event IDs (string, comma-separated)
- author_ids: Filter by author IDs (string, comma-separated)
- from: Retrieve content with start_time after this date (string)
- to: Retrieve content with start_time before this date (string)
- updated_after: Retrieve content updated after this time (string)
- language: Filter by language (string)
- status: Filter by status (string, comma-separated, e.g., "active,inactive")
- published_at: Filter by publish date (string, currently only supports 'active')
- type: Filter by content type (string, comma-separated, e.g., "SPORT_EVENT,news,Tennis")
Examples
Basic Feeds
- General feed for all active and published editorial content:
https://content.api.sandbox.sportal365.com/editorial-content/rss?title=Sportal365%20All%20News&link=https://demo.sportal365.com/&description=All%20the%20latest%20news%20and%20updates&status=active&published_at=active
- Filtering by category IDs (for a category page feed):
https://content.api.sandbox.sportal365.com/editorial-content/rss?title=Sportal365%20Football&link=https://demo.sportal365.com/football/&description=Football%20news&category_ids=123,456&status=active&published_at=active
- Filtering by tag type and tag IDs (for a tag page feed):
https://content.api.sandbox.sportal365.com/editorial-content/rss?title=Sportal365%20Tagged%20Content&link=https://demo.sportal365.com/tagged/&description=Tagged%20content&tag_type=EDITORIAL_TAG&tag_ids=101,102,103&status=active&published_at=active
New: Full Content Feed
- RSS feed with full article content included:
https://content.api.sandbox.sportal365.com/editorial-content/rss?title=Sportal365%20Full%20Content&link=https://demo.sportal365.com/&description=Full%20articles%20with%20content&status=active&published_at=active&content=body
Response
The API returns an RSS 2.0 feed with the following structure:
Basic Response (without content=body)
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>Your specified title</title>
<link>Your specified link</link>
<description>Your specified description</description>
<lastBuildDate>Thu, 01 Aug 2024 06:48:42 +0000</lastBuildDate>
<language>en-US</language>
<item>
<title>Article Title</title>
<description><![CDATA[<img src="IMAGE_URL" alt="IMAGE_DESCRIPTION"/> Article subtitle or excerpt]]></description>
<link>https://your-site.com/article-url</link>
<guid>unique-content-id</guid>
<pubDate>Wed, 21 Aug 2024 09:56:33 GMT</pubDate>
<author>Author Name</author>
</item>
<!-- More items... -->
</channel>
</rss>
Enhanced Response (with content=body)
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel>
<title>Your specified title</title>
<link>Your specified link</link>
<description>Your specified description</description>
<lastBuildDate>Thu, 01 Aug 2024 06:48:42 +0000</lastBuildDate>
<language>en-US</language>
<item>
<title>Article Title</title>
<description><![CDATA[<img src="IMAGE_URL" alt="IMAGE_DESCRIPTION"/> Article subtitle or excerpt]]></description>
<link>https://your-site.com/article-url</link>
<guid>unique-content-id</guid>
<pubDate>Wed, 21 Aug 2024 09:56:33 GMT</pubDate>
<author>Author Name</author>
<content:encoded><![CDATA[
<p>This is the full HTML content of the article, including images, links, etc.</p>
<img src="https://image.api.integration.sportal365.com/process/smp-image-api-shared-region-integration/sportal.bg/02092024/86b0851a-fb23-4d7f-8b4b-fff125b6048a.png?operations=fit(1920:)" alt="Article Image"/>
<div>Embedded content HTML</div>
]]></content:encoded>
</item>
<!-- More items... -->
</channel>
</rss>
Content Body Processing
When using the content=body
parameter, the system processes different body types as follows:
Supported Body Types
-
editor_block:
- The HTML content of the editor block is included directly in the
<content:encoded>
section
- The HTML content of the editor block is included directly in the
-
embed:
- The embed HTML is included in the
<content:encoded>
section - Preserves the original embed structure and functionality
- The embed HTML is included in the
-
image:
- Creates an
<img>
tag using the 'gallery' URL from the image data - Format:
<img src="[GALLERY_URL]" alt="[ALT_TEXT]"/>
- Example:
<img src="https://image.api.integration.sportal365.com/process/smp-image-api-shared-region-integration/sportal.bg/02092024/86b0851a-fb23-4d7f-8b4b-fff125b6048a.png?operations=fit(1920:)" alt="Article Image"/>
- Creates an
Content Structure
All content is wrapped in CDATA sections within the <content:encoded>
tags to ensure proper XML parsing and preserve HTML formatting.
Note: The feed is updated every 5 minutes.
Error Responses
- 400: Invalid request parameters (e.g., limit out of range)
Updated 15 days ago