Dark Humor API Logo
API REST Gratuita

Dark Humor API

Compilação de +1000 piadas de humor negro, incluindo 80 de autoria do péssimo humorista brasileiro Léo Lins e outras mais de 1000 no mesmo estilo. Coletadas de diversas fontes e adaptadas para uso em API.

Documentação
Pressione R para nova piada
Response JSON
{
  "id": 1,
  "value": "Carregando piada...",
  "theme": "Tema",
  "url": "https://darkhumor-api.ddns.net/jokes/1"
}

Endpoints da API

Todos os endpoints são públicos e não requerem autenticação

GET
Piada Aleatória
https://darkhumor-api.ddns.net/jokes/random

Retorna uma piada aleatória da nossa coleção de 1000+ piadas.

Sempre diferente a cada requisição
GET
Categorias
https://darkhumor-api.ddns.net/jokes/categories

Lista todas as categorias disponíveis para filtrar piadas.

65+ categorias diferentes
GET
Busca por Texto
https://darkhumor-api.ddns.net/jokes/search?query={termo}

Busca piadas que contenham o termo especificado.

Busca em piadas e temas
GET
Por Categoria
https://darkhumor-api.ddns.net/jokes/random?category={categoria}

Retorna uma piada aleatória da categoria especificada.

Filtragem por tema
GET
Piada por ID
https://darkhumor-api.ddns.net/jokes/{id}

Retorna uma piada específica pelo seu ID único.

IDs de 1 a 1000+

Exemplos de Código

Integre facilmente em qualquer linguagem de programação

JavaScript (Fetch API)
// Buscar piada aleatória
fetch('https://darkhumor-api.ddns.net/jokes/random')
  .then(response => response.json())
  .then(data => {
    console.log(data.value);
    console.log('Tema:', data.theme);
  })
  .catch(error => console.error('Erro:', error));

// Buscar por categoria
fetch('https://darkhumor-api.ddns.net/jokes/random?category=obesidade')
  .then(response => response.json())
  .then(data => console.log(data.value));
PHP (file_get_contents)
<?php
// Buscar piada aleatória
$response = file_get_contents('https://darkhumor-api.ddns.net/jokes/random');
$joke = json_decode($response, true);

echo $joke['value'] . "\n";
echo "Tema: " . $joke['theme'] . "\n";

// Usando cURL para mais controle
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://darkhumor-api.ddns.net/jokes/random');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$joke = json_decode($response, true);
echo $joke['value'];
?>
Python (requests)
import requests
import json

# Buscar piada aleatória
response = requests.get('https://darkhumor-api.ddns.net/jokes/random')
joke = response.json()

print(joke['value'])
print(f"Tema: {joke['theme']}")

# Buscar por categoria
params = {'category': 'obesidade'}
response = requests.get('https://darkhumor-api.ddns.net/jokes/random', params=params)
joke = response.json()
print(joke['value'])

# Buscar piadas
search_params = {'query': 'gordo'}
response = requests.get('https://darkhumor-api.ddns.net/jokes/search', params=search_params)
results = response.json()
print(f"Encontradas {results['total']} piadas")
cURL (Terminal)
# Piada aleatória
curl https://darkhumor-api.ddns.net/jokes/random
# Piada por categoria
curl "https://darkhumor-api.ddns.net/jokes/random?category=obesidade"

# Buscar piadas
curl "https://darkhumor-api.ddns.net/jokes/search?query=gordo"

# Listar categorias
curl https://darkhumor-api.ddns.net/jokes/categories
# Piada específica por ID
curl https://darkhumor-api.ddns.net/jokes/{id}
# Exemplo:
curl https://darkhumor-api.ddns.net/jokes/42
# Com formatação JSON (usando jq)
curl https://darkhumor-api.ddns.net/jokes/random | jq '.'