Para Desenvolvedores

API REST Significado do Nome

Acesse o maior banco etimológico do Brasil. Integre dados históricos, gêneros, origens, variações e métricas demográficas do IBGE diretamente na sua aplicação.

Planos e Licenciamento

Gratuito

R$ 0 /mês

500 requisições por mês
Ideal para testes e desenvolvimento
Chave de API Pessoal

Obter Chave Gratuita

Starter

R$ 49,90 /mês

2.500 requisições por mês
Ideal para Apps e Startups em crescimento
Dados IBGE e Glossário Etimológico

Assinar Starter

PRO

R$ 149,90 /mês

10.000 requisições por mês
Limites estendidos para grande volume
Suporte prioritário via e-mail

Assinar PRO

Precisa da base de dados completa offline?

Se o seu projeto necessita da extração total de nossos +16.000 nomes (Database Dump em JSON ou SQL), comercializamos o acesso bruto sob um contrato de licenciamento. Proibida a criação de sites concorrentes diretos.

Falar com o Comercial

Autenticação e Uso do Token

Todos os planos exigem a utilização de um Token de API. Importante: O token completo deve ser copiado do seu painel exatamente como gerado, incluindo o identificador numérico e a barra vertical (ex: 1|w1N948OShOI...).

Nossa API é flexível e permite a autenticação de duas maneiras:

1. Via Header HTTP (Recomendado):
Authorization: Bearer SEU_TOKEN_AQUI
2. Via Query String (Na URL):
GET /api/v1/names?token=SEU_TOKEN_AQUI

Teste Prático (Sem Autenticação)

Para facilitar os testes de integração, abrimos uma exceção no endpoint do nome Maria. A URL abaixo não exige token e retorna exatamente o mesmo Payload detalhado oferecido na rota oficial de um nome único.

https://www.significadodonome.com/api/v1/names/maria

Abrir no Navegador

Endpoints Protegidos

GET /api/v1/names/{slug}

Este é o endpoint responsável por entregar o resultado completo e profundo de um nome específico. Retorna HTML renderizado, estatísticas do IBGE, apelidos e links de glossário. Ideal para a página de perfil principal do seu App.

Parâmetros de Rota (Path Variables)

Parâmetro	Descrição
`slug` Obrigatório	O identificador único do nome, sem acentos e minúsculo. (ex: `maria-heloisa`)

Exemplo de Resposta (Completa)

GET /api/v1/names/maria

{
  "data": {
    "name": "Maria",
    "slug": "maria",
    "gender": "F",
    "origin": "Hebraica",
    "summary": "Senhora soberana, vidente ou a pura.",
    "url": "https://www.significadodonome.com/api/v1/names/maria",
    "type": "common",
    "characteristics": {
      "syllables": "Ma-ri-a",
      "pronunciation": "Ma-RÍ-a",
      "difficulty": "Muito fácil",
      "variants": {
        "male_form": "Mário",
        "female_form": null,
        "augmentative": "Mariona",
        "diminutive": "Mariazinha",
        "nicknames": ["Mari", "Má"]
      }
    },
    "meaning": {
      "text": "O nome Maria é um dos mais populares e antigos do mundo...",
      "html": "<p>O nome <strong>Maria</strong> é um dos mais populares...</p>",
      "personality": "Costuma ser uma pessoa compreensiva e ligada à família.",
      "positive_traits": ["Amorosa", "Compreensiva"],
      "negative_traits": ["Ciumenta"]
    },
    "statistics_ibge": {
      "frequencia": 11694738,
      "rank": 1,
      "percent": 6.12,
      "...": "Outros +15 atributos demográficos detalhados omitidos neste exemplo"
    },
    "glossary": [
      {
        "term": "Hebraica",
        "type": "origem",
        "definition_html": "Relativo aos antigos hebreus...",
        "definition_text": "Relativo aos antigos hebreus..."
      }
    ]
  }
}

GET /api/v1/names

Retorna uma lista paginada de nomes em formato de Lista Rasa (Shallow List). Por questões de performance e arquitetura, dados profundos (como IBGE e textos extensos) não são retornados aqui, obrigando a chamada individual do endpoint de Detalhes.

Filtros de Consulta (Query Params)

Parâmetro	Descrição e Valores Aceitos	Exemplo
`letter`	Filtra nomes pela letra ou sílaba inicial.	`?letter=Ma`
`gender`	Valores: `M` (Masculino), `F` (Feminino), `U` (Unissex).	`?gender=F`
`origin`	Filtra nomes por origem baseando-se no slug.	`?origin=latina`
`type`	Valores: `common`, `compound` (composto), `new`.	`?type=compound`
`sort`	Ordenação. Omitido é ordem alfabética. Utilize `popular` para mais visitados.	`?sort=popular`
`page`	Navegação na paginação dos resultados. Padrão: `1`.	`?page=2`

Exemplo de Resposta (Lista Rasa Paginação)

GET /api/v1/names?gender=F&sort=popular&page=1

{
  "data": [
    {
      "name": "Maria",
      "slug": "maria",
      "gender": "F",
      "origin": "Hebraica",
      "summary": "Senhora soberana, vidente ou a pura.",
      "url": "https://www.significadodonome.com/api/v1/names/maria"
    },
    // ... dezenas de outros objetos rasos
  ],
  "links": {
    "first": "https://www.significadodonome.com/api/v1/names?page=1",
    "last": "https://www.significadodonome.com/api/v1/names?page=125",
    "prev": null,
    "next": "https://www.significadodonome.com/api/v1/names?page=2"
  },
  "meta": {
    "current_page": 1,
    "last_page": 125,
    "total": 2500
  }
}

GET /api/v1/search

Busca rápida otimizada para ser usada em componentes de autocomplete. Retorna uma Lista Rasa em matriz, sem paginação, limitada propositalmente a 15 resultados.

Parâmetro	Descrição
`q` Obrigatório	Termo de busca. Mínimo de 2 caracteres. Pesquisa ocorre pelo nome ou por apelidos.

Exemplo de Resposta (Busca Simplificada)

GET /api/v1/search?q=mar

{
  "data": [
    {
      "name": "Maria",
      "slug": "maria",
      "gender": "F",
      "origin": "Hebraica",
      "summary": "Senhora soberana, vidente ou a pura.",
      "url": "https://www.significadodonome.com/api/v1/names/maria"
    },
    {
      "name": "Marcos",
      "slug": "marcos",
      "gender": "M",
      "origin": "Latina",
      "summary": "Relativo a Marte, guerreiro.",
      "url": "https://www.significadodonome.com/api/v1/names/marcos"
    }
  ]
}

GET /api/v1/glossary

Retorna os termos do glossário etimológico e os nomes associados a cada significado (Busca Reversa). A lista de nomes relacionados (limitada a 15) retorna obrigatoriamente no formato simplificado para manter a estabilidade do payload.

Filtros de Consulta (Query Params)

Parâmetro	Descrição	Exemplo
`q`	Termo de busca etimológica ou significado.	`?q=perfeito`
`page`	Navegação na paginação dos resultados. Padrão: `1`.	`?page=2`

Exemplo de Resposta

GET /api/v1/glossary?q=perfeito

{
  "data": [
    {
      "term": "Perfeito",
      "slug": "perfeito",
      "language": "PT",
      "type": "Comum",
      "definition": "Perfeito é algo que reúne todas as qualidades possíveis, atingindo o mais alto grau em uma escala de valores, sendo incomparável, único e sem igual. Também corresponde a um modelo, conceito ou padrão considerado ideal, exemplar e modelar, sendo executado sem defeito, primoroso e impecável. Além disso, refere-se a algo que não enseja dúvida alguma, sendo cabal, completo e total, sendo sinônimo de excelente, ótimo e irrepreensível.",
      "url": "https://www.significadodonome.com/palavra/perfeito",
      "related_names": [
        {
          "name": "Naira",
          "slug": "naira",
          "gender": "F",
          "origin": "Árabe",
          "summary": "Um nome que evoca liderança e confiança, perfeito para uma mulher forte.",
          "url": "https://www.significadodonome.com/api/v1/names/naira"
        }
      ]
    }
  ],
  "links": {
    "first": "https://www.significadodonome.com/api/v1/glossary?page=1",
    "last": "https://www.significadodonome.com/api/v1/glossary?page=3",
    "prev": null,
    "next": "https://www.significadodonome.com/api/v1/glossary?page=2"
  },
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "total": 55
  }
}

GET /api/v1/origins

Lista todas as origens cadastradas no banco de dados. Útil para popular elementos de <select> na sua interface antes de consultar o endpoint de Listagem Geral com o filtro ?origin={slug}.

Exemplo de Resposta

GET /api/v1/origins

{
  "data": [
    {
      "name": "Hebraica",
      "slug": "hebraica"
    },
    {
      "name": "Latina",
      "slug": "latina"
    }
  ]
}