# Criczop Cricket Feed API (RSS)

### Making the request

#### API endpoint

<mark style="color:green;">`GET`</mark> `https://api.criczop.com/v1/cricket-feed/rss`

#### Headers

<table><thead><tr><th width="189.8828125">Name</th><th>Description</th></tr></thead><tbody><tr><td>Authorization: Bearer<mark style="color:red;">*</mark></td><td>You must ask your Gamezop Account Manager to get your Bearer token created for you. You can then find the Bearer token for this API under <em>Settings &#x26; Admin > API Tokens</em> within the Gamezop Business Dashboard. </td></tr></tbody></table>

***

### Understanding the response

#### HTTP response codes

The API provides a RSS version 2.0 response, with a list of items that you can use to create a cricket feed in your app / website.

{% tabs %}
{% tab title="200: OK" %}
**Expected response body:**

```rss
<rss version="2.0"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title><![CDATA[Criczop Cricket Feed]]></title>
        <link>https://www.criczop.com/</link>
        <description><![CDATA[Stay ahead of the game with breaking cricket news, live match updates, player insights, and thrilling stories curated by Criczop.]]></description>
        <atom:link href="https://api.criczop.com/v1/cricket-feed/rss" rel="self" type="application/rss+xml" />
        <image>
            <url>https://static.criczop.com/rss-feed-logo.png</url>
            <title><![CDATA[Criczop Cricket Feed]]></title>
            <link>https://www.criczop.com/</link>
        </image>
        <item>
            <title><![CDATA[England vs India T20I: Smriti Mandhana Breaks Into Top 3 of ICC T20I Rankings After Historic Ton]]></title>
            <link>https://www.criczop.com/cricket-news/england-vs-india-t20i-smriti-mandhana-breaks-into-top-3-of-icc-t20i-rankings-after-historic-ton</link>
            <guid isPermaLink="false">6863ef58af718ddc1b4895a2</guid>
            <description><![CDATA[ICC T20I rankings see Smriti Mandhana climb to 3rd spot after her maiden T20I century, becoming the first Indian to score tons in all three formats.]]></description>
            <pubDate>Tue, 01 Jul 2025 03:15:01 +0530</pubDate>
            <media:content url="https://static.platform.gamezop.com/cms/media/harry-brook-ind-vs-eng-1st-test.webp" type="image/webp" width="1200" height="800"></media:content>
        </item>
    </channel>
</rss>
```

{% endtab %}

{% tab title="401: Unauthorized" %}
Here are the error messages you could receive:

* [*Invalid Bearer Token*](#user-content-fn-1)[^1]*.*
  {% endtab %}

{% tab title="500: Internal Server Error" %}
Here are the error messages you could receive:

* [*Internal Server Error.*](#user-content-fn-2)[^2]
  {% endtab %}
  {% endtabs %}

#### Response body content

The RSS/XML response above conforms to the standard structure defined in the RSS 2.0 specification. The table below adds more context to the response values, which may be useful if you're new to RSS feeds

<table><thead><tr><th width="189.96484375">Key</th><th>Description</th><th>Sample</th></tr></thead><tbody><tr><td>rss</td><td>Root element of the RSS feed. Declares namespaces used in the feed, including Media RSS and Atom.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom">
</code></pre></td></tr><tr><td>channel.title</td><td>The title of the entire RSS feed, displayed by feed readers / apps / websites as the feed’s name.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;title>&#x3C;![CDATA[Criczop Cricket Feed]]>&#x3C;/title>
</code></pre></td></tr><tr><td>channel.link</td><td>URL of the Criczop website associated with the feed. Often shown as a “visit site” link in feed readers.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;link>https://www.criczop.com/&#x3C;/link>
</code></pre></td></tr><tr><td>channel.description</td><td>Short description explaining the purpose and contents of the feed. Helps users understand what kind of content to expect.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;description>&#x3C;![CDATA[Stay ahead of the game with breaking cricket news, live match updates, player insights, and thrilling stories curated by Criczop.]]>&#x3C;/description>
</code></pre></td></tr><tr><td>channel.atom:link</td><td>A self-referencing URL indicating the location of the feed itself. Used for feed discovery and updates.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;atom:link href="https://api.criczop.com/v1/cricket-feed/rss" rel="self" type="application/rss+xml" />
</code></pre></td></tr><tr><td>channel.image</td><td>Container for the feed's logo. You can display this as the feed’s icon.</td><td><em>(see nested fields below)</em></td></tr><tr><td>channel.image.url</td><td>URL pointing to the Criczop feed’s logo image.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;url>https://static.criczop.com/rss-feed-logo.png&#x3C;/url>
</code></pre></td></tr><tr><td>channel.image.title</td><td>Textual title describing the image</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;title>&#x3C;![CDATA[Criczop Cricket Feed]]>&#x3C;/title>
</code></pre></td></tr><tr><td>channel.image.link</td><td>A <a data-footnote-ref href="#user-content-fn-3">URL to send your users to</a> when the feed logo is clicked.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;link>https://www.criczop.com/&#x3C;/link>
</code></pre></td></tr><tr><td>item</td><td>Represents a single cricket news article or piece of content. A feed contains multiple such items.</td><td><em>(see nested fields below)</em></td></tr><tr><td>item.title</td><td>The headline of the article / content. Ideally, display it as a clickable link.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;title>&#x3C;![CDATA[England vs India T20I: Smriti Mandhana Breaks Into Top 3 of ICC T20I Rankings After Historic Ton]]>&#x3C;/title>
</code></pre></td></tr><tr><td>item.link</td><td><a data-footnote-ref href="#user-content-fn-3">URL of the full article</a> or content on Criczop. Send your users to this URL when they want to read the full content.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;link>https://www.criczop.com/cricket-news/england-vs-india-t20i-smriti-mandhana-breaks-into-top-3-of-icc-t20i-rankings-after-historic-ton&#x3C;/link>
</code></pre></td></tr><tr><td>item.guid</td><td>Globally unique identifier for the news item.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;guid isPermaLink="false">6863ef58af718ddc1b4895a2&#x3C;/guid>
</code></pre></td></tr><tr><td>item.description</td><td>Short summary of the article’s content. Often displayed as preview text below the title in feed readers. Always wrapped in <a data-footnote-ref href="#user-content-fn-4">CDATA</a>.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;description>&#x3C;![CDATA[ICC T20I rankings see Smriti Mandhana climb to 3rd spot after her maiden T20I century, becoming the first Indian to score tons in all three formats.]]>&#x3C;/description>
</code></pre></td></tr><tr><td>item.pubDate</td><td>Publication date and time of the item. Follows the <a href="https://datatracker.ietf.org/doc/html/rfc822">RFC 822</a> format.</td><td><pre class="language-rss"><code class="lang-rss">&#x3C;pubDate>Tue, 01 Jul 2025 03:15:01 +0530&#x3C;/pubDate>
</code></pre></td></tr><tr><td>item.media:content</td><td><p>Provides the URL to an image associated with the item.</p><ul><li><code>item.media:content.@url</code> references the direct URL of the image</li><li><code>item.media:content.@type</code> is the MIME type of the image (such as <code>image/webp</code>)</li><li><code>item.media:content.@width</code> is the width of the image in pixels</li><li><code>item.media:content.@height</code> is the height of the image in pixels</li></ul></td><td><pre class="language-rss"><code class="lang-rss">&#x3C;media:content url="https://static.platform.gamezop.com/cms/media/harry-brook-ind-vs-eng-1st-test.webp" type="image/webp" width="1200" height="800">&#x3C;/media:content>
</code></pre></td></tr></tbody></table>

***

### Other notes

* Criczop only offers content in English
* There is no pagination on the API; it will always return the 100 latest items

[^1]: Occurs if the Bearer Token sent in the API request is invalid, or if you don't send a Bearer Token.

[^2]: Occurs in case of API outage, or other unforeseen errors.

[^3]: This value will always use your [Criczop Unique Link](https://docs.platform.gamezop.com/publishers/criczop/integrate-unique-link) so that you benefit from our revenue-sharing program.

[^4]: CDATA stands for “Character Data.” It’s used in XML to tell the parser “don’t treat the contents as code or tags—just read it as text.”
