API de DDD: estado e cidades por código de área
Informe um DDD de dois dígitos e receba o estado e a lista de cidades atendidas. Útil para validar telefones em cadastros, rotear atendimento por região e enriquecer listas de contatos. Consulta gratuita, pela API ou pelo seu agente de IA.
Exemplo real
Consulta feita em 08/10/2026 pela BrasilAPI, respondida em 121 ms. Lista de cidades encurtada.
curl -X POST https://superpowers.tools/v1/run \
-H 'Authorization: Bearer $SUPERPOWERS_KEY' \
-H 'content-type: application/json' \
-d '{"tool":"brasilapi.ddd","idempotency_key":"example-1","input":{"ddd":"19"}}'{
"ddd": "19",
"state": "SP",
"cities": [
"AMERICANA",
"CAMPINAS",
"HORTOLÂNDIA",
"INDAIATUBA",
"JAGUARIÚNA",
"LIMEIRA",
"…"
]
}Fontes
Mesma entrada e mesma saída em todas. Taxa de sucesso dos últimos 30 dias aparece a partir de 5 consultas reais.
| Fonte | Preço por consulta | Situação |
|---|---|---|
| BrasilAPI | Grátis | Disponível |
Campos retornados
ddd | Código de área consultado |
state | Estado (UF) |
cities | Cidades atendidas pelo DDD |
Use no seu agente de IA
Adicione o servidor MCP no Claude, Cursor ou outro cliente e peça em linguagem natural.
{
"mcpServers": {
"superpowers": {
"url": "https://superpowers.tools/mcp",
"headers": {
"Authorization": "Bearer sp_live_…"
}
}
}
}Perguntas frequentes
A consulta é paga?
Não. A consulta de DDD é gratuita. A conta só é necessária para ter uma chave de API, e o crédito inicial de US$5 serve para as outras ferramentas.
Dá para validar um número de telefone com isso?
Dá para conferir se o DDD existe e se corresponde ao estado informado no cadastro. A API não diz se o número em si está ativo.
Um DDD pode atender mais de um estado?
Não. Cada DDD pertence a um único estado, mas um estado pode ter vários DDDs, como São Paulo, com 11 a 19.
Dá para usar com Claude, ChatGPT ou Cursor?
Sim. Com o servidor MCP da Superpowers configurado, o agente consulta o DDD sozinho, por exemplo para separar uma lista de contatos por região.
Comece com US$5 de crédito
Esta consulta é gratuita; o crédito serve para as outras ferramentas. Sem cartão para começar.