Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Patreon: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите авторов Patreon по keyword: слоган, категория, число патронов и постов, место в рейтинге и сколько дней существует каждая страница. | $24 за 1 000 запросов | Норма |
Обзорexplore | Просматривайте каталог авторов Patreon по category, например podcasts, music или top-1000: для каждого автора есть позиция, число патронов и постов и срок существования страницы в днях. | $1.39 за 1 000 запросов | Норма |
Сведенияprofile | Получите страницу автора Patreon по username: описание, уровни подписки, число патронов, модель оплаты — ежемесячно или за каждую публикацию, ссылки на соцсети и варианты подписки. | $1.39 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Соберите посты автора Patreon по короткому имени или ссылке /c/: заголовок, тип поста, время публикации, число лайков и комментариев и признак, открыт ли пост для всех. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Patreon?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите авторов Patreon по | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $24 за 1 000 запросов | name · vanity · url · tagline · patron_count · post_count · rank · category · days_running · published_at · avatar_url · platform |
exploreОбзор Просматривайте каталог авторов Patreon по | category | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | name · vanity · url · tagline · patron_count · post_count · rank · category · days_running · published_at · avatar_url · platform |
profileСведения Получите страницу автора Patreon по | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · name · vanity · url · creation_name · one_liner · summary · currency · patron_count · paid_member_count · post_count · pay_per · is_monthly · is_nsfw · offers_free_membership · offers_paid_membership · published_at · pledge_url · avatar_url · cover_url · main_video_url · platform · tiers · tier_count · socials |
user_postsПосты пользователя Соберите посты автора Patreon по короткому имени или ссылке /c/: заголовок, тип поста, время публикации, число лайков и комментариев и признак, открыт ли пост для всех. Посты только для патронов остаются закрытыми, а вложения с ограниченным доступом не передаются. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · text · url · post_type · like_count · comment_count · is_public · author_vanity · thumbnail_url · posted_at · platform |
Что означают параметры действия search в API Patreon?
Ищите авторов Patreon по keyword: слоган, категория, число патронов и постов, место в рейтинге и сколько дней существует каждая страница. Поиск идёт по страницам авторов, а не по тексту постов; доходы, личности участников и платный контент остаются скрытыми.
keywordОбязательный- Поисковый запрос по авторам для действия search. Поиск идёт по страницам профилей авторов, а не по полному тексту платных постов.Patreon: поиск аккаунтов по имени автора или теме — Patreon позволяет находить авторов по имени или теме, а встроенный раздел Explore включает персональные рекомендации. Этот эндпоинт выполняет поиск авторов и не возвращает историю персональных рекомендаций или результаты полнотекстового поиска по платным публикациям. · Проверено
Что означают параметры действия explore в API Patreon?
Просматривайте каталог авторов Patreon по category, например podcasts, music или top-1000: для каждого автора есть позиция, число патронов и постов и срок существования страницы в днях. Значения категории должны точно совпадать с допустимым списком, а порядок не является ни рекомендацией, ни стабильным рейтингом.
categoryОбязательный- Категория каталога авторов для действия explore. Принимаются только точные допустимые значения, например 3d-printing, crafts-diy, drawing-painting, dance-theater, magazine, top-1000, video, а также категории с префиксом adult. Параметр category в действиях profile, user_posts и search не включает фильтрацию по категории.Допустимые значения:
3d-printingadult-3d-printingadult-animationadult-comicsadult-cosplayadult-crafts-diyadult-dance-theateradult-drawing-paintingadult-gamesadult-magazineadult-musicadult-otheradult-photographyadult-podcastsadult-videoadult-writinganimalsanimationcomicscosplaycrafts-diydance-theaterdrawing-paintingfinancegamesmagazinemastodonmusicotherphotographypodcaststop-1000videowritingPatreon: поиск по категориям отделён от персональных рекомендаций и возрастных настроек — Страница поиска Patreon учитывает темы, членство и прошлую активность и применяет требования к возрасту и доступу для авторов контента только для взрослых и для пользователей от 18 лет. Значения категорий этого эндпоинта не совпадают с полным встроенным списком категорий Patreon или персональными рекомендациями и не позволяют обходить ограничения по возрасту или контенту. · Проверено
Что означают параметры действия profile в API Patreon?
Получите страницу автора Patreon по username: описание, уровни подписки, число патронов, модель оплаты — ежемесячно или за каждую публикацию, ссылки на соцсети и варианты подписки. paid_member_count равен null, если автор скрывает это число; это не ноль. Доход не оценивается, уровни с ограниченным доступом остаются закрытыми.
usernameОбязательный- Короткое имя (vanity slug) автора для действий profile и user_posts. Принимает @slug, имя без префикса или URL Patreon, содержащий /c/slug. Возвращает только публичную информацию профиля автора, структуру уровней подписки и публичные посты и не предоставляет доступа к контенту, предназначенному только для подписчиков.Patreon: текущее число участников не показывает выручку по обработанным платежам — Patreon рассматривает данные о числе участников и сводные данные о доходах как показатели на конкретный момент времени, а обработанную выручку отражает в отдельных отчётах. Публично доступные paid_member_count, расчётные единицы и валюты не содержат сведений о транзакциях; их нельзя напрямую перемножить, чтобы рассчитать фактический доход или суммы выплат. · Проверено
Что означают параметры действия user_posts в API Patreon?
Соберите посты автора Patreon по короткому имени или ссылке /c/: заголовок, тип поста, время публикации, число лайков и комментариев и признак, открыт ли пост для всех. Посты только для патронов остаются закрытыми, а вложения с ограниченным доступом не передаются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Короткое имя (vanity slug) автора для действий profile и user_posts. Принимает @slug, имя без префикса или URL Patreon, содержащий /c/slug. Возвращает только публичную информацию профиля автора, структуру уровней подписки и публичные посты и не предоставляет доступа к контенту, предназначенному только для подписчиков.Patreon: публичный доступ, доступ для участников и права доступа для конкретных уровней подписки — Patreon разделяет доступ к публикациям на публичный, доступ для участников и доступ для выбранных платных уровней подписки; некоторые публикации также можно приобрести отдельно. Этот эндпоинт получает общедоступные превью и не предоставляет прав доступа. Наличие поля is_public также не позволяет покупать контент, менять уровень подписки или открывать доступ к нему. · Проверено
Как использовать API Patreon
- 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":"patreon","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Patreon
Какие данные можно получить через API Patreon?
Укажите в platform значение patreon. В текущем каталоге: поиск, обзор, сведения и посты пользователя. Эти названия действий соответствуют разным объектам или представлениям Patreon; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Patreon?
Поисковый запрос по авторам для действия search. Поиск идёт по страницам профилей авторов, а не по полному тексту платных постов. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Patreon?
Объявленная схема включает name, vanity, tagline и patron_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Patreon возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.