Back
SHARE
API documentation

Content search API documentation

Share on linkedin
Share on facebook
Share on twitter

Cronycle provides several APIs to enterprise API customers to call directly. The Content Search API searches content, i.e. links, conversations, etc. for a list of Cronycle Topics. It returns relevant articles for a given topic in near real-time. This Content Search API documentation will help you explore, test and integrate Cronycle Topic content into your apps and workflows.

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

Route

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

Query Parameters

  • topics (string): comma separated list of topics to search content for. (max: 5, required)
  • 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)
  • include_keywords (string): comma separated list of keywords that should be included in the content.
  • include_keywords_operator (string): to specify operator (“and” | ”or”) for include keywords. (default: “or”)
  • exclude_keywords (string): comma separated list of keywords that should NOT be included in the content.
  • exclude_keywords_operator (string): to specify operator (“and” | ”or”) for exclude keywords. (default: “or”)
  • access_token: to specify access token for authentication.

Sample Request 

https://entapi.cronycle.com/content/search?topics=bitcoin&includeKeywords=coindesk,coinbase&excludeKeywords=journalistic,media&access_token=XXX&includeKeywordsOperator=and&rows=10

Sample Response

{
  "num_found": 152,
  "content": [
    {
      "id": 277998657,
      "type": "link",
      "title": "News: Facebook abandoning Libra/Diem, Soulja Boy vs. Atari, Kurson arrested again, El Salvador",
      "url": "https://davidgerard.co.uk/blockchain/2021/08/22/news-facebook-abandoning-diem-soulja-boy-vs-atari-kurson-arrested-again-el-salvador/",
      "body": "Signed copies of Attack of the 50 Foot Blockchain and Libra Shrugged are still in stock, for £25 the pair plus postage — £6 UK, £10 Europe, £12 rest of world. See the post for details. I still have free stickers!\nSupport my work by signing up for the Patreon — $5 or $20 a month, or what you have. It really does help...",
      "excerpt": "Signed copies of Attack of the 50 Foot Blockchain and Libra Shrugged are still in stock, for £25 the pair plus postage — £6 UK, £10 Europe, £12 rest of world. See the post for details. I still have free",
      "published_date": "2021-08-22T19:59:48Z",
      "domain": "davidgerard.co.uk",
      "author": null,
      "image_urls": [
        "https://davidgerard.co.uk/blockchain/wp-content/uploads/2021/08/crypto-aktion.png"
      ],
      "video_urls": []
    },
    ...
  ]
}

Note: body has been truncated in this sample to keep this Cronycle API documentation short.

Discover the power of Cronycle for Teams

What to read next