Fda Database

Acesso ao Banco de Dados da FDA

Visão Geral

Acesse dados regulatórios abrangentes da FDA por meio do openFDA, a iniciativa da FDA de fornecer APIs abertas para conjuntos de dados públicos. Consulte informações sobre medicamentos, dispositivos médicos, alimentos, produtos animais/veterinários e substâncias usando Python com interfaces padronizadas.

Principais capacidades:

• Consultar eventos adversos para medicamentos, dispositivos, alimentos e produtos veterinários
• Acessar rotulagem de produtos, aprovações e submissões regulatórias
• Monitorar recalls e ações de execução
• Procurar Códigos de Medicamento Nacional (NDC) e identificadores de substâncias (UNII)
• Analisar classificações de dispositivos e autorizações (510k, PMA)
• Rastrear escassez de medicamentos e problemas de suprimento
• Pesquisar estruturas químicas e relacionamentos de substâncias

Quando Usar Esta Habilidade

Esta habilidade deve ser usada ao trabalhar com:

• Pesquisa de medicamentos: Perfis de segurança, eventos adversos, rotulagem, aprovações, escassez
• Vigilância de dispositivos médicos: Eventos adversos, recalls, autorizações 510(k), aprovações PMA
• Segurança alimentar: Recalls, rastreamento de alérgenos, eventos adversos, suplementos dietéticos
• Medicina veterinária: Eventos adversos de medicamentos para animais por espécie e raça
• Dados químicos/de substâncias: Busca UNII, mapeamento de número CAS, estruturas moleculares
• Análise regulatória: Caminhos de aprovação, ações de execução, rastreamento de conformidade
• Farmacovigilância: Vigilância pós-comercialização, detecção de sinais de segurança
• Pesquisa científica: Interações de medicamentos, segurança comparativa, estudos epidemiológicos

Início Rápido

1. Configuração Básica

from scripts.fda_query import FDAQuery

# Inicializar (chave de API opcional, mas recomendada)
fda = FDAQuery(api_key="YOUR_API_KEY")

# Consultar eventos adversos de medicamentos
events = fda.query_drug_events("aspirin", limit=100)

# Obter rotulagem de medicamento
label = fda.query_drug_label("Lipitor", brand=True)

# Buscar recalls de dispositivos
recalls = fda.query("device", "enforcement",
                   search="classification:Class+I",
                   limit=50)

2. Configuração de Chave de API

Embora a API funcione sem chave, o registro fornece limites de taxa mais altos:

• Sem chave: 240 requisições/min, 1.000/dia
• Com chave: 240 requisições/min, 120.000/dia

Registre-se em: https://open.fda.gov/apis/authentication/

Defina como variável de ambiente:

export FDA_API_KEY="your_key_here"

3. Executando Exemplos

# Executar exemplos abrangentes
python scripts/fda_examples.py

# Isto demonstra:
# - Perfis de segurança de medicamentos
# - Vigilância de dispositivos
# - Monitoramento de recalls de alimentos
# - Busca de substâncias
# - Análise comparativa de medicamentos
# - Análise de medicamentos veterinários

Categorias do Banco de Dados FDA

Medicamentos

Acesse 6 endpoints relacionados a medicamentos cobrindo todo o ciclo de vida do medicamento, desde aprovação até vigilância pós-comercialização.

Endpoints:

1. Eventos Adversos - Relatórios de efeitos colaterais, erros e falhas terapêuticas
2. Rotulagem de Produtos - Informações de prescrição, avisos, indicações
3. Diretório NDC - Informações de produtos com Código Nacional de Medicamento
4. Relatórios de Execução - Recalls de medicamentos e ações de segurança
5. Drugs@FDA - Dados de aprovação histórica desde 1939
6. Escassez de Medicamentos - Problemas de suprimento atuais e resolvidos

Casos de uso comuns:

# Detecção de sinais de segurança
fda.count_by_field("drug", "event",
                  search="patient.drug.medicinalproduct:metformin",
                  field="patient.reaction.reactionmeddrapt")

# Obter informações de prescrição
label = fda.query_drug_label("Keytruda", brand=True)

# Verificar recalls
recalls = fda.query_drug_recalls(drug_name="metformin")

# Monitorar escassez
shortages = fda.query("drug", "drugshortages",
                     search="status:Currently+in+Shortage")

Referência: Veja references/drugs.md para documentação detalhada

Dispositivos

Acesse 9 endpoints relacionados a dispositivos cobrindo segurança, aprovações e registros de dispositivos médicos.

Endpoints:

1. Eventos Adversos - Mau funcionamento, lesões e mortes de dispositivos
2. Autorizações 510(k) - Notificações de pré-comercialização
3. Classificação - Categorias de dispositivos e classes de risco
4. Relatórios de Execução - Recalls de dispositivos
5. Recalls - Informações detalhadas de recalls
6. PMA - Dados de aprovação pré-comercialização para dispositivos Classe III
7. Registros e Listagens - Dados de estabelecimentos de fabricação
8. UDI - Banco de dados de Identificação Única de Dispositivos
9. Sorologia COVID-19 - Dados de desempenho de testes de anticorpos

Casos de uso comuns:

# Monitorar segurança de dispositivos
events = fda.query_device_events("pacemaker", limit=100)

# Procurar classificação de dispositivo
classification = fda.query_device_classification("DQY")

# Encontrar autorizações 510(k)
clearances = fda.query_device_510k(applicant="Medtronic")

# Pesquisar por UDI
device_info = fda.query("device", "udi",
                       search="identifiers.id:00884838003019")

Referência: Veja references/devices.md para documentação detalhada

Alimentos

Acesse 2 endpoints relacionados a alimentos para monitoramento de segurança e recalls.

Endpoints:

1. Eventos Adversos - Alimentos, suplementos dietéticos e eventos cosméticos
2. Relatórios de Execução - Recalls de produtos alimentares

Casos de uso comuns:

# Monitorar recalls de alérgenos
recalls = fda.query_food_recalls(reason="undeclared peanut")

# Rastrear eventos de suplementos dietéticos
events = fda.query_food_events(
    industry="Dietary Supplements")

# Encontrar recalls de contaminação
listeria = fda.query_food_recalls(
    reason="listeria",
    classification="I")

Referência: Veja references/foods.md para documentação detalhada

Animal e Veterinária

Acesse dados de eventos adversos de medicamentos veterinários com informações específicas de espécie.

Endpoint:

1. Eventos Adversos - Efeitos colaterais de medicamentos para animais por espécie, raça e produto

Casos de uso comuns:

# Eventos específicos por espécie
dog_events = fda.query_animal_events(
    species="Dog",
    drug_name="flea collar")

# Análise de predisposição por raça
breed_query = fda.query("animalandveterinary", "event",
    search="reaction.veddra_term_name:*seizure*+AND+"
           "animal.breed.breed_component:*Labrador*")

Referência: Veja references/animal_veterinary.md para documentação detalhada

Substâncias e Outros

Acesse dados de substâncias em nível molecular com códigos UNII, estruturas químicas e relacionamentos.

Endpoints:

1. Dados de Substâncias - UNII, CAS, estruturas químicas, relacionamentos
2. NSDE - Dados de substâncias históricos (legado)

Casos de uso comuns:

# Mapeamento UNII para CAS
substance = fda.query_substance_by_unii("R16CO5Y76E")

# Pesquisar por nome
results = fda.query_substance_by_name("acetaminophen")

# Obter estrutura química
structure = fda.query("other", "substance",
    search="names.name:ibuprofen+AND+substanceClass:chemical")

Referência: Veja references/other.md para documentação detalhada

Padrões Comuns de Consulta

Padrão 1: Análise de Perfil de Segurança

Crie perfis de segurança abrangentes combinando múltiplas fontes de dados:

def drug_safety_profile(fda, drug_name):
    """Gerar perfil de segurança completo."""

    # 1. Total de eventos adversos
    events = fda.query_drug_events(drug_name, limit=1)
    total = events["meta"]["results"]["total"]

    # 2. Reações mais comuns
    reactions = fda.count_by_field(
        "drug", "event",
        search=f"patient.drug.medicinalproduct:*{drug_name}*",
        field="patient.reaction.reactionmeddrapt",
        exact=True
    )

    # 3. Eventos graves
    serious = fda.query("drug", "event",
        search=f"patient.drug.medicinalproduct:*{drug_name}*+AND+serious:1",
        limit=1)

    # 4. Recalls recentes
    recalls = fda.query_drug_recalls(drug_name=drug_name)

    return {
        "total_events": total,
        "top_reactions": reactions["results"][:10],
        "serious_events": serious["meta"]["results"]["total"],
        "recalls": recalls["results"]
    }

Padrão 2: Análise de Tendências Temporais

Analise tendências ao longo do tempo usando intervalos de datas:

from datetime import datetime, timedelta

def get_monthly_trends(fda, drug_name, months=12):
    """Obter tendências mensais de eventos adversos."""
    trends = []

    for i in range(months):
        end = datetime.now() - timedelta(days=30*i)
        start = end - timedelta(days=30)

        date_range = f"[{start.strftime('%Y%m%d')}+TO+{end.strftime('%Y%m%d')}]"
        search = f"patient.drug.medicinalproduct:*{drug_name}*+AND+receivedate:{date_range}"

        result = fda.query("drug", "event", search=search, limit=1)
        count = result["meta"]["results"]["total"] if "meta" in result else 0

        trends.append({
            "month": start.strftime("%Y-%m"),
            "events": count
        })

    return trends

Padrão 3: Análise Comparativa

Compare múltiplos produtos lado a lado:

def compare_drugs(fda, drug_list):
    """Comparar perfis de segurança de múltiplos medicamentos."""
    comparison = {}

    for drug in drug_list:
        # Total de eventos
        events = fda.query_drug_events(drug, limit=1)
        total = events["meta"]["results"]["total"] if "meta" in events else 0

        # Eventos graves
        serious = fda.query("drug", "event",
            search=f"patient.drug.medicinalproduct:*{drug}*+AND+serious:1",
            limit=1)
        serious_count = serious["meta"]["results"]["total"] if "meta" in serious else 0

        comparison[drug] = {
            "total_events": total,
            "serious_events": serious_count,
            "serious_rate": (serious_count/total*100) if total > 0 else 0
        }

    return comparison

Padrão 4: Busca em Múltiplos Bancos de Dados

Vincule dados em múltiplos endpoints:

def comprehensive_device_lookup(fda, device_name):
    """Procurar dispositivo em todos os bancos de dados relevantes."""

    return {
        "adverse_events": fda.query_device_events(device_name, limit=10),
        "510k_clearances": fda.query_device_510k(device_name=device_name),
        "recalls": fda.query("device", "enforcement",
                           search=f"product_description:*{device_name}*"),
        "udi_info": fda.query("device", "udi",
                            search=f"brand_name:*{device_name}*")
    }

Trabalhando com Resultados

Estrutura de Resposta

Todas as respostas da API seguem esta estrutura:

{
    "meta": {
        "disclaimer": "...",
        "results": {
            "skip": 0,
            "limit": 100,
            "total": 15234
        }
    },
    "results": [
        # Array de objetos de resultado
    ]
}

Tratamento de Erros

Sempre trate erros potenciais:

result = fda.query_drug_events("aspirin", limit=10)

if "error" in result:
    print(f"Erro: {result['error']}")
elif "results" not in result or len(result["results"]) == 0:
    print("Nenhum resultado encontrado")
else:
    # Processar resultados
    for event in result["results"]:
        # Tratar dados de evento
        pass

Paginação

Para grandes conjuntos de resultados, use paginação:

# Paginação automática
all_results = fda.query_all(
    "drug", "event",
    search="patient.drug.medicinalproduct:aspirin",
    max_results=5000
)

# Paginação manual
for skip in range(0, 1000, 100):
    batch = fda.query("drug", "event",
                     search="...",
                     limit=100,
                     skip=skip)
    # Processar lote

Melhores Práticas

1. Use Buscas Específicas

FAÇA:

# Busca de campo específico
search="patient.drug.medicinalproduct:aspirin"

NÃO FAÇA:

# Wildcard muito amplo
search="*aspirin*"

2. Implemente Limitação de Taxa

A classe FDAQuery lida com limitação de taxa automaticamente, mas esteja ciente dos limites:

• 240 requisições por minuto
• 120.000 requisições por dia (com chave de API)

3. Cache de Dados Acessados Frequentemente

A classe FDAQuery inclui cache integrado (habilitado por padrão):

# Cache é automático
fda = FDAQuery(api_key=api_key, use_cache=True, cache_ttl=3600)

4. Use Correspondência Exata para Contagem

Ao contar/agregar, use o sufixo .exact:

# Contar frases exatas
fda.count_by_field("drug", "event",
                  search="...",
                  field="patient.reaction.reactionmeddrapt",
                  exact=True)  # Adiciona .exact automaticamente

5. Valide Dados de Entrada

Limpe e valide termos de busca:

def clean_drug_name(name):
    """Limpar nome de medicamento para consulta."""
    return name.strip().replace('"', '\\"')

drug_name = clean_drug_name(user_input)

Referência de API

Para informações detalhadas sobre:

• Autenticação e limites de taxa → Veja references/api_basics.md
• Bancos de dados de medicamentos → Veja references/drugs.md
• Bancos de dados de dispositivos → Veja references/devices.md
• Bancos de dados de alimentos → Veja references/foods.md
• Bancos de dados animais/veterinários → Veja references/animal_veterinary.md
• Bancos de dados de substâncias → Veja references/other.md

Scripts

scripts/fda_query.py

Módulo de consulta principal com classe FDAQuery fornecendo:

• Interface unificada para todos os endpoints FDA
• Limitação de taxa automática e cache
• Tratamento de erros e lógica de retry
• Padrões de consulta comuns

scripts/fda_examples.py

Exemplos abrangentes demonstrando:

• Análise de perfil de segurança de medicamentos
• Monitoramento de vigilância de dispositivos
• Rastreamento de recalls de alimentos
• Busca de substâncias
• Análise comparativa de medicamentos
• Análise de medicamentos veterinários

Execute exemplos:

python scripts/fda_examples.py

Recursos Adicionais

• Homepage openFDA: https://open.fda.gov/
• Documentação de API: https://open.fda.gov/apis/
• Explorador de API Interativo: https://open.fda.gov/apis/try-the-api/
• Repositório GitHub: https://github.com/FDA/openfda
• Termos de Serviço: https://open.fda.gov/terms/

Suporte e Resolução de Problemas

Problemas Comuns

Problema: Limite de taxa excedido

• Solução: Use chave de API, implemente atrasos ou reduza frequência de requisições

Problema: Nenhum resultado encontrado

• Solução: Tente termos de busca mais amplos, verifique ortografia, use wildcards

Problema: Sintaxe de consulta inválida

• Solução: Revise sintaxe de consulta em references/api_basics.md

Problema: Campos ausentes nos resultados

• Solução: Nem todos os registros contêm todos os campos; sempre verifique existência de campo

Obter Ajuda

• Problemas GitHub: https://github.com/FDA/openfda/issues
• Email: open-fda@fda.hhs.gov