📼 Findstream

Findstream API

The following describes the API provided by Findstream, which allows to get the same results available on the webpage of this service.

If possible, please enable gzip compression in your HTTP client to reduce the amount of data transferred.

Fair use

This API is provided free of service. Please just be nice and don't over-use it. If you plan to send a high volume of requests, please open an issue at the GitHub project first.

In case a large amount of unusual traffic is seen on this endpoint, eventually causing the service to hit the rate limit of Twitch's API too often, the API may be changed to be invite-only without further notice.

Request

The request must be sent to /api/search with the POST method and a JSON body. Fields category and query are mandatory, the language field can be used to further restrict results to a specific language.

Example

{
  "category": "SoftwareAndGameDevelopment",
  "query": "rust",
  "language": "en"
}

Response

A successful response is a JSON array with each element having the following fields. Except for stream_time, all fields are always present.

Example

[
  {
    "title": "Learning Rust | Day 11 | nvim !first !firstleaders",
    "username": "SouLxBurN",
    "language": "English",
    "stream_time": 10455,
    "viewer_count": 37
  }
]