API Pinterest

Pinterest Поиск API

Ищет в Pinterest по ключевому слову и возвращает пины, видео, доски или профили с заголовками, изображениями и ссылками.

0,80 USD/1 тыс. запросов, оплата за запрос, без подписки.

mid-century living room | Pinterest
pinterest.com/search/pins/
mid-century living roomLog inSign up
IdeasDecor ideasModernMinimalist designVintage accents
Save

Warm mid-century living room with walnut credenza

Living Room Ideas

Что вернул APIitems[0]
{
"id": "998271640023841902",
"url": "https://www.pinterest.com/pin/998271640023841902/",
"title": "Warm mid-century living room with walnut credenza",
"description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
"image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
"pinner": {...},
"boardName": "Living Room Ideas",
"domain": "havenandhearth.com",
... ещё полей: 4
}
Доступность
99,98%
30d · Вызовов: 29 405
Запросы
29 870
30 дн. · по неделям, последние недель: 12
Ответ
4,2s
медиана · 30d

Цены и поставщики

Цена API Pinterest Поиск: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
8,00 USD
0,80 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (125) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Pinterest Поиск одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `description` или `videoUrl`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может быть null в пине, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 9 из 13. Все поля

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "998271640023841902",
        "url": "https://www.pinterest.com/pin/998271640023841902/",
        "title": "Warm mid-century living room with walnut credenza",
        "description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
        "image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
        "pinner": {
          "username": "havenandhearth",
          "displayName": "Haven & Hearth Design"
        },
        "boardName": "Living Room Ideas",
        "domain": "havenandhearth.com",
        "saveCount": 4820
      },
      {
        "id": "672190384710025612",
        "url": "https://www.pinterest.com/pin/672190384710025612/",
        "title": "Sunken living room, 1962 case study house",
        "description": "Archival photo of a sunken conversation pit living room from a 1962 case study house.",
        "image": "https://i.pinimg.com/736x/7f/1e/33/case-study-house.jpg",
        "pinner": {
          "username": "modernarchive",
          "displayName": "Modern Archive"
        },
        "boardName": "Retro Interiors",
        "domain": "modernarchive.com",
        "saveCount": 12300
      },
      {
        "id": "554098271640023841",
        "url": "https://www.pinterest.com/pin/554098271640023841/",
        "title": "DIY mid-century TV console makeover",
        "description": "Step by step refinish of a thrifted teak console with new hairpin legs.",
        "image": "https://i.pinimg.com/736x/9b/44/12/tv-console-diy.jpg",
        "pinner": {
          "username": "thriftandtinker",
          "displayName": "Thrift & Tinker"
        },
        "boardName": "Furniture Flips",
        "domain": "thriftandtinker.com",
        "saveCount": 2190
      }
    ],
    "nextCursor": "QVFEc2ZncnRlaHRjS3ZaWA=="
  }
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-11-21 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • querystring

    mid-century living room

    Ключевое слово, тема, бренд или сюжет для поиска в Pinterest (например, mid-century living room).

  • cursorstring

    Непрозрачный курсор постраничной выдачи из nextCursor предыдущего ответа. Не указывайте для первой страницы.

  • limitinteger

    3

    Page size to ask for (1-20). Some sources return their whole page of about 20 pins whatever limit says: a page is never trimmed after the call, so nextCursor continues exactly where this response ended.

  • requireFieldsarray

    Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `description` или `videoUrl`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может быть null в пине, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.

  • typeenum

    Тип возвращаемых результатов: все пины, только видеопины, доски или профили (например, videos).

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each itemdata.items[]

Matching Pinterest records: pin or board title, description, image/video URL, creator, and link. Populated whenever the provider has data for the entity.

  • authorstring

    Username (handle) of the account that saved the pin.

  • authorNamestring

    Display name of the account that saved the pin.

  • descriptionstringможет потребовать

    A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.

    The pin's full description text, or null when the source does not provide it.

  • idstring

    998271640023841902

  • imagestring

    https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg

    URL of the pin's full-size image; for a video pin, its cover image.

  • titlestring

    Warm mid-century living room with walnut credenza

    Pin title, or the pin's description when the pin has no title.

  • urlstring

    https://www.pinterest.com/pin/998271640023841902/

    Populated whenever the provider has data for the entity.

  • videoUrlstringможет потребовать

    Streaming (HLS) URL of the pin's video, or null when the pin is not a video or the source does not provide it.

datadata
  • nextCursorstring

    QVFEc2ZncnRlaHRjS3ZaWA==

    Opaque cursor for the next page of results, or null/empty when there are no more. Pass it back as cursor to continue.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API Pinterest Поиск

AnyAPI Pinterest Поиск API возвращает данные Pinterest в виде нормализованного JSON одним вызовом POST к /v1/run/pinterest.search. Ищет в Pinterest по ключевому слову и возвращает пины, видео, доски или профили с заголовками, изображениями и ссылками. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 0,80 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Pinterest Поиск через AnyAPI завершились успешно, медианное время ответа 4,2 с, измерено вызовов: 29 405.

Это стоит от 0,80 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет в Pinterest по ключевому слову и возвращает пины, видео, доски или профили с заголовками, изображениями и ссылками. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов Pinterest Поиск через AnyAPI завершились успешно, медианное время ответа 4,2 с, измерено вызовов: 29 405. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 125 вызовов Pinterest Поиск по 0,0008 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/pinterest.search с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.