Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Pinterest: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите пины Pinterest по ключевому слову среди всех пинов или только среди видеопинов: изображение, домен источника, преобладающий цвет, реакции, доска и данные автора пина. | $1.39 за 1 000 запросов | Норма |
Профилиprofile | Найдите аккаунт Pinterest по имени пользователя (с @ или без): описание профиля, сайт, верификацию, флаг приватности и число подписчиков, пинов, досок и видео. | $1.39 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите пины, опубликованные аккаунтом Pinterest. | $1.39 за 1 000 запросов | Норма |
Сведения о пинеpin | Получите один пин Pinterest по ссылке /pin/ с числовым ID: медиа, внешнюю ссылку и домен, alt-текст, преобладающий цвет, доску и показатели вовлечённости. | $1.39 за 1 000 запросов | Норма |
Доскиboards | Получите список досок, принадлежащих аккаунту Pinterest: описание, обложку, число пинов и разделов, подписчиков, настройку приватности и флаг совместной доски. | $1.39 за 1 000 запросов | Норма |
Пины на доскеboard_pins | Просмотрите пины, сохранённые на одной доске Pinterest, по board_id, например pinterest/official-news. | $1.39 за 1 000 запросов | Норма |
Сведения о доскеboard_detail | Получите данные доски Pinterest по её url: владельца, описание, обложку, приватность, флаг совместной доски и число пинов, разделов и подписчиков. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Pinterest?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите пины Pinterest по ключевому слову среди всех пинов или только среди видеопинов: изображение, домен источника, преобладающий цвет, реакции, доска и данные автора пина. Доски и авторы не возвращаются; пин не предоставляет прав на изображение и не подтверждает надёжность сайта по ссылке. | keyword | content_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform |
profileПрофили Найдите аккаунт Pinterest по имени пользователя (с @ или без): описание профиля, сайт, верификацию, флаг приватности и число подписчиков, пинов, досок и видео. URL профиля не принимаются, а указанный сайт не подтверждает владение доменом и не раскрывает секретные доски. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform |
user_postsПосты пользователя Получите пины, опубликованные аккаунтом Pinterest. Изображения, видео и внешние ссылки представлены раздельно; для каждого пина также указаны число репинов, реакций и комментариев и его доска. Полнота охвата всех досок и старых пинов не гарантируется. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
pinСведения о пине Получите один пин Pinterest по ссылке /pin/ с числовым ID: медиа, внешнюю ссылку и домен, alt-текст, преобладающий цвет, доску и показатели вовлечённости. Ссылки на доски здесь не принимаются. Внешний сайт не сканируется, и права на его контент не предоставляются. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
boardsДоски Получите список досок, принадлежащих аккаунту Pinterest: описание, обложку, число пинов и разделов, подписчиков, настройку приватности и флаг совместной доски. По совместной доске нельзя получить полный список участников или какой-либо закрытый контент. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
board_pinsПины на доске Просмотрите пины, сохранённые на одной доске Pinterest, по | board_id | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
board_detailСведения о доске Получите данные доски Pinterest по её | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
Что означают параметры действия search в API Pinterest?
Ищите пины Pinterest по ключевому слову среди всех пинов или только среди видеопинов: изображение, домен источника, преобладающий цвет, реакции, доска и данные автора пина. Доски и авторы не возвращаются; пин не предоставляет прав на изображение и не подтверждает надёжность сайта по ссылке.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковые запросы или темы для вдохновения в действии search. Структура возвращаемых сущностей зависит от выбранного content_type.
content_typeНеобязательный- Фильтрует результаты поиска по типу пина: all_pins_visual_posts для всех пинов (не только с изображениями) или videos_video_pins только для видеопинов. Поиск возвращает только пины, без досок и авторов.Допустимые значения:
all_pins_visual_postsvideos_video_pinsPinterest: пины с изображениями, видеопины и товарные пины — Pinterest определяет пины как визуальные закладки и выделяет форматы с изображениями, видео и товарами. Это поясняет объекты контента и не означает, что поиск возвращает все официальные объекты или медиаполя; конфликты типов поиска на этой странице по-прежнему подчиняются ограничениям, описанным выше. · Проверено
Что означают параметры действия profile в API Pinterest?
Найдите аккаунт Pinterest по имени пользователя (с @ или без): описание профиля, сайт, верификацию, флаг приватности и число подписчиков, пинов, досок и видео. URL профиля не принимаются, а указанный сайт не подтверждает владение доменом и не раскрывает секретные доски.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются.
Что означают параметры действия user_posts в API Pinterest?
Получите пины, опубликованные аккаунтом Pinterest. Изображения, видео и внешние ссылки представлены раздельно; для каждого пина также указаны число репинов, реакций и комментариев и его доска. Полнота охвата всех досок и старых пинов не гарантируется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются.Pinterest: сохранённые пины не обязательно являются оригинальным контентом аккаунта — В официальной документации сказано, что пины с изображениями можно создать, загрузив изображение или сохранив изображение с внешнего сайта; при сохранении с внешнего сайта остаётся ссылка на исходный сайт. Пины, связанные с аккаунтом, нельзя напрямую считать оригинальными работами, а проверка источника не заменяет прав на использование контента. · Проверено
Что означают параметры действия pin в API Pinterest?
Получите один пин Pinterest по ссылке /pin/ с числовым ID: медиа, внешнюю ссылку и домен, alt-текст, преобладающий цвет, доску и показатели вовлечённости. Ссылки на доски здесь не принимаются. Внешний сайт не сканируется, и права на его контент не предоставляются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Целевой URL для запросов к Pinterest. Действию pin нужен URL пина, содержащий /pin/NUMERIC_ID/, а действию board_detail нужна ссылка на доску в формате /username/boardname/ (или её относительный путь). URL доски нельзя использовать вместо URL пина.Pinterest: ссылки на магазины в товарных пинах — В официальной документации сказано, что товарные пины могут вести на сайты магазинов, а некоторые расширенные пины (Rich Pins) синхронизируют сведения о товаре. Эта страница возвращает только фактически полученные поля пина и не гарантирует актуальные данные о наличии, возможность оформить заказ или данные о транзакциях. · Проверено
Что означают параметры действия boards в API Pinterest?
Получите список досок, принадлежащих аккаунту Pinterest: описание, обложку, число пинов и разделов, подписчиков, настройку приватности и флаг совместной доски. По совместной доске нельзя получить полный список участников или какой-либо закрытый контент.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются.Pinterest: иерархия досок и разделов досок — Pinterest использует разделы, чтобы упорядочивать пины внутри доски. Поэтому `section_count` не следует считать числом досок; ссылка на инструкции по созданию разделов не означает, что этот эндпоинт может создавать, перемещать или редактировать контент. · Проверено
Что означают параметры действия board_pins в API Pinterest?
Просмотрите пины, сохранённые на одной доске Pinterest, по board_id, например pinterest/official-news. У каждого пина есть медиа, внешняя ссылка, автор и показатели вовлечённости. Закрытые разделы исключаются, полнота доски не гарантируется.
board_idОбязательный- Идентификатор доски для board_pins: часть URL доски вида username/board-name после pinterest.com/, например pinterest/official-news. У каждой доски в результатах boards есть url; уберите из него домен, чтобы получить это значение.Pinterest: как упорядочивать пины по доскам, не путая доски с разделами — В официальной документации сказано, что пины можно помещать в разделы внутри доски. `board_id` здесь по-прежнему указывает только на доску; официальные инструкции не дают этому эндпоинту возможности преобразовывать ID и не означают, что доступны параметры запроса по разделам. · Проверено
Что означают параметры действия board_detail в API Pinterest?
Получите данные доски Pinterest по её url: владельца, описание, обложку, приватность, флаг совместной доски и число пинов, разделов и подписчиков. Сами пины не включаются, их возвращает board_pins.
urlОбязательный- Целевой URL для запросов к Pinterest. Действию pin нужен URL пина, содержащий /pin/NUMERIC_ID/, а действию board_detail нужна ссылка на доску в формате /username/boardname/ (или её относительный путь). URL доски нельзя использовать вместо URL пина.Pinterest: правила видимости секретных досок — В официальной документации указано, что секретные доски видят только владелец и приглашённые соавторы. Знание ссылки или ID доски не даёт права доступа, и эта страница не позволяет обходить настройки секретности. · Проверено
Как использовать API Pinterest
- 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":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Pinterest
Какие данные можно получить через API Pinterest?
Укажите в platform значение pinterest. В текущем каталоге: поиск, профили, посты пользователя, сведения о пине, доски и more. Эти названия действий соответствуют разным объектам или представлениям Pinterest; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Pinterest?
Поисковые запросы или темы для вдохновения в действии search. Структура возвращаемых сущностей зависит от выбранного content_type. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Pinterest?
Объявленная схема включает title, text, image_url и reaction_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Pinterest возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.