Começo rápido
Base: https://radprice.datatoms.com/api/v1 · Especificação OpenAPI: /api/v1/openapi.json
curl "https://radprice.datatoms.com/api/v1/medicines?q=dipirona&uf=CE&limit=3" curl "https://radprice.datatoms.com/api/v1/prices/summary?product=gasolina-comum®ion=BR"
Respostas JSON; valores em reais como texto decimal exato (ex.: "6.49"); datas ISO; erros no formato { error: { code, message, requestId } }.
Endpoints
Combustíveis e gás
ANP — levantamento semanal amostral
- GET /api/v1/products
- Produtos (gasolina, etanol, diesel, GNV, GLP…)
- GET /api/v1/prices/summary?product=gasolina-comum®ion=BR
- Média, mínimo e máximo da semana (Brasil, UF ou município)
- GET /api/v1/prices/history?product=etanol-hidratado®ion=CE&weeks=12
- Série semanal
- GET /api/v1/map/layers?product=gasolina-comum&level=state
- Camada do mapa por UF ou município
- GET /api/v1/stations?product=diesel-s10®ion=2304400
- Postos pesquisados (posição e preço da semana)
Farmácia
CMED/ANVISA — preço máximo ao consumidor (teto legal)
- GET /api/v1/medicines?q=losartana&uf=SP
- Busca por nome, substância, laboratório ou EAN, com PMC na alíquota da UF
- GET /api/v1/medicines/{ggrem}?uf=CE&rate=20
- Tabela completa PF/PMC, histórico e equivalentes da mesma substância
Supermercado, farmácia e eletrônicos (índices)
IBGE — IPCA por subitem (variação %, nunca preço em reais)
- GET /api/v1/indices/supermarket?area=1
- Último mês de cada subitem numa área (1 = Brasil; 2301 = Fortaleza…)
- GET /api/v1/indices/item/ipca:7173?area=3501
- Série mensal e ranking das 16 áreas (12 meses)
Construção civil
CAIXA/IBGE — SINAPI mensal
- GET /api/v1/construction/items?uf=CE&q=cimento
- Insumos e composições com preço de referência na UF
- GET /api/v1/construction/items/{code}?uf=CE
- Detalhe, série mensal e mapa por UF
Imóveis
BCB (IVG-R, IPCA) e prefeituras (ITBI)
- GET /api/v1/real-estate/overview
- Valorização (IVG-R) × inflação
- GET /api/v1/real-estate/prices-per-m2?municipality=2304400&type=residencial
- Mediana do m² por bairro (amostra mínima)
Frescor dos dados (nada é tempo real)
- ANP (combustíveis, GLP)
- Semanal — a semana da coleta vem em cada resposta.
- CMED/ANVISA (medicamentos)
- Lista conferida todo dia; muda quando a CMED publica (em geral mensal).
- IBGE/IPCA (supermercado, farmácia, eletrônicos)
- Mensal — por volta do dia 10 do mês seguinte.
- CAIXA/SINAPI (construção)
- Mensal.
- BCB e prefeituras (imóveis)
- Mensal (IVG-R, IPCA) e conforme a publicação de cada prefeitura (ITBI).
Preço por loja de supermercado/farmácia em tempo quase real só existe em portais de nota fiscal eletrônica dos estados; o RadPrice só vai usá-los com licença ou convênio que permita reuso. Até lá, “Sem dados suficientes”.
Regras de uso
- Cite “RadPrice” e a fonte oficial de cada dado (o campo de fonte vem na resposta). Não apresente teto (CMED) como preço de loja nem índice (IPCA) como preço em reais.
- Limite de uso: 300 requisições por minuto por IP (respostas 429 pedem para aguardar). Respostas têm cache; repetir a mesma consulta é barato.
- Somente leitura. Anúncios do mural são conteúdo pago e não fazem parte da API de dados.
- Dúvidas e parcerias: fale com a equipe. Termos completos em /termos.