API Pinterest Посты пользователя
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите пины, опубликованные аккаунтом Pinterest. Изображения, видео и внешние ссылки представлены раздельно; для каждого пина также указаны число репинов, реакций и комментариев и его доска. Полнота охвата всех досок и старых пинов не гарантируется.
Pinterest Posts by user выводит пины, опубликованные одним аккаунтом, по его username и возвращает для каждого пина название и описание, изображение или видео, внешнюю ссылку и домен источника, доску, на которой он находится, в board_name, число репинов, реакций и комментариев, доминирующий цвет и время публикации. Так видно, что аккаунт публикует в Pinterest и какие пины расходятся. Это нужно SMM-командам для сравнения с аккаунтами конкурентов, брендам, проверяющим, какие из их пинов сохраняют, и аналитикам, изучающим, как авторы распределяют контент по доскам.
username принимает короткое имя аккаунта, с ведущим @ или без него. Полный URL профиля не разбирается, поэтому сначала извлеките имя из ссылки. Группировка записей по board_name показывает, как аккаунт распределяет контент, а сопоставление repin_count с posted_at отделяет недавние хиты от старых пинов, которые набирали сохранения постепенно. Null в счётчиках комментариев или репостов означает, что значение не раскрыто, а не что оно равно нулю.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Pinterest Посты пользователя (pinterest/user_posts).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: pinterest и action: user_posts, а параметры передайте в params.
- Обязательные параметры:
- username: Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются.
- Необязательные параметры:
- limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, title, text, image_url, video_url, media_type, external_link, source_domain, reaction_count, repin_count, comment_count; всего полей: 20, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=pinterest.
- Пример тела запроса:
{
"platform": "pinterest",
"action": "user_posts",
"params": {
"username": "pinterest"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | pinterest | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | user_posts | Идентификатор возможности, фиксированное значение. |
username | body.params | string | Да | - | Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются. |
limit | body.params | integer (1–50) | Нет | 20 | Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "pinterest",
"action": "user_posts",
"params": {
"username": "pinterest"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "pinterest",
"action": "user_posts",
"results": [
{
"id": "•••",
"url": "https://www.pinterest.com/pin/424605071145987859/",
"title": "Eco Car Plate with Non-Slip Tires | Childrens Dishes, Kids Lunch Boxes, Kids Cooking Gifts",
"text": "Mealtime with kids can be a bumpy road, but with this car-shaped plate, it's smooth cruising to the finish line. The recyclable and dishwashable racer's removable compartments and nonslip tires keep diners on track with no messy detours (i.e., the floor). Car crafted from a biode…",
"image_url": "https://i.pinimg.com/originals/12/c1/a6/12c1a6752b29579d0d7aa3e82c8af64b.jpg",
"media_type": "image",
"external_link": "https://www.uncommongoods.com/product/eco-car-plate-with-non-slip-tires?utm_source=pinterest&utm_medium=paid&social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
"source_domain": "uncommongoods.com",
"reaction_count": 56,
"repin_count": 868,
"dominant_color": "#f3eee3",
"alt_text": "two plastic cars with food in them on a white surface next to cups and strawberries",
"posted_at": "2026-09-26T09:43:33+00:00",
"author_username": "pinterest",
"author_name": "Pinterest",
"board_name": "Gifts that embrace the art of play",
"platform": "pinterest"
},
{
"id": "•••",
"url": "https://www.pinterest.com/pin/424605071145987856/",
"title": "Healthy Harvest Natural Dining Sets | Cool & Unique Baby Gifts",
"text": "Parents worry about everything they feed to their growing bundles of joy, but what about the plastic plates and utensils they eat off of? Here's a charming answer all-natural wooden dinnerware that’s completely free of any plastics, BPAs, or petroleum-based components. Giving a s…",
"image_url": "https://i.pinimg.com/originals/cc/26/7d/cc267d3a3fca4beb87080cfc07c5e229.jpg",
"media_type": "image",
"external_link": "https://www.uncommongoods.com/product/healthy-harvest-natural-dining-sets?utm_source=pinterest&utm_medium=paid%20social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
"source_domain": "uncommongoods.com",
"reaction_count": 155,
"repin_count": 1904,
"dominant_color": "#f3eadc",
"alt_text": "three plastic fruits and vegetables are shown on a white surface with spoons, plates, and utensils",
"posted_at": "2026-09-26T09:40:55+00:00",
"author_username": "pinterest",
"author_name": "Pinterest",
"board_name": "Gifts that embrace the art of play",
"platform": "pinterest"
}
],
"count": 20,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
title | Заголовок. null, если на платформе нет заголовков (например, у текстовых постов). |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
video_url | Трактуется так же, как на самой платформе |
media_type | Трактуется так же, как на самой платформе |
external_link | Трактуется так же, как на самой платформе |
source_domain | Трактуется так же, как на самой платформе |
reaction_count | Трактуется так же, как на самой платформе |
repin_count | Трактуется так же, как на самой платформе |
comment_count | Комментарии. null означает, что значение не раскрыто, а не 0. |
share_count | Количество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0. |
dominant_color | Трактуется так же, как на самой платформе |
alt_text | Трактуется так же, как на самой платформе |
posted_at | Время публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает. |
author_username | Имя пользователя автора (@handle), обычно подходит для URL. |
author_name | Отображаемое имя автора. |
board_name | Трактуется так же, как на самой платформе |
price | Цена числом без символа валюты; см. currency. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
В каком формате указывать username?
Короткое имя аккаунта, например pinterest, из адреса профиля вида pinterest.com/pinterest/. Ведущий @ допустим, но Pinterest Posts by user не разбирает полный URL профиля, поэтому оставьте только имя. То же короткое имя подходит для возможностей Pinterest Details и Pinterest Boards.
Как найти пины аккаунта, которые сохраняют чаще всего?
Отсортируйте записи по repin_count, числу повторных сохранений каждого пина. Это основная мера распространения в Pinterest. Смотрите рядом reaction_count и comment_count, чтобы понять, какие пины ещё и вызывают отклик, и учитывайте posted_at, поскольку у старых пинов было больше времени набрать сохранения.
Чем Posts by user отличается от Pins on a board?
Pinterest Posts by user принимает аккаунт и возвращает опубликованные им пины, а board_name показывает, на какой доске находится каждый из них. Pinterest Pins on a board принимает одну доску, заданную путём username/board-name, и возвращает её содержимое. Первую возможность используйте для анализа аккаунта, а вторую — для изучения отдельной подборки.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- Pinterest: сохранённые пины не обязательно являются оригинальным контентом аккаунта ↗
В официальной документации сказано, что пины с изображениями можно создать, загрузив изображение или сохранив изображение с внешнего сайта; при сохранении с внешнего сайта остаётся ссылка на исходный сайт. Пины, связанные с аккаунтом, нельзя напрямую считать оригинальными работами, а проверка источника не заменяет прав на использование контента.
Проверено 2026-09-04