Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Tumblr: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите посты Tumblr по ключевому слову: текст, тип поста, теги, число заметок и блог, опубликовавший каждый пост. | $36 за 1 000 запросов | Норма |
Тегtag | Просматривайте посты с определённым тегом Tumblr: текст, тип поста, теги, число заметок и данные блога. | $12.79 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите посты одного блога Tumblr: текст, тип поста, теги, число заметок и время публикации. | $12.79 за 1 000 запросов | Норма |
Профилиprofile | Получите название, описание, адрес блога Tumblr и дату его последнего поста. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Tumblr?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите посты Tumblr по ключевому слову: текст, тип поста, теги, число заметок и блог, опубликовавший каждый пост. Выбирайте один | keyword | post_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $36 за 1 000 запросов | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
tagТег Просматривайте посты с определённым тегом Tumblr: текст, тип поста, теги, число заметок и данные блога. Заметки объединяют лайки и реблоги в одно число, а тег не доказывает, о чём пост на самом деле. | tag | hashtag, post_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $12.79 за 1 000 запросов | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
user_postsПосты пользователя Получите посты одного блога Tumblr: текст, тип поста, теги, число заметок и время публикации. Укажите короткое имя блога или name.tumblr.com, а не ссылку https. Один пакет может не охватывать весь архив. | username | post_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $12.79 за 1 000 запросов | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
profileПрофили Получите название, описание, адрес блога Tumblr и дату его последнего поста. Передайте короткое имя или name.tumblr.com. Сообщения, черновики и защищённые блоги недоступны. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | username · display_name · bio · url · latest_post_at · platform |
Что означают параметры действия search в API Tumblr?
Ищите посты Tumblr по ключевому слову: текст, тип поста, теги, число заметок и блог, опубликовавший каждый пост. Выбирайте один post_type за раз. Закрытые блоги исключаются, получение всех совпадений не гарантируется.
keywordОбязательный- Поисковый запрос по публичным постам для
search. Параметр keyword для совместимости в действииtagна самом деле ищет по тегу, поэтому его нельзя считать тем же способом поиска.Tumblr: чем поиск по ключевым словам отличается от страниц тегов — Официальная документация разделяет страницы поиска и страницы тегов: страницы поиска находят контент по словам, а страницы тегов собирают посты с определённым тегом. Рекомендации блогов, варианты сортировки и операторы поиска на веб-страницах Tumblr не становятся автоматически поддерживаемыми или проверенными параметрами этого эндпоинта. · Проверено post_typeНеобязательный- Один тип поста для
search,tagилиuser_posts:anyбез ограничений,text,photo,video,quote,linkилиaudio. Это не массив;profileэтот фильтр не использует.Tumblr: notes в постах любого типа — это не отдельный счётчик лайков — Официальная документация Tumblr определяет notes как общую сумму лайков, реблогов и комментариев к посту. Смена типа поста не разделяет note_count в этом эндпоинте на три отдельные метрики, а общее число взаимодействий нельзя трактовать как число уникальных пользователей. · Проверено
Что означают параметры действия tag в API Tumblr?
Просматривайте посты с определённым тегом Tumblr: текст, тип поста, теги, число заметок и данные блога. Заметки объединяют лайки и реблоги в одно число, а тег не доказывает, о чём пост на самом деле.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеtagОбязательный- Название темы для
tag, можно с префиксом #. Возвращает публичный контент по тегу.Tumblr: поиск по тегам и полнотекстовый поиск по ключевым словам — разные вещи — В официальной документации объясняется, что страницы тегов объединяют посты с конкретным добавленным тегом, а страницы поиска показывают результаты по поисковым запросам. Эта запись уточняет, какие данные охватывает поиск по тегам, и не гарантирует индексации в реальном времени, полноты результатов или поддержки всех вариантов фильтрации, доступных в веб-интерфейсе. · Проверено hashtagНеобязательный- Альтернативный параметр для
tagс более низким приоритетом, чем уtag. post_typeНеобязательный- Один тип поста для
search,tagилиuser_posts:anyбез ограничений,text,photo,video,quote,linkилиaudio. Это не массив;profileэтот фильтр не использует.
Что означают параметры действия user_posts в API Tumblr?
Получите посты одного блога Tumblr: текст, тип поста, теги, число заметок и время публикации. Укажите короткое имя блога или name.tumblr.com, а не ссылку https. Один пакет может не охватывать весь архив.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Короткое имя блога или домен name.tumblr.com. Не передавайте в это поле полную ссылку с https://, полные адреса указывайте в
url.profileвозвращает только сводные публичные данные блога.Tumblr: реблоги и указание оригинального автора в блогах — В официальной документации отмечено, что реблог размещает существующий пост в другом блоге и позволяет добавить к нему контент; реблоги с добавленным контентом могут появляться в общем поиске, но не в поиске по тегам. Этот эндпоинт не возвращает полную цепочку реблогов и не может определить оригинального автора только по текущему блогу. · Проверено post_typeНеобязательный- Один тип поста для
search,tagилиuser_posts:anyбез ограничений,text,photo,video,quote,linkилиaudio. Это не массив;profileэтот фильтр не использует.
Что означают параметры действия profile в API Tumblr?
Получите название, описание, адрес блога Tumblr и дату его последнего поста. Передайте короткое имя или name.tumblr.com. Сообщения, черновики и защищённые блоги недоступны.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Короткое имя блога или домен name.tumblr.com. Не передавайте в это поле полную ссылку с https://, полные адреса указывайте в
url.profileвозвращает только сводные публичные данные блога.Tumblr: основные, дополнительные и групповые блоги — В официальной документации сказано, что у аккаунта может быть основной блог и дополнительные блоги, которые можно защитить паролем или вести совместно с другими пользователями. Поэтому имя блога не является уникальным идентификатором человека, а данные на этой странице не дают доступа к защищённому паролем контенту и не позволяют определить связи между аккаунтами. · Проверено
Как использовать API Tumblr
- 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":"tumblr","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Tumblr
Какие данные можно получить через API Tumblr?
Укажите в platform значение tumblr. В текущем каталоге: поиск, тег, посты пользователя и профили. Эти названия действий соответствуют разным объектам или представлениям Tumblr; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Tumblr?
Поисковый запрос по публичным постам для search. Параметр keyword для совместимости в действии tag на самом деле ищет по тегу, поэтому его нельзя считать тем же способом поиска. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Tumblr?
Объявленная схема включает text, post_type, author_username и author_name. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Tumblr возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.