Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Medium: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Тегtag | Получайте статьи Medium по слагу тематического тега в tag, например machine-learning. | $1.39 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Собирайте статьи, опубликованные одним автором Medium, указанным как имя пользователя или URL профиля в username. | $1.39 за 1 000 запросов | Норма |
Изданиеpublication | Просматривайте статьи издания Medium, указанного как слаг или URL в publication. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Medium?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
tagТег Получайте статьи Medium по слагу тематического тега в | tag | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=25. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
user_postsПосты пользователя Собирайте статьи, опубликованные одним автором Medium, указанным как имя пользователя или URL профиля в | username | url | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=25. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
publicationИздание Просматривайте статьи издания Medium, указанного как слаг или URL в | publication | url | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=25. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
Что означают параметры действия tag в API Medium?
Получайте статьи Medium по слагу тематического тега в tag, например machine-learning. В ответе есть автор, издание, время чтения, число лайков и комментариев и флаг «только для участников». Это не полнотекстовый поиск, и он не обходит пейвол. Возможно, возвращаются не все статьи с этим тегом.
tagОбязательный- Слаг тега темы Medium (например, machine-learning): символы # в начале удаляются, текст приводится к нижнему регистру, пробелы заменяются дефисами. Произвольный полнотекстовый поиск не выполняется.Medium: ленты по темам и границы статей за пейволом — Официальная документация Medium отдельно приводит URL лент для авторов, изданий и тем (Topics) и прямо указывает, что полные тексты статей за пейволом не включаются в RSS-ленты. Этот источник поясняет различия между типами объектов и границы видимого контента, но не означает поддержки произвольного полнотекстового поиска или получения полных текстов за пейволом. · Проверено
Что означают параметры действия user_posts в API Medium?
Собирайте статьи, опубликованные одним автором Medium, указанным как имя пользователя или URL профиля в username. Получайте заголовок, отрывок, издание, время чтения и число лайков и комментариев. Черновики исключаются, полный архив не гарантируется. Статьи только для участников отмечаются, но не открываются.
usernameОбязательный- Имя автора Medium или полный URL профиля автора; отдельное имя преобразуется в https://medium.com/@<handle>. Возвращает список опубликованных постов автора, а не метаданные профиля.Medium: хлопки не отражают число уникальных читателей — На Medium один читатель может поставить одной статье несколько хлопков, поэтому общее число хлопков нельзя считать числом уникальных читателей. Этот API не предоставляет доступную автору разбивку хлопков по отдельным читателям, а наличие поля не гарантирует, что число хлопков будет возвращаться всегда. · Проверено
urlНеобязательный- Параметр совместимости для полных URL автора или издания в user_posts и publication; обязательные параметры username или publication всё равно нужно передавать. Возвращаемые списки постов могут включать посты с ограниченным доступом, но полный текст за пейволом при этом не открывается.
Что означают параметры действия publication в API Medium?
Просматривайте статьи издания Medium, указанного как слаг или URL в publication. У каждой статьи есть автор, время чтения, число лайков и комментариев и флаг «только для участников». Названия статей и имена пользователей авторов не принимаются как входные данные. Текст материалов только для участников остаётся закрытым.
publicationОбязательный- Слаг издания Medium или полный URL издания, а не заголовок статьи или имя автора. Отдельный слаг преобразуется в medium.com/<publication>.Medium: у изданий и страниц авторов разные ленты — Medium разделяет издания (Publications) и страницы авторов @username и задаёт отдельные форматы лент для изданий на собственных доменах. Этот источник показывает различия объектов; входные данные этого API по-прежнему задаются параметром, описанным выше, передавать URL лент не нужно, а проверка всех собственных доменов не гарантируется. · Проверено
urlНеобязательный- Параметр совместимости для полных URL автора или издания в user_posts и publication; обязательные параметры username или publication всё равно нужно передавать. Возвращаемые списки постов могут включать посты с ограниченным доступом, но полный текст за пейволом при этом не открывается.
Как использовать API Medium
- 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":"medium","action":"tag","params":{"tag":"<tag>"}}'
Вопросы об API Medium
Какие данные можно получить через API Medium?
Укажите в platform значение medium. В текущем каталоге: тег, посты пользователя и издание. Эти названия действий соответствуют разным объектам или представлениям Medium; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса tag к платформе Medium?
Слаг тега темы Medium (например, machine-learning): символы # в начале удаляются, текст приводится к нижнему регистру, пробелы заменяются дефисами. Произвольный полнотекстовый поиск не выполняется. Передайте это значение в поле tag объекта params.
Какие поля может вернуть tag на платформе Medium?
Объявленная схема включает title, text, author_name и author_username. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Medium возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.