Back
SHARE
Feed Content Search API documentation

Documentation for the Feed Content Search API to Access Content from a Cronycle Feed

Share on linkedin
Share on facebook
Share on twitter

Cronycle Feeds enable teams to aggregate information from millions of sources including Cronycle Topics, social media, websites, podcasts and more. If you have set up Cronycle feeds, the Feed Content Search API offers real-time access to the content streams captured there over the prior six-month period.

Like in your feeds, content is aggregated and filtered according to your preferences. In addition to being topically aggregated and vetted by field experts, information streams are the results of your Cronycle feed configurations supporting custom sources and newsletters. Filters available on feeds apply, including advanced boolean keyword, language, domain, influence and content type filters (i.e. all except for seen/unseen). You can prepare and adjust the feed configuration in the user-friendly Cronycle feed visual interface and collect feed content in your systems via the API.

Note: generally articles are stored for a maximum of 180 days.

There are two APIs – one to query the list of feeds (Feed list) and another for content within a feed (Feed content). Information about authentication closes this documentation.

Feed list API

Route

GET https://entapi.cronycle.com/content/feeds/list

Sample Request

https://entapi.cronycle.com/content/feeds/list

Sample Response

{
    "num_found": 3,
    "content": [
        {
            "id": 90390,
            "name": "Economic development",
            "owner": "Rahul Arora"
        },
        {
            "id": 92153,
            "name": "AI",
            "owner": "Rahul Arora"
        },
        {
            "id": 92152,
            "name": "Global ethics",
            "owner": "Shrey Tanwar"
        },
    ]
}

Feed content API

Route

GET https://entapi.cronycle.com/content/feeds/search

Query Parameters

The parameters you can use to query the Feed Content Search API are:

  • feed_id (number): feed id to query content for.
  • rows (number): to specify the number of items to be returned in the response. (default: 50, max: 500)
  • start (number): to specify the starting row for pagination. (default: 0)
  • days (number): to specify the number of days for which content is to be fetched. (default: 1)
  • query (string): to specify any search keyword/query within feed content.

Sample Request

https://entapi.cronycle.com/content/feeds/search?feed_id=90390&query=liverpool&start=0&rows=10&days=1

Sample Response

{
    "num_found": 96,
    "content": [
        {
            "id": 2331929962,
            "type": "link",
            "title": "FPL team reveals: 4-3-3 with Darwin, Kane and Martial",
            "url": "https://www.fantasyfootballscout.co.uk/2022/07/31/fpl-team-reveals-4-3-3-with-darwin-kane-and-martial/",
            "body": "FPL Team Reveals\n1,171 Comments\nShare\nWith Gameweek 1 of Fantasy Premier League (FPL) days away, we’re welcoming back our stellar team of Pro Pundits, Hall of Famers and guest contributors for the new campaign.\nOur writers will be providing regular articles and team reveals throughout the new season, with only  Premium Members  able to access every single one.\nNext up is three-time top 200 finisher and two-time champion of India, Lateriser, who talks through his latest Gameweek 1 plans...",
            "excerpt": "FPL Team Reveals 1,171 Comments Share With Gameweek 1 of Fantasy Premier League (FPL) days away, we’re welcoming back our stellar team of Pro Pundits, Hall of Famers and guest contributors for the new campaign. Our writers will be providing",
            "published_date": "2022-08-02T09:00:22Z",
            "source": "English premier league",
            "domain": "www.fantasyfootballscout.co.uk",
            "author": null,
            "tags": [
                "sports",
                "football"
            ],
            "image_urls": [
                "https://cdn.fantasyfootballscout.co.uk/wp-content/uploads/2022/07/pro-pundit-my-current-draft-600x315.jpg"
            ],
            "video_urls": []
        }
    ]
}

In the response, the tags correspond to the Cronycle Topics associated with each article (if applicable).

Note: body has been truncated in this sample to keep this Feed Content Search API documentation short.

Authentication

Both APIs support Bearer Token-based authentication. The access token can be sent as a Bearer token in Authorization headers like

Authorization: Bearer <access_token>

Start using our APIs

Our APIs are available to our Enterprise API customers, each requiring a dedicated token. Contact us to discuss how our APIs can power your workflow or content base.

Check alternative APIs: overview, Topic Content Search API, Board Enterprise API.

Discover the power of Cronycle for Teams

What to read next