Como Capturar Parâmetros da URL com JavaScript (Função Pronta)

Para capturar parâmetros da URL com JavaScript, use a função capturarParametro que recebe o nome do parâmetro e retorna seu valor. Basta copiar a função abaixo, colar na sua página e chamar com o nome do parâmetro desejado. Funciona em qualquer navegador.

"Capturar parâmetros da URL é a base de tudo: rastreamento, personalização, formulários dinâmicos e passagem de dados entre páginas."

Resumo rápido:

• Uma função JavaScript de 5 linhas captura qualquer parâmetro da URL
• Funciona para UTMs, emails, nomes, IDs -- qualquer parâmetro
• Compatível com todos os navegadores, incluindo versões antigas
• Também existe a alternativa moderna com URLSearchParams

A função pronta para copiar e colar

Esta função usa regex para encontrar qualquer parâmetro na query string da URL:

<script>
    // Função para capturar qualquer parâmetro da URL
    function capturarParametro(nome) {
        nome = nome.replace(/[\[]/, '\\[').replace(/[\]]/, '\\]');
        var regex = new RegExp('[\\?&]' + nome + '=([^&#]*)');
        var resultado = regex.exec(location.search);
        return resultado === null ? '' : decodeURIComponent(resultado[1].replace(/\+/g, ' '));
    }
</script>

Se a URL for https://suapagina.com.br?utm_source=facebook&nome=Lucas, chamar capturarParametro('utm_source') retorna facebook e capturarParametro('nome') retorna Lucas.

Exemplos práticos de uso

Capturar UTMs para rastreamento

O caso mais comum é capturar UTMs para armazenar ou repassar para outra página:

<script>
    // Captura cada parâmetro UTM individualmente
    var fonte = capturarParametro('utm_source');
    var meio = capturarParametro('utm_medium');
    var campanha = capturarParametro('utm_campaign');
    var conteudo = capturarParametro('utm_content');

    // Exemplo: exibe no console para verificação
    console.log('Fonte:', fonte, 'Campanha:', campanha);
</script>

Preencher campos de formulário automaticamente

Se o visitante chega com email ou nome na URL, você pode preencher o formulário automaticamente:

<script>
    // Preenche o campo de email se o parâmetro existir
    var email = capturarParametro('email');
    if (email) {
        document.getElementById('email').value = email;
    }

    // Preenche o campo de nome se o parâmetro existir
    var nome = capturarParametro('nome');
    if (nome) {
        document.getElementById('nome').value = nome;
    }
</script>

A URL seria algo como: https://suapagina.com.br/cadastro?email=lucas@email.com&nome=Lucas

Personalizar o conteúdo da página

Você pode mudar textos na página com base nos parâmetros:

<script>
    // Mostra o nome do visitante na página
    var nome = capturarParametro('nome');
    if (nome) {
        document.getElementById('saudacao').textContent = 'Olá, ' + nome + '!';
    }
</script>

Construir URLs dinâmicas

Combine parâmetros capturados para montar links de checkout ou redirects com passagem de UTMs:

<script>
    // Monta URL de checkout com os parâmetros capturados
    var checkoutUrl = 'https://checkout.com/produto';
    var fonte = capturarParametro('utm_source');
    var campanha = capturarParametro('utm_campaign');

    // Adiciona parâmetros se existirem
    if (fonte) checkoutUrl += '?src=' + fonte;
    if (campanha) checkoutUrl += '&camp=' + campanha;

    // Aplica no botão de compra
    document.getElementById('botao-compra').href = checkoutUrl;
</script>

Alternativa moderna: URLSearchParams

Navegadores modernos oferecem a API URLSearchParams, que é mais simples:

<script>
    // Alternativa moderna para capturar parâmetros
    var params = new URLSearchParams(window.location.search);
    var fonte = params.get('utm_source'); // Retorna o valor ou null
    var nome = params.get('nome');
</script>

A vantagem é a sintaxe mais limpa. A desvantagem é que não funciona no Internet Explorer. Se o seu público pode usar navegadores antigos, a versão com regex é mais segura. Para a maioria dos projetos em 2026, o URLSearchParams é a melhor escolha.

Quando cada versão faz mais sentido

Use a função com regex quando: precisa de compatibilidade máxima, trabalha com páginas de vendas que recebem tráfego de origens diversas, ou precisa de uma solução que funcione em qualquer ambiente.

Use o URLSearchParams quando: o público usa navegadores modernos, você está desenvolvendo um projeto novo, ou quer código mais legível.

O Trafius usa parâmetros de URL para conectar dados de campanha com alertas no WhatsApp -- capturar esses parâmetros corretamente é o que garante que cada conversão seja atribuída ao anúncio certo.

---

Perguntas frequentes

A função funciona com parâmetros que contêm caracteres especiais?

Sim. O decodeURIComponent no final da função decodifica caracteres especiais como espaços (que aparecem como + ou %20), acentos e outros caracteres codificados na URL.

Posso capturar o fbclid do Facebook com essa função?

Sim. Basta chamar capturarParametro('fbclid'). O fbclid é um parâmetro como qualquer outro na URL, adicionado automaticamente pelo Facebook quando alguém clica no anúncio.

O que retorna se o parâmetro não existir na URL?

A função retorna uma string vazia (''). O URLSearchParams.get() retorna null. Em ambos os casos, faça uma verificação antes de usar o valor para evitar erros.

Posso usar a função em mais de uma página do mesmo site?

Sim. O ideal é colocar a função em um arquivo JavaScript separado e incluí-lo em todas as páginas que precisarem. Assim você não repete código e facilita a manutenção.