API de Xianyu
Xianyu (Goofish) es el mercado de segunda mano de Alibaba. search devuelve anuncios que coinciden con una palabra clave y item_detail lee un lote de anuncios a partir de su ID numérico o de su enlace de goofish.com, con una fila por anuncio.
Los artículos de segunda mano se venden o se retiran con rapidez, así que cada fila es una instantánea del momento de la solicitud. En la búsqueda, want_count sale de la etiqueta de la tarjeta y vale null cuando la tarjeta no la muestra; item_detail añade el estado en una escala de diez puntos, visitas, guardados, todas las fotos, la descripción y el porcentaje de valoraciones positivas del vendedor.
- Endpoint
- POST /api/v1/social
- Funciones
- 2
- Por 1.000
- $5.56 por 1.000 solicitudes
Funciones disponibles
Compara las acciones de Xianyu por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar anuncios en Xianyu Envía en | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · platform |
item_detailLeer anuncios por lotes Pasa en | urls | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | item_id · url · title · text · price · original_price · currency · shipping_fee · condition_level · status · quantity · want_count · view_count · collect_count · sold_count · province · city · category_id · image_url · images · posted_at · seller_id · seller_name · seller_url · seller_item_count · seller_sold_count · seller_good_review_rate · seller_reply_rate_24h · platform |
¿Qué acepta cada acción de Xianyu?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
¿Qué significan los parámetros de Xianyu search?
Envía en keyword un término en chino o un número de modelo, que coinciden más con los títulos de los vendedores; limit admite de 1 a 50 resultados. Cada fila trae item_id, price, city, want_count y posted_at; guarda item_id para leer después el anuncio completo.
keywordObligatorio- Término de búsqueda de Xianyu para
search, de 1 a 100 caracteres. Los términos en chino y los números de modelo coinciden más con los títulos de los vendedores que las traducciones al inglés. No es un ID de artículo ni el nombre de un vendedor.
¿Qué significan los parámetros de Xianyu item_detail?
Pasa en urls entre 1 y 20 anuncios, como ID numéricos o enlaces https://www.goofish.com/item?id=. Cada anuncio se consulta y se cobra por separado: condition_level usa una escala de diez puntos, sold_count vale null cuando Xianyu no lo muestra y los anuncios que no se pueden leer aparecen en missed y se reembolsan.
urlsObligatorio- Para
item_detail, una lista de 1 a 20 anuncios de Xianyu: cada elemento es un ID numérico (elitem_idque devuelvesearch) o un enlacehttps://www.goofish.com/item?id=<dígitos>, y cada anuncio puede aparecer una sola vez. Se cobra por anuncio y se reembolsan los que no se pueden leer. Todavía no se aceptan los enlaces cortos para compartir de la app.Alibaba Open Platform: ID de artículo y grado de conservación en Xianyu — La API de consulta de artículos de Alibaba para socios ISV autorizados de Xianyu identifica un anuncio por su ID numérico y gradúa el estado con stuff_status: 100 es nuevo, 95 es al 95 % y -1 es casi nuevo. Las llamadas requieren autorización dentro del entorno de socios de Alibaba; la fuente solo confirma la terminología del identificador y del estado, y no implica que EveryInfra use esa API ni que pueda leer todos los campos de cualquier anuncio. · Consultada
Cómo usar la API de Xianyu
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Xianyu
¿Cómo llamo a la API de Xianyu?
Envía POST /api/v1/social con platform igual a xianyu, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Xianyu?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye item_id, title, price y original_price. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Xianyu?
La API de consulta de artículos de Alibaba para socios ISV autorizados de Xianyu identifica un anuncio por su ID numérico y gradúa el estado con stuff_status: 100 es nuevo, 95 es al 95 % y -1 es casi nuevo. Las llamadas requieren autorización dentro del entorno de socios de Alibaba; la fuente solo confirma la terminología del identificador y del estado, y no implica que EveryInfra use esa API ni que pueda leer todos los campos de cualquier anuncio.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; item_detail requiere urls.
¿Las acciones de Xianyu responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. item_detail solo funciona en modo síncrono: lee todos los elementos del lote en la misma llamada y, si la solicitud lleva "mode": "async", la API responde con un 422 antes de cobrar nada. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.