POST AI agent ready /v1/url/parse

URL Parse API — бесплатный экстрактор компонентов URL

Разбивает URL-адрес на его структурные компоненты: протокол, имя хоста, порт, путь, параметры поиска (в виде пар ключ-значение) и фрагмент хэша. Полезно для анализа URL-адресов и логики маршрутизации.

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

Маршрутизация на основе URL-адресов в бессерверных функциях

Анализируйте URL-адреса входящих запросов, чтобы извлечь сегменты пути и параметры запроса для маршрутизации запросов без полной инфраструктуры.

Анализ и категоризация ссылок

Извлекайте имя хоста из URL-адресов, отправленных пользователем, чтобы классифицировать ссылки по домену, обнаруживать партнерские URL-адреса или блокировать определенные источники.

Извлечение тегов аналитики

Анализируйте маркетинговые URL-адреса для извлечения параметров UTM (utm_source, utm_medium, utm_campaign) для отслеживания атрибуции.

Frequently asked questions

Параметры запроса возвращаются как объект?

Да. Поле searchParams содержит объект «ключ-значение», где каждый параметр запроса представляет собой отдельную запись.

Что происходит с повторяющимися ключами параметров запроса?

Дублирующиеся ключи возвращаются в виде массива. Например, ?tag=a&tag=b создает { tag: ["a", "b"] }.

Обрабатывает ли он относительные URL-адреса?

API ожидает абсолютные URL-адреса с протоколом. Относительные пути, такие как «/page?q=1», возвращают ошибку.

Поддерживаются ли интернационализированные доменные имена?

Да. API обрабатывает домены IDN (punycode) и декодирует их в ответе.

Get your API key

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