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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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.
- Prepare una o más URL públicas de Facebook Marketplace cuya ruta comience con /marketplace/item/{numeric_id}.
- Envíe los enlaces como urls a /v1/facebook-marketplace/item y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.