facebook-marketplace/
location-search

Encuentre ubicaciones candidatas de Facebook Marketplace a partir de una consulta por ciudad, región, barrio o lugar, con nombres, tipos de lugar, direcciones y coordenadas en registros normalizados.

Facebook Marketplace Location Search API

Consulta por nombre de lugar
Ubicaciones candidatas
Latitud y longitud
0.3 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Facebook Marketplace Location Search

Las ubicaciones de Facebook Marketplace son lugares candidatos identificados por nombres, subtítulos, datos de dirección, contexto de ciudad y código postal, y coordenadas geográficas. Estos campos sirven para desambiguar ubicaciones, elegir el centro de una búsqueda y crear selectores de lugares reutilizables para investigar artículos locales.

Funcionalidades de la Facebook Marketplace Location Search API

  • Resolución de ubicaciones por nombre de lugarEnvíe el nombre de una ciudad, región, barrio o lugar y reciba todas las ubicaciones candidatas de Marketplace que devuelva esa búsqueda.
  • Campos para desambiguar ubicacionesCompare los nombres, los subtítulos, las líneas de dirección, las ciudades, los códigos postales, la latitud y la longitud de los candidatos para distinguir lugares que comparten un nombre.
  • Candidatos normalizados y rastreablesConserva el ID de ubicación de Facebook, la consulta de búsqueda original y la hora de recopilación en cada candidato, para poder revisar y reutilizar el lugar seleccionado.

Parámetros de la Facebook Marketplace Location Search API

ParámetrosObligatorioDescripción
queryObligatorioNombre obligatorio y no vacío de una ciudad, región, barrio o lugar, como Austin.

Cómo usar la Facebook Marketplace Location Search API

Envíe una consulta por nombre de lugar, siga la tarea asíncrona y lea las ubicaciones candidatas normalizadas que devuelve esa búsqueda.

  1. Prepare una consulta no vacía con el nombre de una ciudad, región, barrio o lugar.
  2. Envíe query a /v1/facebook-marketplace/location-search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
  4. Lea data.results.items y siga next_cursor mientras has_more sea 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

Casos de uso de la Facebook Marketplace Location Search API

  • Determinación del centro de búsqueda de artículos: Seleccione la latitud y la longitud de un candidato para indicar el centro geográfico que requiere Facebook Marketplace Search.
  • Desambiguación de lugares con el mismo nombre: Compare los subtítulos, la ciudad, el código postal, la dirección y las coordenadas antes de elegir entre candidatos con nombres parecidos.
  • Datos para un selector de ubicaciones reutilizable: Almacene el ID de ubicación, el nombre visible, el tipo de lugar y las coordenadas detrás de un selector para consultas posteriores de artículos locales.

Consejos de expertos para la Facebook Marketplace Location Search API

  • Incluya la región o el barrio cuando el nombre corto de un lugar pueda coincidir con varias ubicaciones.
  • Compare el subtítulo, la ciudad, el código postal, la dirección y las coordenadas antes de aceptar un candidato con el mismo nombre.
  • No envíe results_limit, porque la búsqueda de ubicaciones guarda todos los candidatos que devuelve la consulta.
  • Continúe con next_cursor siempre que has_more sea true para que la paginación de resultados de la tarea no oculte un candidato guardado.
  • Trate una lista de elementos vacía como una consulta sin resolver, y no como prueba de que Marketplace no está disponible en esa región.

Además de la Facebook Marketplace Location Search API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook Marketplace.

  • Facebook Marketplace Search API — Busca artículos públicos de Marketplace por palabra clave y coordenadas, con contexto de precio, ubicación, contenido multimedia, categoría, entrega y disponibilidad.
  • Facebook Marketplace Item API — Recolecta artículos públicos detallados de Marketplace desde URLs conocidas, con campos de vendedor, precio, ubicación, contenido multimedia, atributos, entrega y disponibilidad.

Explorar otras plataformas

Combine los datos de Facebook Marketplace con datos públicos de otras plataformas sociales compatibles.

Facebook Marketplace Location Search API — FAQ

Facebook Marketplace Location Search API convierte una consulta no vacía por ciudad, región, barrio o lugar en ubicaciones candidatas normalizadas. Devuelve nombres, tipos de lugar, contexto de dirección, latitud, longitud y la consulta original.

Use el nombre no vacío de una ciudad, región, barrio o lugar, como Austin. Agregar contexto geográfico puede ayudar cuando varios lugares usan el mismo nombre.

Compare el nombre y el subtítulo del candidato con extra.city, extra.postal_code, extra.address, extra.latitude y extra.longitude. El ID de ubicación y la consulta de búsqueda original aportan trazabilidad adicional.

No. El endpoint de envío guarda todos los candidatos que devuelve la consulta, mientras que la respuesta de la tarea completada aún puede usar next_cursor y has_more para paginar los registros de resultados almacenados.

Elija el candidato correcto y luego pase sus valores extra.latitude y extra.longitude como centro de búsqueda de Facebook Marketplace Search, junto con una consulta de artículos.

Un arreglo items vacío significa que la búsqueda de ubicación no resolvió la consulta enviada. No demuestra que Facebook Marketplace no esté disponible en esa zona.

Cada ubicación candidata devuelta cuesta 0.3 créditos de SocQ. Un conjunto de resultados vacío no genera cargo por resultado con la configuración de facturación actual.