README
Article Text API
Social Animal provides a powerful content API that lets you analyze content in very flexible ways. While the Content API provides you useful data on content, the Article Text API provides you a way to get text that makes up an article. While using this API, you get the article text extracted from the HTML of the originally hosted article. There is no need for you to resort to other methods to extract text from the HTML.
Things you need to know before you start
- The rate limit is 1 req/sec by default.
Article Text API endpoint
GET /api/v1/article/content
In Social Animal APIs, any article is uniquely identified by its “content hash”. The Social Animal Article Text API is an extremely simple API to use. It fetches the text content for the article identified by the content hash you provide as an argument to the API call. The content hash of all articles in the system is available from other Social Animal APIs like the Social Animal Content API or the Social Animal Share Count API.
Please refer to the query parameters below for further details.
Request Headers
- X-RapidAPI-Host (String, required)
- X-RapidAPI-Key (String, required)
Request Object Parameters
There is sufficient indication of whether parameters are mandatory, mutually exclusive, etc. Should you have any trouble using the Social Animal Article Text API, please see section below on support.
The Query
- hash (Object, required) – Content hash of the article
Simple Request Example
'/api/v1/article/content?hash=718538c98ef6e6b376d08f16fee1c6fac48d45f97ecd007d1d9645dec30be91a2f359a141db0150d324a5b04740d07f8b6e50f954369096c1749938d32538e28
`
Successful Response Sample
{ "article": "The Journey of Egeria, Abbess and pilgrim to Jerusalem, late fourth century, Pilgrimage 37: SC 296, pp. 284–90, Egeria: Diary of a Pilgrimage, tr. Gringras, pp. 110–3.\n\nThe Journey of Egeria, Abbess and pilgrim to Jerusalem, late fourth century, do so, do not keep watch there. But those of the clergy who are either strong enough or young enough, keep watch there, and hymns and antiphons are sung there all through the night until morning. The greater part of the people keep watch, some from evening on, others from midnight, each one doing what he can." }
