Gifroz

https://gifroz.vercel.app/

Experience a new random GIF from GIPHY or Tenor with every refresh! Gifroz offers an incredibly simple URL that's a breeze to integrate.

Don't believe it? Refresh this page and see the magic!

---

Features

• 🎨 Generate random GIFs based on search terms.
• 🔍 Supports both GIPHY and Tenor as sources.
• 🖼️ Easy integration with markdown, HTML, or direct URL usage.
• ⚡ Fast and lightweight API.
• 🔧 Fully customizable with query parameters.

---

How to Use

Markdown Integration Example

![Random GIF](https://gifroz.vercel.app/)

HTML Integration Example

<img src="https://gifroz.vercel.app/" alt="Random GIF">

Query Parameters

Parameter	Description	Default Value	Example Usage
q	Search term for the GIF. Avoid special characters like &, =. Use URL encoding for spaces (e.g., q=qa%20meme).	meme	q=cat
source	Source for the GIF. Options: giphy or tenor.	giphy	source=tenor

Warning

Avoid using special characters like &, = directly in the q parameter. These characters can cause issues with the API. Instead, use URL encoding. For example:

• Use %20 for spaces (e.g., q=qa%20meme).
• Replace & with %26 (e.g., q=pm%26qa).

Examples with Query Parameter

Scenario	URL
Search: "fat cat"	https://gifroz.vercel.app/?q=fat%20cat
Search: "dev & meme"	https://gifroz.vercel.app/?q=dev%20%26%20meme
Search: "dev=meme"	https://gifroz.vercel.app/?q=dev%3Dmeme
Search: "dev-meme"	https://gifroz.vercel.app/?q=dev-meme
Search: "dev" from Tenor	https://gifroz.vercel.app/?q=dev&source=tenor

---

Contributing

Contributions are welcome! If you have suggestions or want to improve Gifroz, please feel free to:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature-name).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature/your-feature-name).
6. Open a Pull Request.

Please open an issue first to discuss any significant changes.

---

🔗 Content Attribution

This project utilizes content (GIFs/WebPs) sourced from the following APIs:

• Tenor: Powered By Tenor. Tenor API
• GIPHY: Powered By GIPHY. GIPHY API

Please note that all content is subject to the respective terms of service and licensing of Tenor and GIPHY.

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Made with and Python