Felo API PlatformFelo API Platform
Все эндпоинты DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Живые задачи Pinterest

Сервер:https://openapi.felo.ai
Клиентские библиотеки

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Живые задачи Pinterest

​

Сколько раз каждый из targets был закреплён в Pinterest. Возвращает type, page_url и pins_count для каждого URL. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Принимает список, поэтому страницы всего сайта можно проверить одним вызовом. Для контента Pinterest, а не счётчиков, сервер pinterest читает платформу напрямую.

Справочные цены

  • Тарификация: стоимость ответа по данным провайдера.
  • Справочная оценка запроса: USD 0.2428.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело
обязательно
application/json
  • Тип: array object[]
    • targets
      Тип: array string[]
      обязательно

      целевые URL обязательное поле целевая страница должна быть указана абсолютным URL (включая http:// или https://) пример: https://dataforseo.com/Примечание: можно указать не более 10 целевых URL. Плата взимается за каждый URL, указанный в этом массиве

    • tag
      Тип: string

      пользовательский идентификатор задачи необязательное поле ограничение — 255 символов этот параметр позволяет идентифицировать задачу и сопоставить её с результатом указанное значение tag вы найдёте в объекте data ответа

Ответы
  • 200
    Тип: object

    Успешный ответ

    • result
      Тип: array string[]

      массив результатов

    • result.page_url
      Тип: string

      URL страницы, для которой предоставляются данные соответствующий URL, указанный вами в массиве targets при постановке задачи

    • result.pins_count
      Тип: integer

      количество пинов для связанного page_url Пины в Pinterest соответствуют сохранениям контента; это поле показывает количество сохранений контента, сделанных со связанного page_url с помощью кнопки Save в Pinterest

    • result.type
      Тип: string

      тип элемента = ‘social_media_pinterest_item’

    • tasks
      Тип: array string[]

      массив задач

    • tasks.cost
      Тип: number

      стоимость задачи, USD

    • tasks.data
      Тип: object

      содержит те же параметры, которые вы указали в POST-запросе

    • tasks.id
      Тип: string

      уникальный идентификатор задачи в нашей системе в формате UUID (Universally unique identifier)

    • tasks.path
      Тип: array string[]

      путь URL

    • tasks.result_count
      Тип: integer

      число элементов в массиве result

    • tasks.status_code
      Тип: integer

      код состояния задачи сформирован DataForSEO; может находиться в диапазоне 10000-60000

    • tasks.status_message
      Тип: string

      информационное сообщение задачи

    • tasks.time
      Тип: string

      время выполнения, секунды

    • version
      Тип: string

      текущая версия API

    • version.cost
      Тип: number

      общая стоимость задач, USD

    • version.status_code
      Тип: integer

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

    • version.status_message
      Тип: string

      общее информационное сообщение Полный список общих информационных сообщений можно найти здесь

    • version.tasks_count
      Тип: integer

      количество задач в массиве tasks

    • version.tasks_error
      Тип: integer

      количество задач в массиве tasks, возвращённых с ошибкой

    • version.time
      Тип: string

      время выполнения, секунды

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    application/json
Request Example for post/v1/beta/dataforseo/business_data/social_media/pinterest/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/social_media/pinterest/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      ""
    ],
    "tag": ""
  }
]'
{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.type": "string",
  "result.page_url": "string",
  "result.pins_count": 1
}
Live Social Media Pinterest Tasks

Нужна помощь?