Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Pinterest Посты пользователя

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Получите пины, опубликованные аккаунтом 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 время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаpinterestИдентификатор платформы, фиксированное значение.
actionbodystringДаuser_postsИдентификатор возможности, фиксированное значение.
usernamebody.paramsstringДа-Имя пользователя Pinterest для действий profile, user_posts и boards, с символом @ в начале или без него. Полные URL профилей не принимаются.
limitbody.paramsinteger (1–50)Нет20Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
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 меняются при каждом вызове, поэтому показана только их структура.

json
{
  "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