facebook-marketplace/
item

Собирайте публичные объявления Facebook Marketplace по их URL: содержимое объявления, данные продавца, цена и местоположение, медиафайлы и доступность в виде нормализованных записей.

Facebook Marketplace Item API

URL объявлений Marketplace
Цена и данные продавца
Публичные данные объявлений
0,6 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Facebook Marketplace Item

Объявления Facebook Marketplace — это публичные карточки с заголовком, описанием, данными продавца, ценой, местоположением, фотографиями, характеристиками, вариантами доставки и признаками доступности. Эти поля помогают обогащать выбранные объявления, проверять цену и статус, сравнивать товары и фиксировать состояние объявления на определенный момент.

Возможности Facebook Marketplace Item API

  • Ввод известных URL объявленийОбрабатывает публичные пути на facebook.com, www.facebook.com, m.facebook.com или web.facebook.com, начинающиеся с /marketplace/item/{numeric_id}, и ограничивает сбор только переданными объявлениями.
  • Нормализованные данные объявленияВозвращает идентификаторы объявления, заголовок, описание, данные продавца, цену, местоположение, изображения, характеристики, параметры доставки, метки времени и публичные поля доступности, если они открыты.
  • Независимая пакетная обработкаОбрабатывает каждый корректный URL отдельно и возвращает не более одного объявления на URL, поэтому недоступный товар не останавливает обработку остальных входных данных.
  • Четкая граница публичных данныхОставляет зависящие от источника значения продавца, местоположения, медиафайлов, характеристик, доставки и статуса пустыми (null), а не подставляет данные-заглушки для полей, которые публичное объявление не показывает.

Параметры Facebook Marketplace Item API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный непустой список публичных URL объявлений Facebook Marketplace. Допустимые хосты: facebook.com, www.facebook.com, m.facebook.com и web.facebook.com; каждый путь должен начинаться с /marketplace/item/{numeric_id}.

Как использовать Facebook Marketplace Item API

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

  1. Подготовьте один или несколько публичных URL Facebook Marketplace, путь которых начинается с /marketplace/item/{numeric_id}.
  2. Отправьте ссылки в поле urls на /v1/facebook-marketplace/item и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
  4. Читайте data.results.items, затем запрашивайте следующую страницу с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/item" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/marketplace/item/1656586118821988/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Facebook Marketplace Item API

  • Обогащение выбранных результатов поиска: Используйте описания объявлений, поля продавца, дополнительные медиафайлы, характеристики, параметры доставки и точное местоположение, чтобы дополнить выбранную подборку результатов поиска Marketplace.
  • Повторная проверка цены и доступности: Сравнивайте нормализованную цену, зачеркнутую цену, текст о доступности и признаки live, pending, sold, доставки, мгновенной покупки или сообщений для известных URL объявлений.
  • Сравнение характеристик выбранных товаров: Упорядочивайте заголовки, категории, состояние товара, местоположения, типы доставки, цены и медиафайлы по заданному списку публичных объявлений.
  • Сохранение снимков объявлений: Храните идентификаторы объявления, исходный URL, публичное содержимое, поля состояния, created_at и collected_at как запись на определенный момент для последующего сравнения.

Практические советы по Facebook Marketplace Item API

  • Проверяйте каждый хост и путь /marketplace/item/{numeric_id} и удаляйте дубли строк URL перед отправкой: один некорректный URL отклоняет весь запрос, а точные дубли обрабатываются только один раз.
  • Считайте нормальным, если записей вернулось меньше, чем было отправлено URL: недоступный или ненайденный товар пропускается, а не превращается в объявление-заглушку.
  • Обрабатывайте данные продавца, координаты, описание, медиафайлы, характеристики, параметры доставки, время создания и публичные признаки состояния как необязательные поля, зависящие от источника.
  • Храните extra.input_url вместе с collected_at, чтобы каждое возвращенное объявление оставалось привязанным к отправленному URL и времени наблюдения.
  • Если успешных результатов в пакете больше, чем помещается на текущей странице, переходите по next_cursor, пока has_more равно true, и не считайте первую страницу полной.

Помимо Facebook Marketplace Item API, используйте эти API, когда нужен другой тип публичных данных Facebook Marketplace.

  • Facebook Marketplace Location Search API — Преобразуйте запросы с названием города, региона, района или места в варианты локаций Marketplace с координатами.
  • Facebook Marketplace Search API — Ищите публичные объявления Marketplace по ключевому слову и координатам: цена, местоположение, медиа, категория, доставка и наличие.

Другие платформы

Объединяйте данные Facebook Marketplace с публичными данными других поддерживаемых соцсетей.

Facebook Marketplace Item API — FAQ

Facebook Marketplace Item API собирает публичные данные объявлений по переданным URL товаров Marketplace и возвращает нормализованные заголовки, описания, данные продавцов, цены, местоположения, медиафайлы, характеристики и поля доступности.

Отправляйте URL на facebook.com, www.facebook.com, m.facebook.com или web.facebook.com, путь которых начинается с /marketplace/item/{numeric_id}. Другие пути Facebook и хосты не из Facebook отклоняются.

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

Недоступный или ненайденный товар не создает запись-заглушку, а остальные корректные URL продолжают обрабатываться.

Данные продавца, координаты, описания, медиафайлы, характеристики, параметры доставки, метки времени и признаки состояния могут быть пустыми, если публичный источник их не показывает. Эндпоинт работает только на чтение и не покупает, не продает, не редактирует, не резервирует, не отправляет товар и не пишет сообщения по нему.

Каждое успешно возвращенное объявление стоит 0,6 кредита SocQ. URL, по которым запись не получена, не учитываются в оплате результатов.