{"id":31925370,"url":"https://github.com/mrjxtr/rpug","last_synced_at":"2026-04-19T04:04:15.512Z","repository":{"id":318156203,"uuid":"1067286618","full_name":"mrjxtr/rpug","owner":"mrjxtr","description":"RANDOM PINOY USER GENERATOR | Generate realistic Filipino user data faster than you can say \"Mabuhay!\". Perfect for testing, demos, or when you need fake Pinoy users that actually look and feel legit.","archived":false,"fork":false,"pushed_at":"2026-03-20T11:49:56.000Z","size":49,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-21T02:24:51.250Z","etag":null,"topics":["free-api","golang","open-source-api","pinoy-api","random-user-generator-api"],"latest_commit_sha":null,"homepage":"https://randompinoy.xyz/api/v1/pinoys","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrjxtr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-30T16:32:29.000Z","updated_at":"2026-03-20T11:45:12.000Z","dependencies_parsed_at":"2025-10-05T14:43:52.023Z","dependency_job_id":null,"html_url":"https://github.com/mrjxtr/rpug","commit_stats":null,"previous_names":["mrjxtr/rpug"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mrjxtr/rpug","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrjxtr%2Frpug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrjxtr%2Frpug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrjxtr%2Frpug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrjxtr%2Frpug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrjxtr","download_url":"https://codeload.github.com/mrjxtr/rpug/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrjxtr%2Frpug/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["free-api","golang","open-source-api","pinoy-api","random-user-generator-api"],"created_at":"2025-10-14T00:53:45.790Z","updated_at":"2026-04-01T19:49:50.705Z","avatar_url":"https://github.com/mrjxtr.png","language":"Go","readme":"# RANDOM PINOY USER GENERATOR (RPUG)\n\n\u003e _\"Pinoy test data ba kailangan mo?! Heto na!\"_ 🇵🇭\n\u003e ℹ️ The API is live and ready to use at **[https://randompinoy.xyz/api/v1/pinoys](https://randompinoy.xyz/api/v1/pinoys)** — no installation required! 🚀\n\nGenerate realistic Filipino user data faster than you can say \"Mabuhay!\" Perfect for testing, demos, or when you need fake Pinoy users that actually look and feel legit.\n\n**100% Free. 100% Open Source. 100% Pinoy.** 🆓\n\n## 🎯 What's This All About?\n\nRPUG is a lightweight REST API that generates random Filipino user profiles. No more boring \"John Doe\" or \"Jane Smith\" in your test data — get authentic Pinoy names, real Philippine locations, and data that actually makes sense for Filipino users.\n\nBuilt with Go, powered by Filipino spirit. ✨\n\n## ✨ Features\n\n- **Free \u0026 Open Source** - Use it anywhere, anytime. No API keys, no BS\n- **Authentic Filipino Names** - From Juan dela Cruz to Princess Mae Villanueva\n- **Real Philippine Locations** - Cities and regions from Luzon to Mindanao\n- **Deterministic Seeds** - Same seed = same data (perfect for reproducible tests)\n- **Flexible Results** - Generate 1 to 1,000 users in a single request\n- **Fast \u0026 Lightweight** - Because ain't nobody got time for slow APIs\n- **JSON All The Way** - Easy to parse, easy to use\n\n## 🌐 Live API Usage\n\n🔗 **[https://randompinoy.xyz/api/v1/pinoys](https://randompinoy.xyz/v1/pinoys)**\n\n### Try It Now\n\n```bash\n# Generate 1 user\ncurl https://randompinoy.xyz/api/v1/pinoys\n\n# Generate 10 users\ncurl https://randompinoy.xyz/api/v1/pinoys?results=10\n\n# Use a seed for reproducible data\ncurl https://randompinoy.xyz/api/v1/pinoys?seed=2d0cd4170d54fbacdcc1e679ecf394cd\n```\n\n### Want to Run It Locally?\n\nCheck out the [Quick Start Guide](CONTRIBUTING.md#🛠️-development-setup) in our contributing docs if you want to run your own instance or contribute to the project.\n\n## 📡 API Endpoints\n\n### Health Check\n\n```bash\nGET /ping\n```\n\nReturns `200 OK` if the server is alive and kicking.\n\n### Generate Random Users\n\n```bash\nGET /api/v1/pinoys\n```\n\nGenerate random Filipino user profiles. That's it. That's the API.\n\n## 🎮 Usage Examples\n\n### Basic Request (1 user)\n\n```bash\ncurl https://randompinoy.xyz/api/v1/pinoys\n```\n\n### Generate Multiple Users\n\n```bash\n# Get 5 users\ncurl https://randompinoy.xyz/api/v1/pinoys?results=5\n\n# Go crazy with 1000 users\ncurl https://randompinoy.xyz/api/v1/pinoys?results=1000\n```\n\n### Use a Seed for Reproducible Data\n\n```bash\n# Same seed = same data every time\ncurl https://randompinoy.xyz/api/v1/pinoys?seed=2d0cd4170d54fbacdcc1e679ecf394cd\n```\n\n\u003e **Note:** If you're running locally, replace `https://randompinoy.xyz` with `http://localhost:3000`\n\n## 📦 Response Format\n\n```json\n{\n  \"results\": [\n    {\n      \"name\": {\n        \"title\": \"Mr\",\n        \"first\": \"Carlo\",\n        \"last\": \"Santos\"\n      },\n      \"dob\": {\n        \"date\": \"1989-05-30T23:07:31.851Z\",\n        \"age\": 36\n      },\n      \"location\": {\n        \"city\": \"Pagadian\",\n        \"region\": \"Zamboanga Del Sur\",\n        \"country\": \"Philippines\",\n        \"zipcode\": \"7016\"\n      },\n      \"gender\": \"male\",\n      \"phone\": \"09091234567\",\n      \"email\": \"carlo.santos@gmail.com\",\n      \"registered\": {\n        \"date\": \"2025-04-03T02:01:00.708Z\",\n        \"age\": 3\n      }\n    }\n  ],\n  \"info\": {\n    \"seed\": \"2d0cd4170d54fbacdcc1e679ecf394cd\",\n    \"results\": 1,\n    \"version\": \"v0.1.x-alpha\"\n  }\n}\n```\n\n## 🔧 Query Parameters\n\n| Parameter | Type   | Default | Max  | Description                    |\n| --------- | ------ | ------- | ---- | ------------------------------ |\n| `results` | int    | 1       | 1000 | Number of users to generate    |\n| `seed`    | string | random  | -    | Seed for deterministic results |\n\n**Pro tip:** Results are clamped between 1-1000. Use the `results` parameter to get multiple users in one request instead of making rapid-fire requests.\n\n## 🚦 Rate Limiting\n\nTo keep the API fast and fair for everyone, we enforce these limits:\n\n- **60 requests per minute** per IP address (~1 request per second average)\n\nIf you hit the limit, you'll get a `429 Too Many Requests` response. Just wait a moment and try again, or better yet — use the `results` parameter to get multiple users in a single request!\n\n## 📝 Notes\n\n- Street address generation is planned for future releases\n- Pagination support is planned\n\nThis is a work in progress, pero functional na siya! Ship it! 🚢\n\n## 📄 License\n\nThis project is **free and open source** under the GNU General Public License v3.0 (GPL-3.0). Use it, fork it, share it — walang bayad! Check the `LICENSE` file for the full details.\n\nJust give credit where it's due, okay? 😉\n\n## 🤝 Contributing\n\nWant to add more Filipino names? Found a bug? Got ideas for features?\n\nCheck out [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute. PRs and issues are welcome! 🙏\n\n---\n\n**Made with ❤️ and kape ☕ by [@mrjxtr](https://mrjxtr.dev)**\n**Mabuhay Pinoy developers! 🇵🇭**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrjxtr%2Frpug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrjxtr%2Frpug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrjxtr%2Frpug/lists"}