API метаданных URL для предпросмотра ссылок и веб-аналитики

API для Единый анализ URL

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

{ "requested_url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "title": "Example Domain", "canonical_url": "https://example.com/", "open_graph": {}, "structured_data": { "types": [], "items": 0, "parse_errors": 0 }, "meta": { "cached": false, "fetch_transport": "worker" } }

Category Веб-данные

Конечные точки 2

Ключевые возможности 6

Заголовок 5

Используется сотрудниками известных компаний

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Работает Статус сервиса

Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.

OpenAPI API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

10,000 Бесплатный лимит

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Что помогает запустить эта API

Используйте эту страницу как производственный бриф: конечные точки, примеры, форма ответа и элементы workflow для подключения DomScan к вашему продукту.

Продуктовые workflow

Встраивайте проверки доменов, DNS-интеллект, сигналы риска или обогащение в онбординг, поиск и внутренние инструменты.

Автоматизация аналитиков

Заменяйте повторяющиеся ручные проверки расписаниями, оповещениями и воспроизводимыми шагами расследования.

Чистые JSON-данные

Используйте предсказуемые поля, документированные коды состояния и стоимость в кредитах вместо scraping страниц провайдеров.

AI и ops-инструменты

Передавайте данные агентам, дашбордам, SOAR-плейбукам и CRM через OpenAPI, SDK, Postman или MCP.

Интеграционный workflow

Простой путь от первого запроса до повторяемого использования в продакшене.

Аутентифицируйтесь один раз

Передавайте API-ключ в документированном заголовке и сохраняйте единый формат запросов между сервисами.

Запрашивайте по примерам

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

Эксплуатируйте и мониторьте

Используйте коды состояния, стоимость кредитов и поля ответа для retries, логов и alerts.

Набор разработчика

Переходите к машиночитаемой документации, коллекциям запросов, SDK или инструментам для агентов.

Схема OpenAPI

Генерируйте клиенты или изучайте форму каждого запроса и ответа.

Коллекция Postman

Импортируйте готовые запросы для ручного тестирования и передачи команде.

SDK и CLI

Используйте поддерживаемые пакеты и командную строку вместо написания boilerplate.

Интеграция MCP

Открывайте доменную разведку AI-агентам и внутренним ассистентам.

Карта параметров и ответа

Просмотрите входы, поля ответа и коды состояния перед подключением endpoint к клиенту.

Параметры запроса

Параметр

urlskip_cacheurls

Поля ответа

Пример ответа

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached

Покрытие статусов

Коды статуса HTTP

200400401402429502

Конечные точки

GET /v1/url-intelligence

Кредиты: 2Аутентификация: Требуется аутентификация

POST /v1/url-intelligence/bulk

Кредиты: 2/itemАутентификация: Требуется аутентификация

Сигналы доверия перед интеграцией

Статус сервиса API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

Бесплатный лимит Зарегистрируйтесь Бесплатно

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Активен Пример запроса

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

Ключевые возможности

Нормализованные метаданные страницы

Извлекайте заголовок, описание, язык, тип содержимого, конечный URL и канонический URL.

Поля для предпросмотра ссылок

Создавайте карточки предпросмотра из нормализованных изображений, фавиконов, тегов Open Graph и Twitter Cards.

Сводка структурированных данных

Определяйте типы JSON-LD и получайте сведения об ошибочных блоках без возврата неограниченного объема данных страницы.

Сигналы robots и безопасности

Читайте директивы индексирования и разрешенный набор общедоступных заголовков безопасности.

Контакты и публичные профили

Извлекайте заявленные адреса электронной почты, телефоны и ссылки на социальные, разработческие и авторские профили.

Массовое получение метаданных URL

Проверяйте до 10 URL за запрос с ограниченным параллелизмом и отдельными ошибками для каждого элемента.

Пример запроса

GET /v1/url-intelligence?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence

POST /v1/url-intelligence/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

Пример ответа

200 OK json

{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

Заголовок

Чем API метаданных URL отличается от API Open Graph?

API Open Graph сосредоточен на социальных тегах. DomScan также возвращает канонический URL, перенаправления, robots, структурированные данные, сигналы безопасности, контактов и идентичности.

Что происходит, если теги Open Graph отсутствуют?

Поля Open Graph остаются пустыми, а стандартный заголовок, описание, значки, структурированные данные и другие доступные сигналы все равно возвращаются.

API выполняет JavaScript?

Нет. Первая версия анализирует ограниченные общедоступные HTML-ответы и не заявляет метаданные, которые появляются только после выполнения клиентского JavaScript.

API безопасно следует перенаправлениям?

Да. Число перенаправлений ограничено, и каждый адрес назначения проверяется для предотвращения доступа к частным или внутренним сетевым ресурсам.

Можно ли проверить несколько URL одновременно?

Да. Массовый эндпоинт принимает до 10 общедоступных URL и сохраняет порядок входных данных.

Связанные инструменты и ресурсы

Коды статуса HTTP

Мы документируем HTTP-коды состояния, которые должен обрабатывать ваш клиент, чтобы различать успешные ответы, проблемы аутентификации, кредиты, лимиты запросов, отсутствующие данные и ошибки вышестоящих сервисов.

OK 200

Запрос выполнен успешно

Неверный запрос 400

Недопустимые параметры

Не авторизован 401

API-ключ или сессия отсутствует либо недействительна.

Требуется оплата 402

Недостаточно кредитов для выполнения этого запроса.

Слишком много запросов 429

Лимит скорости превышен

Ошибка шлюза 502

Ошибка RDAP внешнего сервера

Создавайте продукты с анализом URL

Начать бесплатно Просмотреть документацию