{"id":15658670,"url":"https://github.com/ultirequiem/joke-api","last_synced_at":"2025-04-26T18:49:45.221Z","repository":{"id":37788345,"uuid":"419551421","full_name":"UltiRequiem/joke-api","owner":"UltiRequiem","description":"⚡ Blazing Fast Jokes API!","archived":false,"fork":false,"pushed_at":"2024-10-08T18:41:09.000Z","size":158,"stargazers_count":24,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-25T17:15:02.702Z","etag":null,"topics":["api","deno","javascript","jokes","jokes-api","jokes-library","typescript"],"latest_commit_sha":null,"homepage":"https://joke.deno.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UltiRequiem.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"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}},"created_at":"2021-10-21T02:10:07.000Z","updated_at":"2024-10-08T18:41:13.000Z","dependencies_parsed_at":"2023-12-22T02:42:52.576Z","dependency_job_id":"99a21e8b-d67c-49c7-8eac-5861668e62a3","html_url":"https://github.com/UltiRequiem/joke-api","commit_stats":{"total_commits":111,"total_committers":2,"mean_commits":55.5,"dds":0.4414414414414415,"last_synced_commit":"2eb483a85ac61cc61ffbf928e404909fb78c753d"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltiRequiem%2Fjoke-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltiRequiem%2Fjoke-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltiRequiem%2Fjoke-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltiRequiem%2Fjoke-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UltiRequiem","download_url":"https://codeload.github.com/UltiRequiem/joke-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250860509,"owners_count":21498944,"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":["api","deno","javascript","jokes","jokes-api","jokes-library","typescript"],"created_at":"2024-10-03T13:13:25.227Z","updated_at":"2025-04-25T17:15:09.653Z","avatar_url":"https://github.com/UltiRequiem.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Joke API\n\n![CI](https://github.com/UltiRequiem/joke/workflows/CI/badge.svg)\n[![Code Coverage](https://codecov.io/gh/ultirequiem/joke-api/branch/main/graph/badge.svg)](https://codecov.io/gh/ultirequiem/joke-api)\n\nA blazing fast jokes REST API made with [Oak](https://github.com/oakserver/oak)\non [Deno Deploy](https://deno.com/deploy/docs) 🦕 🚀\n\n## API\n\n### `GET /`\n\n\u003e https://joke.deno.dev\n\nGet a random joke ✨\n\n```json\n{\n  \"id\": 229,\n  \"type\": \"general\",\n  \"setup\": \"What do you call an alligator in a vest?\",\n  \"punchline\": \"An in-vest-igator!\"\n}\n```\n\n### `GET /:id`\n\n\u003e https://joke.deno.dev/350\n\nDid you like a joke? Get the same one whenever you want 🦀\n\n```json\n{\n  \"id\": 350,\n  \"type\": \"general\",\n  \"setup\": \"Why did the tree go to the dentist?\",\n  \"punchline\": \"It needed a root canal.\"\n}\n```\n\n### `GET /type/:type`\n\n\u003e https://joke.deno.dev/type/programming\n\nLooking for a specific type of jokes? You're lucky 🐌\n\n```json\n[\n  {\n    \"id\": 15,\n    \"type\": \"programming\",\n    \"setup\": \"What's the best thing about a Boolean?\",\n    \"punchline\": \"Even if you're wrong, you're only off by a bit.\"\n  },\n  {\n    \"id\": 16,\n    \"type\": \"programming\",\n    \"setup\": \"What's the object-oriented way to become wealthy?\",\n    \"punchline\": \"Inheritance\"\n  },\n  ...\n]\n```\n\nAll available types are listed on `GET /type` 🕵️‍♂️\n\n### `GET /type/:type/:quantity`\n\nLooking for a specific amount of a specific type of jokes? We got you covered 🐿\n\n\u003e https://joke.deno.dev/type/general/1\n\n```json\n[\n  {\n    \"id\": 90,\n    \"type\": \"general\",\n    \"setup\": \"Did you hear about the guy who invented Lifesavers?\",\n    \"punchline\": \"They say he made a mint.\"\n  }\n]\n```\n\n### `GET /all`\n\n\u003e https://joke.deno.dev/all\n\nDo you really need so many jokes? Leave everything to us ⚡\n\n```json\n[\n  {\n    \"id\": 1,\n    \"type\": \"general\",\n    \"setup\": \"What did the fish say when it hit the wall?\",\n    \"punchline\": \"Dam.\"\n  },\n  {\n    \"id\": 2,\n    \"type\": \"general\",\n    \"setup\": \"How do you make a tissue dance?\",\n    \"punchline\": \"You put a little boogie on it.\"\n  },\n  {\n    \"id\": 3,\n    \"type\": \"general\",\n    \"setup\": \"What's Forrest Gump's password?\",\n    \"punchline\": \"1Forrest1\"\n  }\n  ...\n]\n```\n\n## Analytics\n\n![Requests](https://user-images.githubusercontent.com/71897736/211101270-2a95504a-aa91-4553-9219-9da8fc2e4104.png)\n\n\u003e January 2023, hitting around 400k requests per month.\n\n## Contributing\n\nSubmit a Pull Request, with your joke added to the `server/data.ts` file. Make\nsure your joke is in this format:\n\n```typescript\n{\n  \"id\": last joke id + 1,\n  \"type\": \"programming\",\n  \"setup\": \"What's the best thing about a Boolean?\",\n  \"punchline\": \"Even if you're wrong, you're only off by a bit.\"\n}\n```\n\nIf you have an idea for a new endpoint, submit an\n[issue](https://github.com/UltiRequiem/joke-api/issues/new) or a\n[pull request](https://github.com/UltiRequiem/joke-api/fork).\n\n## How the Jokes were collected\n\nThe first 300 Jokes comes from\n[15Dkatz/official_joke_api](https://github.com/15Dkatz/official_joke_api) (At\nthe moment of writting this, this project has 428 jokes.), the problem with that\nproject is that its\n[server is down](https://github.com/15Dkatz/official_joke_api/issues/93), and it\n[has not been updated for 2 years](https://github.com/15Dkatz/official_joke_api/commits/master).\n\nThe other jokes were progressively added by\n[contributors](https://github.com/UltiRequiem/joke/graphs/contributors).\n\n## Licence\n\nLicensed under the MIT License 📄\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultirequiem%2Fjoke-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultirequiem%2Fjoke-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultirequiem%2Fjoke-api/lists"}