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

API Pinterest Сведения о пине

POST

Состояние API

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

Получите один пин Pinterest по ссылке /pin/ с числовым ID: медиа, внешнюю ссылку и домен, alt-текст, преобладающий цвет, доску и показатели вовлечённости. Ссылки на доски здесь не принимаются. Внешний сайт не сканируется, и права на его контент не предоставляются.

Pinterest Pin details получает один пин по ссылке и возвращает его название и описание, изображение или видео, внешнюю ссылку в external_link и её домен в source_domain, число сохранений (репинов), реакций, комментариев и репостов, alt_text и dominant_color изображения, доску, на которую он сохранён, автора и время публикации. Возможность показывает, как устроен отдельный пин и насколько широко он разошёлся. Она пригодится маркетологам, которые проверяют свои пины или пины конкурентов, продавцам, которые смотрят, на какие сайты пины приводят людей, и аналитикам, которые дополняют данные по ссылкам на пины, собранным в другом месте.

Передайте ссылку, в которой после /pin/ указан числовой ID пина, например https://www.pinterest.com/pin/140806234732511/; ссылка на доску здесь не подойдёт. Сначала смотрите на repin_count, поскольку на Pinterest пины распространяются именно через сохранения. dominant_color содержит шестнадцатеричное значение, которое можно сразу использовать для анализа изображений, а null в comment_count или share_count означает, что значение не раскрыто, а не равно нулю.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Pinterest Сведения о пине (pinterest/pin).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: pinterest и action: pin, а параметры передайте в params.
- Обязательные параметры:
  - url: Целевой URL для запросов к Pinterest. Действию pin нужен URL пина, содержащий /pin/NUMERIC_ID/, а действию board_detail нужна ссылка на доску в формате /username/boardname/ (или её относительный путь).
- Возвращает один объект. Основные поля: 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": "pin",
  "params": {
    "url": "https://www.pinterest.com/pin/140806234732511/"
  }
}
- Цена: $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ДаpinИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Целевой URL для запросов к Pinterest. Действию pin нужен URL пина, содержащий /pin/NUMERIC_ID/, а действию board_detail нужна ссылка на доску в формате /username/boardname/ (или её относительный путь). URL доски нельзя использовать вместо URL пина.

Примеры кода

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": "pin",
  "params": {
    "url": "https://www.pinterest.com/pin/140806234732511/"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "pinterest",
  "action": "pin",
  "results": {
    "id": "140806234732511",
    "url": "https://www.pinterest.com/pin/140806234732511/",
    "title": "",
    "text": " ",
    "image_url": "https://i.pinimg.com/originals/ea/82/df/ea82df375393b9980685116e440c1dc5.jpg",
    "media_type": "image",
    "source_domain": "Uploaded by user",
    "reaction_count": 484,
    "repin_count": 3170,
    "comment_count": 0,
    "share_count": 374,
    "dominant_color": "#5f4832",
    "posted_at": "2025-12-31T15:05:40+00:00",
    "author_username": "•••",
    "author_name": "•••",
    "board_name": "Bougie Morning",
    "platform": "pinterest"
  },
  "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

Какую ссылку передавать в url?

Ссылку на пин, путь которой содержит /pin/ и числовой ID пина, например https://www.pinterest.com/pin/140806234732511/. Ссылки на доски вида /username/board-name/ не являются пинами и не подходят для Pin details; получайте такие данные через возможность Pinterest Board details, которая принимает ссылку на доску или её относительный путь.

Что измеряет repin_count?

Сколько раз пин сохранили повторно, то есть сделали репин. Это основной показатель распространения контента на Pinterest. Смотрите на него вместе с reaction_count и comment_count: пин с большим числом репинов и малым числом комментариев сохраняют на потом, а не обсуждают.

Куда ведёт пин тех, кто на него нажимает?

external_link содержит внешний адрес, на который указывает пин, а source_domain — домен источника контента. Группировка пинов по source_domain показывает, на какие сайты они приводят пользователей, независимо от того, отслеживаете ли вы присутствие на Pinterest собственного сайта или сайта конкурента.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Pinterest: ссылки на магазины в товарных пинах ↗

    В официальной документации сказано, что товарные пины могут вести на сайты магазинов, а некоторые расширенные пины (Rich Pins) синхронизируют сведения о товаре. Эта страница возвращает только фактически полученные поля пина и не гарантирует актуальные данные о наличии, возможность оформить заказ или данные о транзакциях.

    Проверено 2026-09-04