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, отслеживайте асинхронную задачу и читайте нормализованные записи объявлений с курсорной пагинацией.
- Подготовьте один или несколько публичных URL Facebook Marketplace, путь которых начинается с /marketplace/item/{numeric_id}.
- Отправьте ссылки в поле urls на /v1/facebook-marketplace/item и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
- Читайте 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, и не считайте первую страницу полной.
Связанные API
Помимо Facebook Marketplace Item API, используйте эти API, когда нужен другой тип публичных данных Facebook Marketplace.
- Facebook Marketplace Location Search API — Преобразуйте запросы с названием города, региона, района или места в варианты локаций Marketplace с координатами.
- Facebook Marketplace Search API — Ищите публичные объявления Marketplace по ключевому слову и координатам: цена, местоположение, медиа, категория, доставка и наличие.