GET /api/v1/medicamentos Free+
Buscar medicamentos por nome
Busca pelo nome comercial ou pelo princípio ativo, sem diferenciar maiúsculas, acentos nem espaços repetidos: dipirona acha NOVALGINA, e analgésico e analgesico são o mesmo termo. Todas as palavras do termo precisam aparecer. A ordem é por relevância (nome igual ao termo, nome que começa com ele, todas as palavras inteiras no nome, palavras dentro do nome, só pelo princípio ativo) e, dentro de cada grau, por nome e registro: a paginação é estável, nenhum registro repete nem se perde entre as páginas. Sem situacao, só registros ativos. Os itens não trazem preços; para os preços use o detalhe do registro.
Parâmetros
-
nomeTermo de busca: nome comercial ou princípio ativo. De 2 a 100 caracteres (o mínimo vale depois de tirar acentos e espaços repetidos), sem byte NUL, uma vez só.
-
paginaA página do resultado: inteiro de 1 a 1.000.000, só dígitos. Começa em 1.
-
porPaginaItens por página: inteiro de 1 a 100, só dígitos. Nunca é aparado em silêncio: fora do intervalo é 400.
-
situacaoSituação do registro:
ativo,inativooutodos. Sem o parâmetro, só os ativos.
Exemplo de resposta
Busca por nome, com 2 itens por página
200 GET /api/v1/medicamentos?nome=losartana&porPagina=2 key Free
curl -H "X-API-Key: SUA_KEY" \
"https://medicamentos.api.br/api/v1/medicamentos?nome=losartana&porPagina=2"HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
Content-Type: application/json; charset=utf-8
{
"total": 71,
"pagina": 1,
"totalPaginas": 36,
"porPagina": 2,
"resultados": [
{
"registro": "900000111",
"nome": "LOSARTANA POTÁSSICA",
"fabricante": "ALFA LABORATÓRIO FARMACÊUTICO S.A.",
"principioAtivo": "LOSARTANA POTÁSSICA",
"principioAtivoSlug": "losartana",
"classeTerapeutica": "ANTI-HIPERTENSIVOS",
"categoria": "ANTI-HIPERTENSIVOS",
"classificacao": "generico",
"situacao": "ativo"
},
{
"registro": "900000112",
"nome": "LOSARTANA POTÁSSICA",
"fabricante": "BETA INDÚSTRIA QUÍMICA E FARMACÊUTICA LTDA",
"principioAtivo": "LOSARTANA POTÁSSICA",
"principioAtivoSlug": "losartana",
"classeTerapeutica": "ANTI-HIPERTENSIVOS",
"categoria": "ANTI-HIPERTENSIVOS",
"classificacao": "generico",
"situacao": "ativo"
}
]
}Campos da resposta (200): 14
| Campo | Tipo | Descrição |
|---|---|---|
total | inteiro | Quantos itens casam, em todas as páginas. Vale também para uma página além do fim. |
pagina | inteiro | A página devolvida: a pedida. |
totalPaginas | inteiro | Quantas páginas há; no mínimo 1, mesmo sem resultado. |
porPagina | inteiro | Itens por página. |
resultados | lista de objetos | Os medicamentos da página, por relevância. |
resultados[].registro | texto | Registro ANVISA, 9 dígitos. |
resultados[].nome | texto | Nome comercial, como a ANVISA o registra. |
resultados[].fabricante | texto ou null | Detentor do registro. |
resultados[].principioAtivo | texto ou null | O princípio ativo como o registro o escreve, com sal e hidratação (LOSARTANA POTÁSSICA). Para a substância-base, veja principioAtivoSlug. |
resultados[].principioAtivoSlug | texto ou null | Slug do princípio ativo (a substância-base, sem sal nem hidratação): o do primeiro componente nas associações. É o que /api/v1/principios-ativos/{slug} recebe. |
resultados[].classeTerapeutica | texto ou null | Classe terapêutica da lista CMED (ANTI-HIPERTENSIVOS). Não é a categoria regulatória. |
resultados[].categoria | texto ou null | obsoleto Obsoleto: o mesmo valor de classeTerapeutica (a categoria regulatória está em categoriaRegulatoria, no detalhe). Use classeTerapeutica. |
resultados[].classificacao | texto ou null | O que o medicamento é em relação ao de referência: referencia, generico, similar, notificado... Serve para comparar genéricos. |
resultados[].situacao | texto ou null | ativo, inativo (a ANVISA não o lista mais como ativo, mas a lista CMED ainda o traz) ou removido (saiu das duas). |
Erros deste endpoint
400parametro_invalido: um parâmetro ausente, repetido, fora do intervalo ou mal formado (amensagemdiz qual). Não consome cota; o saldo atual vai nos headers (menos no%mal formado da URL, recusado antes de a key ser lida). Também é 400 ocorpo_invalido(corpo JSON malformado), que sai do parse do corpo, antes de qualquer rota e de a key ser lida: para ele os headersX-RateLimit-*não são garantidos.401nao_autenticado: falta o headerX-API-Key.chave_invalida: a key não tem o formato certo, não existe ou foi revogada.429limite_excedido: a cota do plano acabou (a diária ou, no Free, a mensal). O corpo diz quando o contador reinicia (reiniciaEm) e para onde ampliar o plano (upgradeUrl). Os headersX-RateLimit-*descrevem o limite que estourou.500erro_interno: falha do nosso lado. Tente de novo em instantes.