Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Substack: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите рассылки Substack по ключевому слову: название, имя пользователя, собственный домен, язык, автор и топ-посты каждого издания. | $1.39 за 1 000 запросов | Норма |
Изданиеpublication | Найдите издание Substack по ссылке на главную страницу: название, имя пользователя, собственный домен, язык, автора, топ-посты и число подписчиков, если оно раскрыто. | $1.39 за 1 000 запросов | Норма |
Публикации изданияpublication_posts | Получите список постов издания Substack. | $1.39 за 1 000 запросов | Норма |
Сведения о постеpost | Получите один пост Substack по ссылке /p/: заголовок, подзаголовок, текст, автора, издание, показатели вовлечённости и признак платного контента. | $1.39 за 1 000 запросов | Норма |
Комментарииcomments | Получите комментарии к посту Substack: автор, лайки, число ответов и флаги для ответов, закреплённых комментариев и реплик автора поста. | $1.39 за 1 000 запросов | Норма |
Профилиprofile | Найдите профиль автора Substack по имени пользователя: отображаемое имя, описание, аватар, привязанное имя пользователя Twitter и связанные с аккаунтом издания. | $1.39 за 1 000 запросов | Норма |
Заметкиnotes | Соберите Notes автора Substack, короткие посты, которые хранятся отдельно от рассылок: текст, тип, лайки и время публикации каждого. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Substack?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите рассылки Substack по ключевому слову: название, имя пользователя, собственный домен, язык, автор и топ-посты каждого издания. Поиск идёт по изданиям, а не по тексту постов. Значение null в поле числа подписчиков означает, что оно скрыто, а не равно нулю. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publicationИздание Найдите издание Substack по ссылке на главную страницу: название, имя пользователя, собственный домен, язык, автора, топ-посты и число подписчиков, если оно раскрыто. В ссылке должно быть узнаваемое имя Substack, так как собственные домены могут не распознаться. Данные из панели автора не используются. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publication_postsПубликации издания Получите список постов издания Substack. У каждого поста есть заголовок, подзаголовок, автор, лайки, комментарии, число слов, время чтения и признак платного доступа. Сужайте выборку по формату через | url | content_type, since, until | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
postСведения о посте Получите один пост Substack по ссылке /p/: заголовок, подзаголовок, текст, автора, издание, показатели вовлечённости и признак платного контента. Текст за пейволом не открывается. Комментарии возвращает отдельное действие | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
commentsКомментарии Получите комментарии к посту Substack: автор, лайки, число ответов и флаги для ответов, закреплённых комментариев и реплик автора поста. Передайте ссылку /p/ на пост. Пакет может содержать не всё обсуждение. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · text · author_name · author_username · like_count · reply_count · reply_to_id · is_reply · is_pinned · is_author · posted_at · platform |
profileПрофили Найдите профиль автора Substack по имени пользователя: отображаемое имя, описание, аватар, привязанное имя пользователя Twitter и связанные с аккаунтом издания. Принимается простое имя, @имя или ссылка substack.com/@. Возвращаются данные о человеке, а не об издании, без данных о подписках. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | user_id · username · display_name · bio · avatar_url · twitter_username · platform · publications |
notesЗаметки Соберите Notes автора Substack, короткие посты, которые хранятся отдельно от рассылок: текст, тип, лайки и время публикации каждого. Возвращаются Notes только одного автора, поиска по всему сайту здесь нет, и полная история может быть недоступна. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=25, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · kind · text · author_username · author_name · like_count · posted_at · platform · restacked_post · attachment_urls |
Что означают параметры действия search в API Substack?
Находите рассылки Substack по ключевому слову: название, имя пользователя, собственный домен, язык, автор и топ-посты каждого издания. Поиск идёт по изданиям, а не по тексту постов. Значение null в поле числа подписчиков означает, что оно скрыто, а не равно нулю.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для поиска рассылок и изданий Substack. Полнотекстовый поиск по текстам постов не выполняется.Substack: профили, сайты изданий и данные панели управления разделены — Substack отдельно документирует публичные профили, сайты изданий и панель управления издателя. Поиск на этой странице находит только профили изданий; наличие в официальной панели функций управления читателями и статистики доходов не означает, что этот API может получать такую аналитику. · Проверено
Что означают параметры действия publication в API Substack?
Найдите издание Substack по ссылке на главную страницу: название, имя пользователя, собственный домен, язык, автора, топ-посты и число подписчиков, если оно раскрыто. В ссылке должно быть узнаваемое имя Substack, так как собственные домены могут не распознаться. Данные из панели автора не используются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на ресурс Substack. Для publication и publication_posts используйте главные страницы изданий, для post и comments прямые ссылки на посты /p/. Действию publication нужен URL с распознаваемым именем Substack (собственные домены могут не распознаться), а publication_posts принимает ссылки на собственных доменах напрямую.Substack: страницы авторов и сайты изданий являются разными объектами с разными адресами — В Substack имени пользователя автора соответствует адрес substack.com/@handle, а сайты изданий могут использовать адреса вида subdomain.substack.com. Этот источник подтверждает различия между объектами и адресами; возможность определять издание по собственному домену по-прежнему строго ограничена правилами параметров соответствующего действия на этой странице. · Проверено
Что означают параметры действия publication_posts в API Substack?
Получите список постов издания Substack. У каждого поста есть заголовок, подзаголовок, автор, лайки, комментарии, число слов, время чтения и признак платного доступа. Сужайте выборку по формату через content_type или по дате через since и until. Текст за пейволом остаётся закрытым, а один пакет может не охватывать весь архив.
urlОбязательный- Ссылка на ресурс Substack. Для publication и publication_posts используйте главные страницы изданий, для post и comments прямые ссылки на посты /p/. Действию publication нужен URL с распознаваемым именем Substack (собственные домены могут не распознаться), а publication_posts принимает ссылки на собственных доменах напрямую.
content_typeНеобязательный- Фильтрует посты издания по формату: all_types, newsletter_posts_only, podcast_episodes_only или threads_only. Для каждой конкретной ссылки на пост следует проверять наличие полей; этот параметр не открывает доступ к платному контенту.Допустимые значения:
all_typesnewsletter_posts_onlypodcast_episodes_onlythreads_onlySubstack: форматы статей, аудио и видео не определяют права доступа к контенту — Substack выделяет текстовые, аудио- и видеопубликации как отдельные форматы контента и строго разделяет публичные материалы и закрытые статьи. Параметр `content_type` на этой странице использует собственные допустимые значения: они не добавляют типы видео и не гарантируют, что фильтрация и получение данных проверены на каждом пути выполнения. · Проверено sinceНеобязательный- Начальная дата в виде строки для фильтрации постов или лент активности по диапазону дат. Наличие этого параметра среди общих параметров профиля или издания не включает фильтрацию по дате создания аккаунта.
untilНеобязательный- Конечная дата в виде строки для фильтрации постов или лент активности вместе с since. Параметр не обозначает дату окончания подписки и не запускает выгрузку полного исторического архива.
Что означают параметры действия post в API Substack?
Получите один пост Substack по ссылке /p/: заголовок, подзаголовок, текст, автора, издание, показатели вовлечённости и признак платного контента. Текст за пейволом не открывается. Комментарии возвращает отдельное действие comments.
urlОбязательный- Ссылка на ресурс Substack. Для publication и publication_posts используйте главные страницы изданий, для post и comments прямые ссылки на посты /p/. Действию publication нужен URL с распознаваемым именем Substack (собственные домены могут не распознаться), а publication_posts принимает ссылки на собственных доменах напрямую.Substack: бесплатный фрагмент не является полной статьёй за пейволом — Substack позволяет авторам настраивать бесплатные фрагменты и положение пейвола в платных статьях. Поэтому непустой текст не доказывает, что получен весь контент, а указание is_paid или фильтрация по платному контенту не дают доступа к чтению. · Проверено
Что означают параметры действия comments в API Substack?
Получите комментарии к посту Substack: автор, лайки, число ответов и флаги для ответов, закреплённых комментариев и реплик автора поста. Передайте ссылку /p/ на пост. Пакет может содержать не всё обсуждение.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на ресурс Substack. Для publication и publication_posts используйте главные страницы изданий, для post и comments прямые ссылки на посты /p/. Действию publication нужен URL с распознаваемым именем Substack (собственные домены могут не распознаться), а publication_posts принимает ссылки на собственных доменах напрямую.Substack: скрытый комментарий не равен удалённому — Правила ответов (Reply Rules) в Substack позволяют авторам скрывать комментарии к статьям или ответы в Notes вместо окончательного удаления. Отсутствие комментария в публичных результатах не доказывает, что он удалён, а этот API не предоставляет доступа к панелям модерации и не позволяет восстанавливать скрытый контент или менять правила. · Проверено
Что означают параметры действия profile в API Substack?
Найдите профиль автора Substack по имени пользователя: отображаемое имя, описание, аватар, привязанное имя пользователя Twitter и связанные с аккаунтом издания. Принимается простое имя, @имя или ссылка substack.com/@. Возвращаются данные о человеке, а не об издании, без данных о подписках.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя автора для profile или notes: имя (с необязательным префиксом @) или полная ссылка substack.com/@user. Действие notes возвращает короткие заметки автора, а не длинные посты издания.Substack: имена пользователей, отображаемые имена и публичные профили авторов — Уникальное имя пользователя Substack формирует URL профиля автора, а отображаемое имя и описание можно редактировать независимо от него. Поэтому на этой странице различаются username и display_name; возможность читать скрытые подписки или историю отметок «Нравится» не заявлена. · Проверено
Что означают параметры действия notes в API Substack?
Соберите Notes автора Substack, короткие посты, которые хранятся отдельно от рассылок: текст, тип, лайки и время публикации каждого. Возвращаются Notes только одного автора, поиска по всему сайту здесь нет, и полная история может быть недоступна.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя автора для profile или notes: имя (с необязательным префиксом @) или полная ссылка substack.com/@user. Действие notes возвращает короткие заметки автора, а не длинные посты издания.Substack: что такое Notes и Restack — Substack определяет Notes как формат коротких публикаций, а Restack — как распространение контента внутри Notes, и отличает их от рассылки отдельных статей. Официальные функции Substack для публикации и аналитики вовлечённости и доходов не означают, что этот эндпоинт чтения Notes поддерживает соответствующие операции или метрики. · Проверено
Как использовать API Substack
- 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":"substack","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Substack
Какие данные можно получить через API Substack?
Укажите в platform значение substack. В текущем каталоге: поиск, издание, публикации издания, сведения о посте, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям Substack; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Substack?
Поисковый запрос для поиска рассылок и изданий Substack. Полнотекстовый поиск по текстам постов не выполняется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Substack?
Объявленная схема включает handle, name, custom_domain и bio. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Substack возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.