Facebook Marketplace API
Преобразуйте названия мест в координаты для поиска, находите публичные объявления Marketplace по ключевому слову и местоположению или получайте подробные данные о цене, продавце, медиа, характеристиках и доступности по известным URL товаров.
Доступные API Facebook Marketplace
Используйте Location Search, чтобы определить место, Search — чтобы найти объявления вокруг координат, а Item — чтобы получить подробные записи по известным URL товаров Marketplace.
Какие данные Facebook Marketplace можно получить?
SocQ возвращает нормализованные публичные варианты местоположений, результаты поиска объявлений и данные товаров для исследования локальных рынков, анализа цен, отслеживания предложения и обогащения объявлений.
Варианты местоположений Marketplace
Преобразуйте название города, региона, района или места в ID местоположений Facebook, метки, адресный контекст, широту и долготу.
Идентификаторы публичных объявлений
Получайте ID объявлений, заголовки, описания, исходные URL, категории, текст даты размещения и метки времени сбора, если они доступны.
Цены и валюты
Сохраняйте доступные суммы цены, коды валют, отформатированные цены и зачеркнутые цены для каждого нормализованного объявления.
Местоположение и доставка
Получайте доступные метки мест, город и штат, координаты, способы доставки, сигналы отправки и данные о самовывозе.
Медиа, характеристики и продавец
Собирайте публичные изображения объявлений, характеристики товара, значения состояния и поля идентичности продавца, если источник их предоставляет.
Доступность и статус объявления
Сохраняйте сигналы «доступно», «продано», «в ожидании», «скрыто», «активно», «можно написать» и «купить сейчас» для анализа объявлений на определенный момент.
SocQ vs Meta Graph API
SocQ сосредоточен на сборе поддерживаемых публичных данных Marketplace. Graph API от Meta предназначен для авторизованных ресурсов Meta и не предоставляет общего API для поиска по публичному Marketplace.
| Возможность | SocQ | Meta Graph API |
|---|---|---|
| Основное назначение | Сбор публичных местоположений, результатов поиска и товаров Marketplace | Управление поддерживаемыми ресурсами, доступ к которым разрешил пользователь или компания |
| OAuth клиента | API-ключ SocQ; OAuth клиента в Facebook не нужен | Приложение Meta, разрешения и токены доступа |
| Поиск публичных объявлений | Поддерживается по ключевому слову и определенному местоположению | Нет общего эндпоинта для поиска публичных объявлений Marketplace |
| Создание и редактирование объявлений | Не поддерживается | Нет общего эндпоинта для публикации в потребительском Marketplace |
| Формат ответа | Нормализованные записи SocQ | Исходные объекты Graph API для поддерживаемых продуктов |
Как работает Facebook Marketplace API
При необходимости определите центр поиска, отправьте поиск объявлений или известный URL товара, а затем читайте нормализованные записи через общий процесс асинхронных задач.
1. Подготовьте входные данные
Преобразуйте название места в координаты, используйте уже известные координаты или начните сразу с публичного URL товара Marketplace.
2. Отправьте задачу и отслеживайте ее
Отправьте соответствующий POST-запрос, сохраните возвращенный task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.
3. Читайте нормализованные результаты
Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true.
Сначала определите место по названию, затем используйте координаты выбранного варианта для поиска публичных объявлений Marketplace.
# Resolve a place name
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Austin"}'
# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueТипичные сценарии использования Facebook Marketplace API
Поиск локальных объявлений
Определите рыночную зону и ищите публичные объявления по ключевому слову, координатам, радиусу, цене, состоянию, способу доставки, дате или доступности.
Сравнение локальных цен
Сравнивайте нормализованные запрашиваемые цены, валюты, заголовки, категории, состояние и местоположения похожих публичных объявлений.
Мониторинг регионального предложения
Собирайте ограниченные снимки объявлений на выбранных рынках и сравнивайте публичное предложение, варианты доставки и доступность во времени.
Обогащение известных объявлений
Превращайте известные URL товаров в подробные записи с описаниями, данными продавца, ценами, местоположениями, медиа, характеристиками и полями статуса.
Ограничения и политика публичных данных
Результаты Marketplace — это публичные записи на определенный момент. Эти API не воспроизводят потребительский интерфейс Marketplace и не управляют объявлениями и аккаунтами.
- Location Search требует один непустой запрос с названием места, не принимает results_limit и может вернуть несколько вариантов с похожими названиями.
- Проверяйте адресный контекст и координаты, прежде чем использовать вариант местоположения как центр поиска объявлений.
- Search требует непустое ключевое слово, широту и долготу; results_limit по умолчанию равен 100 и принимает целые числа от 1 до 2 000.
- В результатах Search могут отсутствовать описания, данные продавца, точные координаты, характеристики и время создания, а повторяющиеся ID объявлений сохраняются один раз.
- Item требует поддерживаемые URL вида /marketplace/item/{numeric_id}; каждый корректный URL возвращает не более одной записи, а недоступные товары могут быть пропущены.
- Пустой результат может означать отсутствие публичных совпадений, слишком строгие фильтры, региональную доступность, недоступное объявление или ограничение публичного источника.
Частые вопросы о Facebook Marketplace API
Что такое Facebook Marketplace API?
Facebook Marketplace API — это набор эндпоинтов SocQ для определения местоположений Marketplace, поиска публичных объявлений и получения подробных записей по известным URL товаров.
Какой API Facebook Marketplace выбрать?
Используйте Location Search, чтобы определить место, Search — чтобы найти объявления вокруг координат, а Item — если у вас уже есть публичные URL товаров Marketplace.
Как искать в Facebook Marketplace по местоположению?
Передайте название города, региона, района или места в Location Search, выберите правильный вариант, затем передайте его широту и долготу в Search.
Что возвращает Facebook Marketplace Search?
Search может вернуть идентификаторы объявления, заголовок, описание, цену, местоположение, изображения, данные продавца, категорию, варианты доставки, поля статуса, исходный URL и время сбора.
Когда использовать Facebook Marketplace Item?
Используйте Item для известных публичных URL товаров, когда нужны подробные поля описания, продавца, цены, местоположения, медиа, характеристик, доставки и доступности.
Почему число результатов может быть меньше results_limit?
Лимит — это запрошенный максимум. Сбор может остановиться, если больше нет доступных публичных страниц, фильтры исключают записи или удаляются повторяющиеся ID объявлений.
Сколько стоят результаты Facebook Marketplace?
Варианты местоположений стоят 0,3 кредита, объявления из Search — 0,7 кредита, а записи Item — 0,6 кредита за каждый возвращенный результат. Пустые результаты не оплачиваются.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
X API
Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.
LinkedIn API
Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.
Reddit API
Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.
Pinterest API
Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.
Threads API
Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.
Bluesky API
Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.


