facebook-marketplace/
search

Busque artículos públicos de Facebook Marketplace por palabra clave y coordenadas, con títulos, precios, ubicaciones, imágenes, campos de estado y URL de origen en registros normalizados.

Facebook Marketplace Search API

Entrada por palabra clave y coordenadas
Filtros geográficos y de artículos
1–2,000 resultados solicitados
Artículos públicos normalizados
0.7 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 Search

Los artículos de Facebook Marketplace Search son ofertas públicas de comercio local con títulos, precios, ubicaciones, imágenes, contexto del vendedor, opciones de entrega y señales de disponibilidad. Estos campos sirven para investigar inventario local, comparar precios de venta, analizar categorías y tomar instantáneas repetibles del mercado.

Funcionalidades de la Facebook Marketplace Search API

  • Búsqueda de artículos por palabra clave y ubicación geográficaCombine una consulta no vacía con las coordenadas obligatorias de latitud y longitud, y acote los artículos públicos con controles de radio, precio, orden, entrega, condición, fecha y disponibilidad.
  • Registros estructurados de artículos y preciosDevuelve los ID de los artículos, las URL públicas, los títulos, las descripciones disponibles, los importes de precio, las monedas, los precios con formato y los valores tachados en una estructura uniforme.
  • Contexto de ubicación, medios y clasificaciónConserva en cada resultado las etiquetas de ubicación disponibles, los valores de ciudad y estado, las referencias a imágenes, los ID de categoría, los atributos, los tipos de entrega y el texto de la fecha de publicación.
  • Profundidad de las tarjetas de búsqueda públicasConserva los campos del vendedor expuestos y los indicadores de activo, pendiente, vendido, envío, compra inmediata y mensajería, y deja vacíos los detalles de la tarjeta de búsqueda cuando el resultado público no los ofrece.

Parámetros de la Facebook Marketplace Search API

ParámetrosObligatorioDescripción
queryObligatorioPalabra clave obligatoria y no vacía del artículo; los espacios iniciales y finales se eliminan antes del envío.
latitudeObligatorioLatitud obligatoria del centro de búsqueda, expresada como un número de -90 a 90.
longitudeObligatorioLongitud obligatoria del centro de búsqueda, expresada como un número de -180 a 180.
results_limitOpcionalNúmero máximo de artículos por guardar entre las páginas de búsqueda; el valor predeterminado es 100 y acepta enteros de 1 a 2,000.
radius_kmOpcionalRadio de búsqueda opcional en kilómetros; si se indica, debe ser un número mayor que 0.
min_priceOpcionalPrecio mínimo opcional del artículo; no puede ser negativo ni superar max_price.
max_priceOpcionalPrecio máximo opcional del artículo; no puede ser negativo ni ser menor que min_price.
sort_byOpcionalOrden opcional: suggested, distance_ascend, creation_time_descend, price_ascend o price_descend.
delivery_methodOpcionalFiltro opcional de entrega: all, local_pickup o shipping.
conditionOpcionalFiltro opcional de condición: new, used_like_new, used_good o used_fair.
date_listedOpcionalFiltro opcional de antigüedad de la publicación: all, 1, 7, 30, last_24_hours, last_7_days o last_30_days.
availabilityOpcionalFiltro opcional de disponibilidad: available, sold o all.

Cómo usar la Facebook Marketplace Search API

Envíe una palabra clave y un centro geográfico con filtros de artículos opcionales, siga la tarea asíncrona y lea los artículos normalizados con paginación por cursor.

  1. Prepare una consulta no vacía, una latitud de -90 a 90, una longitud de -180 a 180 y los filtros opcionales que necesite.
  2. Envíe la solicitud por POST a /v1/facebook-marketplace/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 solicite el next_cursor devuelto mientras has_more siga en true.
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

Casos de uso de la Facebook Marketplace Search API

  • Comparación de precios de venta locales: Compare los importes de precio normalizados, las monedas, los títulos, el contexto de la consulta y las ubicaciones de artículos públicos similares dentro de un área de búsqueda definida.
  • Investigación de inventario regional y de categorías: Use los ID de categoría, los atributos, los tipos de entrega, los campos de disponibilidad, las imágenes y el contexto de ubicación para armar un conjunto de datos acotado de artículos locales.
  • Instantáneas repetibles del mercado: Conserve los ID de los artículos, los precios, los campos de estado, search_query y collected_at para comparar a lo largo del tiempo resultados recopilados de forma independiente para la misma búsqueda.
  • Preparación de una lista corta de artículos: Use las URL públicas de los artículos, los títulos, los precios, las imágenes y el contexto de disponibilidad para elegir los registros que merecen un seguimiento a nivel de artículo.

Consejos de expertos para la Facebook Marketplace Search API

  • Cuando una búsqueda parta de un nombre de lugar y no de coordenadas, resuelva y verifique un candidato de Location Search antes de enviar la latitud y la longitud.
  • Valide los rangos de las coordenadas, mantenga radius_km por encima de 0, use precios no negativos y asegúrese de que min_price no supere max_price antes del envío.
  • Siga next_cursor hasta que has_more sea false cuando los resultados almacenados superen la primera página de respuesta; results_limit controla la recopilación, no el tamaño de página de la respuesta de la tarea.
  • Identifique las instantáneas repetidas por el ID del artículo y conserve collected_at, porque los ID duplicados se almacenan una sola vez por tarea y los artículos públicos pueden cambiar o desaparecer.
  • Trate las descripciones, los campos del vendedor, las coordenadas precisas, los atributos y las horas de creación como opcionales; use la URL de un artículo devuelto con Marketplace Item cuando necesite más detalle público.

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

  • Facebook Marketplace Location Search API — Convierte consultas de ciudad, región, barrio o nombre de lugar en candidatos de ubicación de Marketplace con sus coordenadas.
  • 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 Search API — FAQ

Facebook Marketplace Search API recupera artículos públicos de Marketplace para una palabra clave no vacía en torno a las coordenadas obligatorias de latitud y longitud. Devuelve la identidad normalizada del artículo, títulos, precios, ubicaciones, imágenes, contexto público del vendedor, campos de estado, URL de origen y hora de recopilación.

La solicitud requiere query, latitude y longitude. Los controles opcionales incluyen results_limit, radius_km, precios mínimo y máximo, orden, método de entrega, condición, antigüedad de la publicación y disponibilidad, con los valores de enumeración documentados.

results_limit es un máximo solicitado, no una cantidad garantizada. La recopilación se detiene cuando no hay más páginas de origen disponibles, y los registros con el mismo ID de artículo expuesto se guardan una sola vez.

Las tarjetas de búsqueda pueden omitir descripciones, identidad del vendedor, coordenadas precisas, atributos y horas de creación. Los clientes deben omitir o manejar con seguridad los campos opcionales ausentes, y no tratarlos como errores de la solicitud.

Un resultado vacío puede significar que no se devolvió ninguna coincidencia pública para la palabra clave y las coordenadas, que los filtros fueron demasiado restrictivos, que la disponibilidad regional fue distinta o que la fuente pública se detuvo en un límite de respuesta. Revise la ubicación y amplíe los filtros opcionales antes de reintentar.

Use Location Search cuando tenga el nombre de una ciudad, región, barrio o lugar, pero no coordenadas verificadas. Use Marketplace Item con la URL de un artículo conocido cuando necesite más detalle público del que ofrece una tarjeta de búsqueda.

Cada registro de artículo devuelto cuesta 0.7 créditos de SocQ. La estimación de la solicitud usa results_limit, o 100 si se omite, y un conjunto de resultados vacío no genera cargo por resultado.