Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Trustpilot: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Сведенияprofile | Найдите страницу компании на Trustpilot по домену: TrustScore, рейтинг в звёздах, число отзывов и категории. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Получите отзывы о компании на Trustpilot: оценку, уровень верификации, данные автора, дату опыта и ответ компании. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Trustpilot?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
profileСведения Найдите страницу компании на Trustpilot по домену: TrustScore, рейтинг в звёздах, число отзывов и категории. TrustScore является взвешенной оценкой от 1 до 5, а не простым средним; вызов не сертифицирует компанию и не пересчитывает оценку. | company | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | name · domain · url · trust_score · rating · rating_scale · review_count · categories · platform |
reviewsОтзывы Получите отзывы о компании на Trustpilot: оценку, уровень верификации, данные автора, дату опыта и ответ компании. Фильтруйте по готовому диапазону дат, языку, числу звёзд, сортировке или | company | date, lang, language, sort, stars, verified_only | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · rating · rating_scale · language · like_count · is_verified · verification_level · source · country · author_name · author_id · author_image · author_review_count · reply_text · reply_at · experience_at · updated_at · posted_at · company_name · company_domain · platform |
Что означают параметры действия profile в API Trustpilot?
Найдите страницу компании на Trustpilot по домену: TrustScore, рейтинг в звёздах, число отзывов и категории. TrustScore является взвешенной оценкой от 1 до 5, а не простым средним; вызов не сертифицирует компанию и не пересчитывает оценку.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеcompanyОбязательный- Домен сайта компании (например,
example.com) или полный URL Trustpilot/review/. Локализованные названия компаний не принимаются. Вprofileагрегирует профили компаний и рейтинги из связанных отзывов, аreviewsвозвращает отдельные записи отзывов.Trustpilot: TrustScore и отображаемый звёздный рейтинг — Trustpilot рассчитывает TrustScore как взвешенное среднее с учётом давности и частоты отзывов, а не как простое среднее арифметическое всех отзывов. Отображаемый звёздный рейтинг получается округлением TrustScore. · Проверено
Что означают параметры действия reviews в API Trustpilot?
Получите отзывы о компании на Trustpilot: оценку, уровень верификации, данные автора, дату опыта и ответ компании. Фильтруйте по готовому диапазону дат, языку, числу звёзд, сортировке или verified_only. Содержание отзывов не проверяется.
companyОбязательный- Домен сайта компании (например,
example.com) или полный URL Trustpilot/review/. Локализованные названия компаний не принимаются. Вprofileагрегирует профили компаний и рейтинги из связанных отзывов, аreviewsвозвращает отдельные записи отзывов. dateНеобязательный- Период публикации для действия
reviews:last7days,last30days,last3months,last6monthsилиlast12months(отсчёт назад на 7, 30, 92, 183 или 366 дней). Оставьте пустым, чтобы получить отзывы за любой период. Другие значения, включая конкретные даты, возвращают ошибку 422 до списания средств.Допустимые значения:last12monthslast30dayslast3monthslast6monthslast7days langНеобязательный- Язык отзывов в виде двухбуквенных кодов ISO 639-1: один код или массив (например,
enили["en","de"]); имеет приоритет надlanguage. Фильтрация отзывов вprofileможет влиять на то, возвращаются ли связанные данные компании. languageНеобязательный- Один двухбуквенный код языка ISO 639-1 (например,
en,fr,deилиes) для фильтрации отзывов в действииreviews. Без него возвращаются англоязычные отзывы, которые Trustpilot показывает по умолчанию. Если переданlang, он имеет приоритет над этим параметром. sortНеобязательный- Режим сортировки для действия
reviews:recencyилиnewest(по умолчанию; в обоих случаях сначала выводятся самые новые отзывы) либоrelevanceдля сортировки по релевантности. Другие значения возвращают ошибку 422 до списания средств.Допустимые значения:newestrecencyrelevance starsНеобязательный- Массив строк с числом звёзд (например,
["1","2"]) для фильтрации отзывов по оценке от 1 до 5. Если поле пустое, включаются все оценки; это не минимальный порог рейтинга.Trustpilot: среднее по отфильтрованной выборке — не официальный TrustScore — В документации Trustpilot сказано, что источник отзыва не влияет на его вес при расчёте TrustScore. Среднее значение, рассчитанное по отзывам с низкими оценками, по отдельным источникам или за узкий период, не является официальным TrustScore компании. · Проверено verified_onlyНеобязательный- Логический флаг (
trueилиfalse) для фильтрации по статусу проверенного отзыва. Отражает метку проверки отзывов Trustpilot и не означает проверку со стороны платформы EveryInfra.
Как использовать API Trustpilot
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"trustpilot","action":"profile","params":{"company":"<company>"}}'
Вопросы об API Trustpilot
Какие данные можно получить через API Trustpilot?
Укажите в platform значение trustpilot. В текущем каталоге: сведения и отзывы. Эти названия действий соответствуют разным объектам или представлениям Trustpilot; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса profile к платформе Trustpilot?
Домен сайта компании (например, example.com) или полный URL Trustpilot /review/. Локализованные названия компаний не принимаются. В profile агрегирует профили компаний и рейтинги из связанных отзывов, а reviews возвращает отдельные записи отзывов. Передайте это значение в поле company объекта params.
Какие поля может вернуть profile на платформе Trustpilot?
Объявленная схема включает name, domain, trust_score и rating. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Trustpilot возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.