Volver a las API
Datos independientes de Facebook Marketplace

Facebook Marketplace API

Convierta lugares en coordenadas de búsqueda, descubra artículos públicos de Marketplace por palabra clave y ubicación, o consulte datos detallados de precio, vendedor, contenido multimedia, atributos y disponibilidad a partir de URL conocidas de artículos.

API de Facebook Marketplace disponibles

Use Location Search para resolver un lugar, Search para descubrir artículos alrededor de unas coordenadas o Item para obtener registros detallados a partir de URL conocidas de artículos de Marketplace.

¿Qué datos de Facebook Marketplace se pueden obtener?

SocQ devuelve candidatos de ubicación públicos, resultados de búsqueda de artículos y detalles de artículos normalizados para investigación de mercados locales, análisis de precios, seguimiento de inventario y enriquecimiento de artículos.

Candidatos de ubicación de Marketplace

Convierta el nombre de una ciudad, región, barrio o lugar en ID de ubicación de Facebook, etiquetas, contexto de dirección, latitud y longitud.

Identidad del artículo público

Obtenga los ID de artículos, títulos, descripciones, URL de origen, categorías, el texto de la fecha de publicación y las marcas de tiempo de recolección cuando estén disponibles.

Precios y monedas

Conserve los importes de precio, los códigos de moneda, los precios con formato y los precios tachados disponibles junto con cada artículo normalizado.

Datos de ubicación y entrega

Obtenga las etiquetas de lugar, los valores de ciudad y estado, las coordenadas, los tipos de entrega, las señales de envío y el contexto de retiro en persona que estén disponibles.

Contenido multimedia, atributos y contexto del vendedor

Obtenga las imágenes públicas del artículo, sus atributos, los valores de condición y los campos de identidad del vendedor cuando la fuente los expone.

Disponibilidad y estado del artículo

Conserve las señales de disponible, vendido, pendiente, oculto, activo, mensajería y compra inmediata para analizar los artículos en un momento dado.

SocQ vs Meta Graph API

SocQ se centra en la recolección pública compatible de Marketplace. La Graph API de Meta está diseñada para activos de Meta autorizados y no ofrece una API pública general de búsqueda en Marketplace.

FuncionalidadSocQMeta Graph API
Uso principalRecolección pública de ubicaciones, búsquedas y artículos de MarketplaceAdministrar los activos compatibles que una persona o una empresa ha autorizado
OAuth del clienteClave de API de SocQ; sin OAuth de Facebook del clienteApp de Meta, permisos y tokens de acceso
Búsqueda pública de artículosCompatible con una palabra clave y una ubicación resueltaSin un endpoint público general de búsqueda de artículos de Marketplace
Crear o editar artículosNo compatibleSin un endpoint general de publicación en Marketplace para consumidores
Formato de respuestaRegistros normalizados de SocQObjetos nativos de la Graph API para los productos compatibles

Cómo funciona la API de Facebook Marketplace

Resuelva un centro de búsqueda cuando haga falta, envíe una búsqueda de artículos o la URL de un artículo conocido y lea los registros normalizados mediante el flujo de tareas asíncronas compartido.

  1. 1. Preparar la entrada inicial

    Convierta el nombre de un lugar en coordenadas, use coordenadas que ya conozca o comience directamente con la URL pública de un artículo de Marketplace.

  2. 2. Enviar y dar seguimiento a la tarea

    Envíe la solicitud POST correspondiente, guarde el task_id devuelto y consulte /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Leer los resultados normalizados

    Procese data.results.items y siga next_cursor mientras has_more sea true.

Resolver una ubicación y buscar artículos

Primero resuelva el nombre de un lugar y luego use las coordenadas del candidato elegido para buscar artículos públicos de Marketplace.

# Resolve a place name
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"}'

# Search listings around the selected coordinates
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 frecuentes de la API de Facebook Marketplace

Descubrimiento de artículos locales

Resuelva una zona de mercado y busque artículos públicos por palabra clave, coordenadas, radio, precio, condición, método de entrega, fecha o disponibilidad.

Comparación de precios locales

Compare los precios solicitados, las monedas, los títulos, las categorías, las condiciones y las ubicaciones normalizados de artículos públicos similares.

Monitoreo de inventario regional

Obtenga instantáneas acotadas de artículos de mercados seleccionados y compare con el tiempo el inventario público, las opciones de entrega y la disponibilidad.

Enriquecimiento de artículos conocidos

Convierta URL conocidas de artículos en registros detallados con descripciones, contexto del vendedor, precios, ubicaciones, contenido multimedia, atributos y campos de estado.

Límites y política de datos públicos

Los resultados de Marketplace son registros públicos de un momento dado. Estas API no reproducen la interfaz de Marketplace para consumidores ni administran artículos o cuentas.

  • Location Search requiere una sola consulta con el nombre de un lugar, no acepta results_limit y puede devolver varios candidatos con nombres parecidos.
  • Verifique el contexto de dirección y las coordenadas antes de usar un candidato de ubicación como centro de una búsqueda de artículos.
  • Search requiere una palabra clave no vacía, latitude y longitude; results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000.
  • Los resultados de Search pueden omitir descripciones, datos del vendedor, coordenadas precisas, atributos y horas de creación, y los ID de artículo duplicados se guardan una sola vez.
  • Item requiere URL compatibles con el formato /marketplace/item/{numeric_id}; cada URL válida devuelve como máximo un registro y los artículos no disponibles pueden omitirse.
  • Un resultado vacío puede deberse a que no hay coincidencias públicas, a filtros restrictivos, a la disponibilidad regional, a un artículo no disponible o a un límite de la fuente pública.

Preguntas frecuentes sobre la API de Facebook Marketplace

¿Qué es la Facebook Marketplace API?

La Facebook Marketplace API es un conjunto de endpoints de SocQ para resolver ubicaciones de Marketplace, buscar artículos públicos y obtener registros detallados a partir de URL conocidas de artículos.

¿Qué API de Facebook Marketplace debo usar?

Use Location Search para resolver un lugar, Search para descubrir artículos alrededor de unas coordenadas e Item cuando ya tenga URL públicas de artículos de Marketplace.

¿Cómo se busca en Facebook Marketplace por ubicación?

Envíe a Location Search el nombre de una ciudad, región, barrio o lugar, elija el candidato correcto y luego pase su latitud y longitud a Search.

¿Qué devuelve Facebook Marketplace Search?

Search puede devolver la identidad del artículo, el título, la descripción, el precio, la ubicación, las imágenes, el contexto del vendedor, la categoría, las opciones de entrega, los campos de estado, la URL de origen y la hora de recolección.

¿Cuándo debo usar Facebook Marketplace Item?

Use Item con URL públicas conocidas de artículos cuando necesite campos detallados de descripción, vendedor, precio, ubicación, contenido multimedia, atributos, entrega y disponibilidad.

¿Por qué la cantidad de resultados puede ser menor que results_limit?

El límite es un máximo solicitado. La recolección puede detenerse cuando no hay otra página pública disponible, cuando los filtros excluyen registros o cuando se eliminan ID de artículo duplicados.

¿Cuánto cuestan los resultados de Facebook Marketplace?

Los candidatos de ubicación cuestan 0.3 créditos, los artículos de Search cuestan 0.7 créditos y los registros de Item cuestan 0.6 créditos por resultado devuelto. Los resultados vacíos no tienen cargo.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.