Получите доступ к данным о глобальном рейтинге веб-сайтов для вашего веб-сайта и веб-сайтов ваших конкурентов, используя бесплатный DigitalRank API от Similarweb.
Как использовать API ранжирования веб-сайта?
Может быть непросто получить обзор производительности веб-сайтов и сравнить ваш веб-сайт с конкурентами и индустрией в целом. Similarweb предлагает несколько API-решений, включая новый Website DigitalRank API от Similarweb.
Website DigitalRank API предоставляет вам бесплатный доступ к данным глобального рейтинга веб-сайтов*, чтобы вы могли:
- Сравнивать свой веб-сайт с конкурентами
- Определять новые возможности для роста
- Доказывать успех вашего веб-сайта
- Раскрывать потенциальные партнерские отношения
Similarweb получает диджитал данные о рейтинге и трафике из более чем 10 миллиардов ежедневных цифровых сигналов, которые мы разрабатывали более 10 лет. Эта обширная сеть сигналов обеспечивает масштаб и точность, которые делают Similarweb лидером в области диджитал аналитики.
Основанный на простых принципах REST, DigitalRank API использует стандартные коды ответов HTTP и аутентификацию.
Перейдите к:
Начните работу с API ранжирования веб-сайта
Чтобы начать, перейдите на страницу регистрации DigitalRank API и введите свои контактные данные. После регистрации вы получите электронное письмо с вашим персональным ключом API.
Примечание: используя API от Similarweb, вы соглашаетесь с условиями использования и политикой конфиденциальности, а также с приведенными ниже рекомендациями по внешнему использованию.
* Максимум 5000 точек данных в месяц бесплатно. Для получения дополнительной информации или возможностей обратитесь к представителю по продажам.
Техническая документация
С помощью DigitalRank API от Similarweb вам доступны следующие вызовы API:
- Top SimilarRank Sites: определяйте веб-сайты с самым высоким рейтингом по всему миру.
- Website SimilarRank: определяйте глобальный рейтинг конкретного веб-сайта.
- Получить статус подписки: проверяйте, сколько ежемесячных точек данных остается в вашем аккаунте SimilarRank из лимита в 5000.
Top SimilarRank Sites
Обратитесь к этой конечной точке, чтобы найти веб-сайты с самым высоким рейтингом по всему миру:
Ввод URL-адреса: |
https://api.similarweb.com/v1/similar-rank/top-sites?api_key={{similarweb_api_key}}&limit={{50}} |
||
Параметры ввода: |
|
||
Пример ответа: |
|
Плата: за каждый результат будет взиматься 1 точка данных. В примере ответа ограничение установлено равным 3, что означает, что будет взиматься 3 точки данных.
Примечания:
- Максимальное количество результатов = 5000
- Данные основаны на данных о трафике и вовлеченности за предыдущий месяц и включают данные с настольных компьютеров и мобильных устройств.
- Заголовок ответа содержит количество точек данных, используемых в запросе (см. "sw-datapoint-charged").
Website SimilarRank
Определите глобальный рейтинг конкретного веб-сайта:
Ввод URL-адреса: |
https://api.similarweb.com/v1/similar-rank/{{domain.com}}/rank?api_key={{similarweb_api_key}} |
||
Параметры ввода: |
|
||
Пример ответа: |
|
Плата: за каждый результат будет взиматься 1 точка данных.
Примечания:
- Данные основаны на данных о трафике и вовлеченности за предыдущий месяц и включают данные с настольных компьютеров и мобильных устройств.
- Заголовок ответа содержит количество точек данных, используемых в запросе (см. ‘sw-datapoint-charged’).
Получить статус подписки
Проверьте, сколько ежемесячных точек данных остается в вашем аккаунте SimilarRank из лимита в 5000.
Ввод URL-адреса: |
https://api.similarweb.com/user-capabilities?api_key={{similarweb_api_key}} |
|
Параметры ввода: |
'similarweb_api_key': введите свой персональный ключ API (удалите фигурные скобки) |
|
Пример ответа: |
|
Плата: эта конечная точка не стоит точек данных.
Примечания: ежемесячные данные обновляются 1 числа каждого месяца.
Часто задаваемые вопросы и коды ошибок
Вопрос: Где я могу получить ключ API для DigitalRank API? |
Ответ: Зарегистрируйтесь здесь, и мы вышлем вам по электронной почте ключ API (пожалуйста, подождите несколько рабочих дней). |
Вопрос: Как Similarweb рассчитывает потребление точек данных DigitalRank API? |
Ответ: Один результат ранжирования домена считается одной точкой данных. |
Вопрос: Сколько точек данных API я получу? |
Ответ: В начале каждого месяца ваш ключ будет обновляться 5000 точками данных. Неиспользованные точки данных не будут перенесены на следующий месяц. |
Вы можете увидеть, сколько ежемесячных точек данных у вас осталось, запросив конечную точку «Получить статус подписки» (см. документацию выше). |
Вопрос: У меня не осталось точек данных API. Как я могу добавить больше? |
Ответ: Для пользователей DigitalRank API установлен лимит в 5000 точек данных в месяц. Если вам нужны дополнительные данные или возможности, пожалуйста, свяжитесь с представителем по продажам. |
Вопрос: Если у меня есть существующий ключ API от премиум-аккаунта Similarweb, могу ли я использовать конечные точки DigitalRank API? |
Ответ: Да. Конечные точки DigitalRank API будут доступны через ваш существующий ключ Similarweb API. Обратите внимание, что с ваших ежемесячных премиум хитов API будет взиматься плата. |
Вопрос: Где я могу узнать больше о методологии сбора данных Similarweb? |
Ответ: Вы можете прочитать больше о нашей методологии здесь. |
Вопрос: Как рассчитывается глобальный рейтинг? |
Ответ: Собственный глобальный рейтинг Similarweb рассчитывается на основе уникальных посетителей веб-сайта и просмотров страниц. Посетите наш глоссарий, чтобы узнать больше. |
Вопрос: Как часто обновляются данные глобального рейтинга? |
Ответ: Данные глобального рейтинга обновляются ежемесячно. Данные публикуются к 10-му числу следующего месяца (в большинстве случаев они публикуются раньше). После обновления они остаются фиксированными в течение месяца. |
Вопрос: Я ошибся/ошиблась. Могу ли я вернуть обратно точки данных? |
Ответ: К сожалению, в настоящее время вернуть точки данных невозможно. Вашему ключу API будет выделено 5000 новых точек данных в начале каждого месяца. |
Коды ошибок
403: Достигнут лимит месячных точек данных. Свяжитесь с представителем по продажам, чтобы обсудить наши премиальные планы.
401: Это конечная премиум точка Similarweb. Пожалуйста, свяжитесь с представителем по продажам, чтобы узнать больше.
400: Лимит вне диапазона. Ограничение должно быть от 1 до 5000.
404: Данные не найдены. Возможно, у этого веб-сайта еще нет глобального рейтинга.
429: Слишком много запросов, сделанных за короткий промежуток времени. Это может произойти, если вы делаете более 10 запросов в секунду.
Рекомендации по внешнему использованию данных Similarweb
Вы можете извлекать данные с помощью DigitalRank API и использовать эти данные внутри компании и/или предоставлять такие данные в своем продукте платформы. Если вы отображаете данные на своей платформе, вы (и любой, кто использует данные и/или управляет вашей платформой) должны соблюдать следующие условия:
- Вы можете отображать только показатели, доступные в конечной точке Similarweb DigitalRank API.
- По запросу Similarweb будет предоставлена бесплатная лицензия с полным доступом для доступа к вашей платформе в целях контроля за соблюдением настоящих руководящих принципов.
- Для каждого случая использования данных на вашей платформе вы должны включать атрибуцию и брендинг Similarweb, включая, как минимум, название и логотип Similarweb, слова «DigitalRank от Similarweb» и ссылку на www.similarweb.com, четко и заметно отображенную на каждой странице, использующей данные, в соответствии с руководящими принципами брендинга Similarweb, доступными по адресу: https://company-212865.frontify.com/d/N8HWGuVHeoVg/brand-guidelines
- Вы не должны использовать эти данные для конкуренции с Similarweb.
- Вы должны убедиться, что любые части вашей платформы, отображающие данные, не подпадают под действие каких-либо условий конфиденциальности, условий использования или других ограничений или требований, применимых к использованию платформы.
- Вы не имеете права предоставлять какие-либо данные Similarweb или конечные точки Similarweb API, включая, помимо прочего, данные, доступные через DigitalRank API, доступные через любое предложение API, доступное пользователям платформы или любой другой третьей стороне, если только такие данные не были объединены с другими данными таким образом, что их нельзя идентифицировать как данные из Similarweb.
Узнать больше
Узнайте больше об API Similarweb.
Комментарии
Статья закрыта для комментариев.