RedGIFs API

An asynchronous Python API wrapper and scraper for redgifs.com

+

Disclaimer

Features

Accepted page hosts are redgifs.com and www.redgifs.com; media identity URLs from media.redgifs.com are also supported. No language or proxy variants are accepted. HLS URLs are exposed for inspection; downloads use DownloadConfigRAW because the current shared HLS downloader does not preserve RedGIFs' byte ranges. Private/account actions and gallery enumeration are not implemented.

Live validation remains incomplete: the final run recorded 38 passed, 12 failed, 0 skipped, with all final failures caused by HTTP 429. Earlier runs also reproduced upstream pagination omissions for equal-timestamp uploads. See the validation report for evidence, quality measurements and limitations.

Networking Features

The networking layer is provided by the eaf_base_api package and is fully configurable through RuntimeConfig:

Supported Platforms

This API has been live-tested on:

• Linux with Python 3.15.2

Python 3.12 or newer is required. Other platforms have not been verified.

Installation

Install from the local checkout before publication:

pip install .

For development with the neighboring shared backend checkout:

pip install -e ../eaf_base_api -e .

The distribution is named unofficial-api-for-redgifs; publication is not asserted.

Quickstart

Have a look at the Documentation for more details

import asyncio
from redgifs_api import Client, DownloadConfigRAW

async def main():
    # Initialize a Client and close its network resources when finished
    async with Client() as client:
        # Load API metadata and the HTML display title
        video_object = await client.get_video(
            "https://www.redgifs.com/watch/hotpinkacrobatickitfox",
            load_html=True,
        )

        # Information from Video objects
        print(video_object.title)

        # Download the video
        config = DownloadConfigRAW(quality="best", path="./")
        await video_object.download(config)

if __name__ == "__main__":
    asyncio.run(main())

Support the Project ❤️

I develop all my projects entirely for free because I enjoy it and want to keep them accessible. If you find my work useful, please consider supporting me with a small donation — even 1 € makes a big difference and keeps me motivated!

☕ Ko-fi

https://ko-fi.com/EchterAlsFake

💳 PayPal

https://paypal.me/EchterAlsFake

🪙 Crypto (350+ currencies supported)

Contribution

Do you see any issues or having some feature requests? Simply open an Issue or talk in the discussions.

Pull requests are also welcome.

License

This API is licensed under the AGPLv3. See the LICENSE file for details.