POST AI agent ready /v1/url/parse

API de análise de URL - Extrator gratuito de componentes de URL

Divide uma URL em seus componentes estruturais: protocolo, nome do host, porta, nome do caminho, parâmetros de pesquisa (como pares de valores-chave) e fragmento de hash. Útil para análise de URL e lógica de roteamento.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/url/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/path?q=test&page=2#section"}'

When to use this API

Roteamento baseado em URL em funções sem servidor

Analise URLs de solicitações recebidas para extrair segmentos de caminho e parâmetros de consulta para roteamento de solicitações sem uma estrutura completa.

Análise e categorização de links

Extraia o nome do host de URLs enviados por usuários para categorizar links por domínio, detectar URLs afiliados ou bloquear origens específicas.

Extração de tags do Analytics

Analise URLs de marketing para extrair parâmetros UTM (utm_source, utm_medium, utm_campaign) para rastreamento de atribuição.

Frequently asked questions

Os parâmetros de consulta são retornados como um objeto?

Sim. O campo searchParams contém um objeto de valor-chave em que cada parâmetro de consulta é uma entrada separada.

O que acontece com chaves de parâmetros de consulta duplicadas?

Chaves duplicadas são retornadas como uma matriz. Por exemplo, ?tag=a&tag=b produz { tag: ["a", "b"] }.

Ele lida com URLs relativos?

A API espera URLs absolutos com um protocolo. Caminhos relativos como "/page?q=1" retornam um erro.

Os nomes de domínio internacionalizados são suportados?

Sim. A API lida com domínios IDN (punycode) e os decodifica na resposta.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.