Jokes API

Basic Usage

This request will return a random joke from our database.

Response Format

{
    "body": "string",
    "title": "string",
    "category": "string",
    "rating": "string"
}
                        

Example Usage

fetch('https://placehold.cloud/j')
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
                        

Random Joke Example

{
    "body": "Because she wants to be the First Lady. ",
    "title": "Why does Hillary have sex with Bill first thing in the morning?",
    "category": null,
    "rating": null
}                        

Notes

• Jokes are randomly selected from our database.
• The response format includes body, title, category, and rating fields.
• No authentication is required to use this endpoint.
• The API adheres to rate limiting to prevent abuse. Please use responsibly.

Error Handling

In case of an error, the API will return an appropriate error response.

API Limits

To ensure fair usage, this API is rate-limited. Please adhere to the following limits:

• 120 requests per minute

Category Filter

You can filter jokes by category by adding a query parameter:

Replace 'YourCategory' with the desired category. Use 'Any' to get jokes from all categories.

Support

For any issues or questions regarding the Jokes API, please contact our support team at support@placehold.cloud.