Datos sociales (beta)

/

GET /v1/social/{platform}/{capability} devuelve datos públicos de Douyin, Xiaohongshu, TikTok, YouTube y otras plataformas sociales, con la misma clave de API y el mismo saldo que sus llamadas a modelos. Cada plataforma y capacidad tiene un precio por llamada exitosa, y data es la respuesta propia de la plataforma: los campos no se normalizan entre plataformas.

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Beta: solo cuentas de pago Complete su primera recarga antes de llamar. El crédito de prueba no se puede gastar en estos endpoints; una cuenta que nunca ha recargado recibe HTTP 403 model_requires_topup. La beta no tiene SLA, y sus plataformas, endpoints y precios pueden cambiar.

Autenticación y facturación

Envíe su clave de ChinaAPI como token bearer a https://api.chinaapi.ai, como en cualquier llamada a un modelo. Una llamada se cobra una sola vez, al precio indicado para su endpoint, y solo cuando devuelve HTTP 200 con datos; un resultado vacío, un parámetro rechazado o un fallo del upstream no cuestan nada. Cada página que obtenga es una llamada aparte. Su registro de uso muestra cada llamada con el nombre que aparece junto a su endpoint, como social-douyin-search.

Respuestas y errores

Una respuesta exitosa envuelve los datos de la plataforma en un pequeño sobre. Todo lo que hay dentro de data (nombres de campos, cursores de paginación, IDs) es propio de la plataforma; devuelva los cursores exactamente como los recibió.

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — un parámetro es desconocido, está repetido, es demasiado largo, tiene el tipo incorrecto o falta, incluido el caso en que no se da ningún miembro de un grupo "al menos uno de". El code del error indica cuál, como unknown_parameter o missing_parameter.
  • 403 model_requires_topup — la cuenta no ha completado su primera recarga.
  • 404 — el par de plataforma y capacidad no existe, o la plataforma no encontró nada para estos parámetros (social_data_no_result).
  • 429 social_data_capacity_reached — la capacidad diaria de la beta se ha agotado y se restablece a las 00:00 UTC, o la plataforma está ocupada y basta con reintentar unos segundos después. No reintente en un bucle cerrado.
  • 502 — la fuente de datos no respondió, o respondió sin datos.
  • 503 social_data_unavailable — este endpoint está en pausa ahora mismo; el catálogo en vivo lo muestra como paused.

Ninguna de estas respuestas se cobra.

Uso aceptable

Respete los términos de cada plataforma y las normas de protección de datos que le apliquen. No use esta API para elaborar perfiles de personas. Iniciar sesión, extraer datos de contacto, manipular la interacción y acceder a contenido privado o de pago quedan fuera de esta beta.

Plataformas y precios

USD por llamada exitosa. Cada precio enlaza con su endpoint más abajo, y un guion significa que la plataforma no ofrece esa capacidad. El catálogo en vivo (GET https://dash.chinaapi.ai/api/social/catalog, sin clave) es la referencia de lo que está a la venta ahora mismo, incluido cualquier endpoint en pausa.

Endpoints

Los parámetros van en la query string con los nombres propios de la plataforma. Los ejemplos provienen del catálogo; reemplace los identificadores por el contenido que quiere obtener.