facebook-marketplace/
item

Recopile artículos públicos de Facebook Marketplace a partir de URL de artículos, con contenido de la publicación, datos del vendedor, precio y ubicación, medios y disponibilidad en registros normalizados.

Facebook Marketplace Item API

URL de artículos de Marketplace
Contexto de precio y vendedor
Detalles públicos del artículo
0.6 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 Item

Los artículos de Facebook Marketplace son publicaciones públicas con títulos, descripciones, datos del vendedor, precios, ubicaciones, fotos, atributos, opciones de entrega y señales de disponibilidad. Estos campos sirven para enriquecer artículos seleccionados, verificar precios y estados, comparar artículos y conservar registros de un momento dado.

Funcionalidades de la Facebook Marketplace Item API

  • Entrada por URL de artículo conocidaProcesa rutas públicas de facebook.com, www.facebook.com, m.facebook.com o web.facebook.com que comienzan con /marketplace/item/{numeric_id}, y mantiene la recopilación limitada a los artículos enviados.
  • Detalles normalizados del artículoDevuelve la identidad del artículo, el título, la descripción, el contexto del vendedor, el precio, la ubicación, las imágenes, los atributos, los valores de entrega, las marcas de tiempo y los campos públicos de disponibilidad cuando se exponen.
  • Procesamiento independiente por lotesManeja cada URL válida de forma independiente y devuelve como máximo un artículo por URL, de modo que un artículo no disponible no detiene el procesamiento de las demás entradas.
  • Límite explícito de datos públicosMantiene como valores que pueden ser nulos los datos de vendedor, ubicación, medios, atributos, entrega y estado que dependen de la fuente, en lugar de crear detalles de relleno para los campos que el artículo público no expone.

Parámetros de la Facebook Marketplace Item API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria y no vacía de URL públicas de artículos de Facebook Marketplace. Los hosts aceptados son facebook.com, www.facebook.com, m.facebook.com y web.facebook.com, y la ruta de cada una debe comenzar con /marketplace/item/{numeric_id}.

Cómo usar la Facebook Marketplace Item API

Envíe URL públicas conocidas de artículos de Marketplace, siga la tarea asíncrona y lea los registros de artículos normalizados con paginación por cursor.

  1. Prepare una o más URL públicas de Facebook Marketplace cuya ruta comience con /marketplace/item/{numeric_id}.
  2. Envíe los enlaces como urls a /v1/facebook-marketplace/item y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o devuelva un error.
  4. Lea data.results.items y solicite la página siguiente con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/item" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/marketplace/item/1656586118821988/"]}'

# 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 Item API

  • Enriquecer resultados de búsqueda seleccionados: Use las descripciones de los artículos, los campos del vendedor, los medios adicionales, los atributos, los valores de entrega y el contexto de ubicación precisa para ampliar un conjunto elegido de resultados de búsqueda de Marketplace.
  • Volver a verificar precio y disponibilidad: Compare el precio normalizado, el precio tachado, el texto de disponibilidad y los indicadores de activo, pendiente, vendido, envío, compra inmediata o mensajería de URL de artículos conocidas.
  • Comparar atributos de artículos seleccionados: Organice los títulos, las categorías, los atributos de condición, las ubicaciones, los tipos de entrega, los precios y los medios de una lista definida de artículos públicos.
  • Conservar instantáneas de artículos: Almacene la identidad del artículo, la URL de origen, el contenido público, los campos de estado, created_at y collected_at como un registro de un momento dado para compararlo más adelante.

Consejos de expertos para la Facebook Marketplace Item API

  • Valide cada host y cada ruta /marketplace/item/{numeric_id}, y elimine las URL duplicadas antes del envío, porque una sola URL no válida rechaza la solicitud y los duplicados exactos se procesan una sola vez.
  • Trate como un resultado válido que se devuelvan menos registros que URL enviadas, porque un artículo no disponible o no encontrado se omite y no se convierte en un artículo de relleno.
  • Maneje la identidad del vendedor, las coordenadas, la descripción, los medios, los atributos, los valores de entrega, la hora de creación y los indicadores públicos de estado como campos opcionales que dependen de la fuente.
  • Almacene extra.input_url junto con collected_at para que cada artículo devuelto siga ligado a su URL enviada y a la hora de observación.
  • En los lotes cuyos resultados exitosos superen la página de resultados actual, siga next_cursor mientras has_more sea true en lugar de suponer que la primera página está completa.

Además de la Facebook Marketplace Item 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 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.

Explorar otras plataformas

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

Facebook Marketplace Item API — FAQ

Facebook Marketplace Item API recopila los detalles públicos de artículos a partir de las URL de artículos de Marketplace enviadas y devuelve títulos, descripciones, vendedores, precios, ubicaciones, medios, atributos y campos de disponibilidad, todo normalizado.

Envíe URL de facebook.com, www.facebook.com, m.facebook.com o web.facebook.com cuya ruta comience con /marketplace/item/{numeric_id}. Las demás rutas de Facebook y los hosts que no son de Facebook se rechazan.

Sí. Envíe una lista urls no vacía; las cadenas duplicadas exactas se eliminan antes de las solicitudes al proveedor, y cada URL válida distinta puede producir como máximo un artículo.

Un artículo no disponible o no encontrado no produce ningún registro de relleno, y las demás URL válidas siguen procesándose.

La identidad del vendedor, las coordenadas, las descripciones, los medios, los atributos, los valores de entrega, las marcas de tiempo y los indicadores de estado pueden estar vacíos cuando la fuente pública no los expone. El endpoint es de solo lectura y no compra, vende, edita, reserva, envía ni manda mensajes sobre un artículo.

Cada artículo devuelto con éxito cuesta 0.6 créditos de SocQ. Las URL que no producen ningún registro no se incluyen en el cargo por resultado.