Facebook Marketplace Location Search
Локации Facebook Marketplace — это варианты мест, которые определяются названием, подзаголовком, адресом, городом, почтовым индексом и географическими координатами. Эти поля помогают устранять неоднозначность локаций, выбирать центр поиска и создавать переиспользуемые списки выбора мест для исследования локальных объявлений.
Возможности Facebook Marketplace Location Search API
- Определение локации по названию местаПередайте название города, региона, района или места и получите все варианты локаций Marketplace, найденные по этому запросу.
- Поля для различения локацийСравнивайте названия вариантов, подзаголовки, строки адреса, города, почтовые индексы, широту и долготу, чтобы различать места с одинаковым названием.
- Отслеживаемые нормализованные вариантыСохраняет с каждым вариантом ID локации Facebook, исходный поисковый запрос и время сбора, чтобы выбранное место можно было проверить и использовать повторно.
Параметры Facebook Marketplace Location Search API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Обязательное непустое название города, региона, района или места, например Austin. |
Как использовать Facebook Marketplace Location Search API
Отправьте один запрос с названием места, отслеживайте асинхронную задачу и читайте нормализованные варианты локаций, найденные по этому запросу.
- Подготовьте непустой запрос с названием города, региона, района или места.
- Отправьте query на /v1/facebook-marketplace/location-search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и переходите по next_cursor, пока has_more равно true.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Facebook Marketplace Location Search API
- Выбор центра поиска объявлений: Выберите широту и долготу подходящего варианта, чтобы задать географический центр, который требуется для Facebook Marketplace Search.
- Различение мест с одинаковым названием: Сравнивайте подзаголовки, город, почтовый индекс, адрес и координаты, прежде чем выбрать один из вариантов с похожими названиями.
- Данные для списка выбора локаций: Храните ID локации, отображаемое название, тип места и координаты за списком выбора для последующих запросов по локальным объявлениям.
Практические советы по Facebook Marketplace Location Search API
- Добавляйте регион или район, если короткое название места может соответствовать нескольким локациям.
- Сравнивайте подзаголовок, город, почтовый индекс, адрес и координаты, прежде чем принять вариант с совпадающим названием.
- Не передавайте results_limit: поиск локаций сохраняет все варианты, найденные по запросу.
- Продолжайте с next_cursor всякий раз, когда has_more равно true, чтобы пагинация результатов задачи не скрыла сохраненный вариант.
- Считайте пустой список items неразрешенным запросом, а не доказательством того, что Marketplace недоступен в этом регионе.
Связанные API
Помимо Facebook Marketplace Location Search API, используйте эти API, когда нужен другой тип публичных данных Facebook Marketplace.
- Facebook Marketplace Search API — Ищите публичные объявления Marketplace по ключевому слову и координатам: цена, местоположение, медиа, категория, доставка и наличие.
- Facebook Marketplace Item API — Собирайте подробные публичные объявления Marketplace по известным URL: продавец, цена, местоположение, медиа, характеристики, доставка и наличие.