TikTok · Buscar publicaciones
Beta
Datos públicos de plataformas sociales, cobrados por llamada, con la misma clave de API y el mismo saldo que tus llamadas a modelos.
Solo cuentas que ya hicieron su primera recarga, sin prueba gratuita · Una llamada solo se cobra cuando devuelve HTTP 200 con data no vacío; los resultados vacíos, los parámetros rechazados y los fallos del proveedor no se cobran.
Parámetros de la solicitud
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.
| Nombre | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
keyword | string | Sí | "TikTok" | Search keyword |
offset | integer | No | 0 | Page cursor |
search_id | string | No | "" | Search id, need to provide when paging |
Ejemplo de solicitud
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'keyword=TikTok'Estructura de la respuesta
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": "tiktok",
"capability": "search",
"data": { … }
}Paginación
Parámetros de paginación: offset, search_id. Cada página es una llamada que se cobra por separado; toma los valores de cursor de la respuesta anterior tal como llegaron.
Errores y lo que no se cobra
| Código de estado | Código de error | Significado |
|---|---|---|
| 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 | social_data_no_result | 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 | social_data_no_result | 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.
Cada respuesta incluye la cabecera X-Oneapi-Request-Id; inclúyela al contactar con soporte y encontraremos esa llamada exacta.
Condiciones de la beta
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.
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.