facebook-marketplace/
location-search

Находите варианты локаций Facebook Marketplace по запросу с названием города, региона, района или места: названия, типы мест, адреса и координаты в виде нормализованных записей.

Facebook Marketplace Location Search API

Запрос по названию места
Варианты локаций
Широта и долгота
0,3 кредита за результат
Готово
Готово

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

README

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

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

Отправьте один запрос с названием места, отслеживайте асинхронную задачу и читайте нормализованные варианты локаций, найденные по этому запросу.

  1. Подготовьте непустой запрос с названием города, региона, района или места.
  2. Отправьте query на /v1/facebook-marketplace/location-search и сохраните возвращенный 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/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 недоступен в этом регионе.

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

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

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

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

Facebook Marketplace Location Search API — FAQ

Facebook Marketplace Location Search API преобразует непустой запрос с названием города, региона, района или места в нормализованные варианты локаций. Он возвращает названия, типы мест, адресные данные, широту, долготу и исходный запрос.

Используйте непустое название города, региона, района или места, например Austin. Географический контекст помогает, если одно и то же название носят несколько мест.

Сравнивайте название и подзаголовок варианта с extra.city, extra.postal_code, extra.address, extra.latitude и extra.longitude. ID локации и исходный поисковый запрос дополнительно упрощают отслеживание.

Нет. Эндпоинт отправки сохраняет все варианты, найденные по запросу, а ответ завершенной задачи всё равно может использовать next_cursor и has_more для пагинации сохраненных записей.

Выберите нужный вариант, затем передайте его значения extra.latitude и extra.longitude как центр поиска для Facebook Marketplace Search вместе с запросом по объявлениям.

Пустой массив items означает, что поиск локации не смог разрешить переданный запрос. Это не доказывает, что Facebook Marketplace недоступен в этом районе.

Каждый возвращенный вариант локации стоит 0,3 кредита SocQ. Пустой набор результатов при текущей конфигурации оплаты не тарифицируется.