{"id":20034239,"url":"https://github.com/zingzy/panda-api","last_synced_at":"2025-09-20T07:32:01.673Z","repository":{"id":217912509,"uuid":"745112509","full_name":"Zingzy/panda-api","owner":"Zingzy","description":"A cute API for pandas written in Python🐼","archived":false,"fork":false,"pushed_at":"2024-10-04T21:39:22.000Z","size":87178,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-13T09:51:28.894Z","etag":null,"topics":["animals","api","facts","facts-api","fastapi","flask","gifs","images","panda","panda-api","python"],"latest_commit_sha":null,"homepage":"https://panda.spoo.me","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zingzy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-18T17:04:37.000Z","updated_at":"2024-10-04T21:39:25.000Z","dependencies_parsed_at":"2024-01-18T19:22:19.874Z","dependency_job_id":"7aca22c7-e6b8-4fc3-ab58-2bdf8873dfc2","html_url":"https://github.com/Zingzy/panda-api","commit_stats":null,"previous_names":["zingzy/panda-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zingzy%2Fpanda-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zingzy%2Fpanda-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zingzy%2Fpanda-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zingzy%2Fpanda-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zingzy","download_url":"https://codeload.github.com/Zingzy/panda-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233642570,"owners_count":18707333,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animals","api","facts","facts-api","fastapi","flask","gifs","images","panda","panda-api","python"],"created_at":"2024-11-13T09:49:01.874Z","updated_at":"2025-09-20T07:31:54.185Z","avatar_url":"https://github.com/Zingzy.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003ctable align=\"right\"\u003e\n    \u003ctr\u003e\n        \u003ctd align=\"center\"\u003e\u003cimg src=\"https://panda.spoo.me/raw_gif\" style=\"width: 300px;\" alt=\"Please Reload\"\u003e\u003c/td\u003e\n    \u003ctr\u003e\n    \u003ctr\u003e\n        \u003ctd align=\"center\"\u003e⬆️ random gif using our api 😉\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ch1\u003e🐼 Panda API 🌟\u003c/h1\u003e\n\nWelcome to the Panda API, where cuteness meets information about everyone's favorite black and white bears! This API serves random panda facts and adorable pictures to brighten up your day.\n\n\u003ch2\u003e📖 Documentation\u003c/h2\u003e\n\n### Base URL\n- **URL:** `https://pandaa.vercel.app`\n- **Description:** The base URL for all endpoints.\n- **Note:** All endpoints are relative to the base URL.\n\n\u003ch2\u003e🚀 Endpoints\u003c/h2\u003e\n\n### Random Panda Fact\n- **Endpoint:** `/fact`\n- **Method:** `GET`\n- **Description:** Get a random panda fact to amaze your friends with panda knowledge! 🧠🐼\n\n### Random Panda Picture URL\n- **Endpoint:** `/pic`\n- **Method:** `GET`\n- **Description:** Obtain the URL of a random panda picture for an instant dose of cuteness. 📸🐾\n\n### Random Panda GIF URL\n- **Endpoint:** `/gif`\n- **Method:** `GET`\n- **Description:** Get the URL of a random panda GIF to share the panda love! 🎁🐼\n\n\u003ctable align=\"right\"\u003e\n    \u003ctr\u003e\n        \u003ctd align=\"center\"\u003e\u003cimg src=\"https://panda.spoo.me/raw_pic\" style=\"height: 180px;\"\u003e\u003c/td\u003e\n    \u003ctr\u003e\n    \u003ctr\u003e\n        \u003ctd align=\"center\"\u003e⬆️ random pic using our api 😉\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n### Random Panda Picture (Raw)\n- **Endpoint:** `/raw_pic`\n- **Method:** `GET`\n- **Description:** Experience the panda cuteness with a streaming response of a random panda picture. 🖼️🐼\n\n### Random Panda GIF (Raw)\n- **Endpoint:** `/raw_gif`\n- **Method:** `GET`\n- **Description:** Experience the panda cuteness with a streaming response of a random panda GIF. 🎥🐼\n\n### Random Fact, Picture URL, and GIF URL (All in One)\n- **Endpoint:** `/all`\n- **Method:** `GET`\n- **Description:** Get a random panda fact, picture URL, and GIF URL in one request. 🎁🐼\n\n### All Panda Facts\n- **Endpoint:** `/all-facts`\n- **Method:** `GET`\n- **Description:** Explore a collection of all panda facts. Impress your friends with a wealth of panda trivia! 📚🐼\n\n### All Panda Pictures URLs\n- **Endpoint:** `/all-pics`\n- **Method:** `GET`\n- **Description:** Access URLs of all panda pictures available in the API. Share the love for pandas with these adorable images. 🌈🐼\n\n### All Panda GIFs URLs\n- **Endpoint:** `/all-gifs`\n- **Method:** `GET`\n- **Description:** Access URLs of all panda GIFs available in the API. Share the love for pandas with these adorable GIFs. 🌟🐼\n\n### Specific Panda Picture\n- **Endpoint:** `/i/{file_name}`\n- **Method:** `GET`\n- **Description:** Retrieve a specific panda picture by filename. Customize your panda experience! 🖼️🐼\n\n### Specific Panda GIF\n- **Endpoint:** `/g/{file_name}`\n- **Method:** `GET`\n- **Description:** Retrieve a specific panda GIF by filename. Customize your panda experience! 🎥🐼\n\n\n_For a more detailed API visit : https://pandaa.vercel.app/docs_\n\n\u003ch2\u003e🛠️ Installation\u003c/h2\u003e\n\n### Direct Deployment\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/Zingzy/panda-api)\n\u003ca href=\"https://render.com/deploy?repo=https://github.com/Zingzy/panda-api\"\u003e\n\u003cimg src=\"https://render.com/images/deploy-to-render-button.svg\" alt=\"Deploy to Render\" height=\"30px\"/\u003e\n\u003c/a\u003e\n\n### Manual Setup\n1. Clone the repository `git clone https://github.com/Zingzy/panda-api.git`.\n2. Install the required packages using `pip install -r requirements.txt`.\n3. Install [uvicorn](https://www.uvicorn.org/) using `pip install uvicorn`.\n4. Run the server using `uvicorn main:app --reload`.\n\n\u003ch2\u003e🤝 Contributing\u003c/h2\u003e\n\nFeel free to contribute to the Panda API by adding more panda facts, pictures, or improving the code. Create a pull request, and let's make the panda world even more delightful! 🎉🐼\n\n## Submission Guidelines\n\n- Create a new branch for your changes.\n- Make sure your code is formatted using [Black Formatter](https://pypi.org/project/black/)\n- If you are adding a new panda fact, add it to the `facts.txt` file in a new line, ending with a full stop.\n- If you are adding a new panda picture, add it to the `pics` folder.\n- The picture filename should be in the format `{number}.jpg`, where `{number}` is the next number in the sequence.\n- The picture should **not be more than 300 KB** in size.\n- If you are adding a new panda GIF, add it to the `gifs` folder.\n- The GIF filename should be in the format `{number}.gif`, where `{number}` is the next number in the sequence.\n- The GIF should **not be more than 2 MB** in size.\n\n\n**Enjoy the Panda API! 🐼✨**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzingzy%2Fpanda-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzingzy%2Fpanda-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzingzy%2Fpanda-api/lists"}