{"id":18677486,"url":"https://github.com/dadjokes-io/dad_jokes_api","last_synced_at":"2025-08-17T00:32:05.810Z","repository":{"id":45762561,"uuid":"302950809","full_name":"DadJokes-io/Dad_Jokes_API","owner":"DadJokes-io","description":"Dad Jokes API contains unlimited dad jokes. If you would like an API Key head over to https://rapidapi.com/KegenGuyll/api/dad-jokes/details","archived":false,"fork":false,"pushed_at":"2024-06-13T16:09:40.000Z","size":627,"stargazers_count":42,"open_issues_count":1,"forks_count":59,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-07-31T19:51:33.081Z","etag":null,"topics":["api","dad-jokes","funny","jokes"],"latest_commit_sha":null,"homepage":"https://dadjokes.io","language":"TypeScript","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/DadJokes-io.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":"2020-10-10T17:05:46.000Z","updated_at":"2024-07-14T04:49:18.000Z","dependencies_parsed_at":"2024-01-18T23:05:14.228Z","dependency_job_id":"6e542dc9-5920-4d9b-bad5-7f0033aaac8d","html_url":"https://github.com/DadJokes-io/Dad_Jokes_API","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DadJokes-io/Dad_Jokes_API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadJokes-io%2FDad_Jokes_API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadJokes-io%2FDad_Jokes_API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadJokes-io%2FDad_Jokes_API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadJokes-io%2FDad_Jokes_API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DadJokes-io","download_url":"https://codeload.github.com/DadJokes-io/Dad_Jokes_API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadJokes-io%2FDad_Jokes_API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270791255,"owners_count":24645781,"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","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["api","dad-jokes","funny","jokes"],"created_at":"2024-11-07T09:34:11.592Z","updated_at":"2025-08-17T00:32:05.339Z","avatar_url":"https://github.com/DadJokes-io.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Overview\n\nThis section should contain an overview of the data provided and the API purpose.\n\n#### USING THE API\n\nWe built this API to have an unlimited supply of dad jokes for our [DadJokes](https://github.com/KegenGuyll/Dad_Jokes) application.\nIf you find yourself overwhelmed, we organized this documentation into four major areas.\n\n- [Getting started](#getting-started) introduces you to the operations offered by the API.\n- [API calls](#api-calls) gives you examples of those operations\n- [Field reference](#field-reference) Lists and describes the type of information provided by the API\n\n# Getting Started\n\nThe current version of the API lives at `https://dad-jokes.p.rapidapi.com`\n\n#### Endpoints\n\n| Endpoint                                  |                                What it does                                 |\n| ----------------------------------------- | :-------------------------------------------------------------------------: |\n| `GET` [`/random/joke`](#randomjoke)       | Returns a joke object that contains a `setup`, `punchline`, `type` and `id` |\n| `GET` [`/joke/:id`](#jokeid)              |                  Returns a joke object with a specific id.                  |\n| `GET` [`/joke/type/:type`](#joketypetype) |            Returns a joke object randomly with a specific type.             |\n| `GET` [`/joke/search`](#jokesearch)       |                 Returns a list of jokes matching your term                  |\n\n#### Types\n\n| Type        |\n| ----------- |\n| General     |\n| Knock-Knock |\n| Programming |\n\n# API calls\n\nThis API supports a data response in JSON format.\n\n### /random/joke\n\n```json\n{\n  \"success\": true,\n  \"body\": [\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27ba2\",\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\n### /joke/:id\n\n`/joke/5f80ccd641785ba7c7d27ba2`\n\n```json\n{\n  \"success\": true,\n  \"body\": {\n    \"_id\": \"5f80ccd641785ba7c7d27ba2\",\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### /joke/type/:type\n\n`/joke/type/knock-knock`\n\n```json\n{\n  \"success\": true,\n  \"body\": [\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b55\",\n      \"type\": \"knock-knock\",\n      \"setup\": \"Knock knock. \\n Who's there? \\n A broken pencil. \\n A broken pencil who?\",\n      \"punchline\": \"Never mind. It's pointless.\"\n    },\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b6b\",\n      \"type\": \"knock-knock\",\n      \"setup\": \"Knock knock. \\n Who's there? \\n Opportunity.\",\n      \"punchline\": \"That is impossible. Opportunity doesn’t come knocking twice!\"\n    },\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b56\",\n      \"type\": \"knock-knock\",\n      \"setup\": \"Knock knock. \\n Who's there? \\n Cows go. \\n Cows go who?\",\n      \"punchline\": \"No, cows go moo.\"\n    },\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b57\",\n      \"type\": \"knock-knock\",\n      \"setup\": \"Knock knock. \\n Who's there? \\n Little old lady. \\n Little old lady who?\",\n      \"punchline\": \"I didn't know you could yodel!\"\n    },\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b86\",\n      \"type\": \"knock-knock\",\n      \"setup\": \"Knock knock. \\n Who's there? \\n Hatch. \\n Hatch who?\",\n      \"punchline\": \"Bless you!\"\n    }\n  ]\n}\n```\n\n### /joke/search\n\n`/joke/search?term=frog`\n\n```json\n{\n  \"success\": true,\n  \"body\": [\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27c3a\",\n      \"type\": \"general\",\n      \"setup\": \"What happens to a frog's car when it breaks down?\",\n      \"punchline\": \"It gets toad.\"\n    },\n    {\n      \"_id\": \"5f80ccd641785ba7c7d27b68\",\n      \"type\": \"general\",\n      \"setup\": \"What happens to a frog's car when it breaks down?\",\n      \"punchline\": \"It gets toad away\"\n    }\n  ]\n}\n```\n\n# Field reference\n\n| Field name |      Description       | Data type |\n| :--------: | :--------------------: | :-------: |\n|     ID     |   Unique identifier    |  string   |\n|    TYPE    |   Identifer of group   |  string   |\n|   COUNT    | Number of wanted items |  string   |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadjokes-io%2Fdad_jokes_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdadjokes-io%2Fdad_jokes_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadjokes-io%2Fdad_jokes_api/lists"}