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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Nombre 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.
- Prepare una consulta no vacía con el nombre de una ciudad, región, barrio o lugar.
- Envíe query a /v1/facebook-marketplace/location-search y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.