Dad Jokes API

This API returns wide range of dad jokes. New jokes are added monthly.

Methods

GET: /dad-jokes/health

Description

Return the health status of the API. Returns current UTC time.

Request

https://{base-url}/dad-jokes/health

Response

{
    "time": "2022-05-30T14:56:30.128Z"
}

GET: /dad-jokes/random

Description

Return random joke.

Request

https://{base-url}/dad-jokes/random

Response

{
    "joke": "What do you call a pudgy psychic? A four-chin teller.",
    "source": "https://..."
}

GET: /dad-jokes/search

Description

Search for a joke by a keyword. Keyword will be used as is in the search. E.g. if you need to search for a joke with the keyword “dad” in it, you will need to pass “dad” as the keyword. If you need to search for a joke with specific word, you will need to pass keyword with surrounding spaces or punctuation, e.g. " dad". Search is not case-sensitive.

API return is limited to 3 records per one search request.

Request

https://{base-url}/dad-jokes/search?text=dad

> Note: text query parameter is required and should be more than 3 characters long.

Response

[
    {
        "joke": "A dad died due to us not being able to remember his blood type. As he died, he kept insisting that we \"be positive\", but it's hard without him.",
        "source": "https://..."
    },
    {
        "joke": "\"I'll call you later.\" \"Don't call me later, call me Dad.\"",
        "source": "https://..."
    },
    ...
]

GET: /dad-jokes/joke-of-the-day

Description

Return joke of the day. Each new UTC day API will return a new joke. During the UTC day, API returns the same joke.

Request

https://{base-url}/dad-jokes/joke-of-the-day

Response

{
    "joke": "What do you call a pudgy psychic? A four-chin teller.",
    "source": "https://..."
}