cURL
curl --request POST \
--url https://api.influship.com/v1/raw/tiktok/video/transcripts \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"urls": [
"<string>"
]
}
'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.raw.tiktok.getVideoTranscripts({ urls: ['https://example.com'] });
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/tiktok/video/transcripts"
payload = { "urls": ["<string>"] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"requested": 4503599627370495,
"succeeded": 4503599627370495,
"failed": 4503599627370495,
"items": [
{
"success": true,
"url": "<string>",
"data": {
"video_id": "<string>",
"url": "<string>",
"transcript": "<string>",
"full_text": "<string>",
"segments": [
{
"start_ms": 4503599627370495,
"end_ms": 4503599627370495,
"text": "<string>"
}
],
"word_count": 4503599627370495,
"language": "<string>",
"source": "captions",
"duration_seconds": 1,
"scraped_at": "2023-11-07T05:31:56Z"
}
}
],
"scraped_at": "2023-11-07T05:31:56Z",
"mode": "auto"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid Instagram username format",
"param": "username",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "upstream_contract_broken",
"message": "The upstream source returned data this endpoint cannot process. This is not retryable; it has been reported.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"upstream_error": "upstream_contract_broken",
"retryable": false
}
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Live Scraping
Get TikTok Transcripts in a Batch
Process up to 10 video URLs with ordered per-item results. Choose auto (default, 0.025peritem)orcaptions(0.002 per item, never generates). Account credits charge successful items only. Premium payments quote all requested items and are nonrefundable once settled, including partial or failed items in a completed batch.
POST
/
v1
/
raw
/
tiktok
/
video
/
transcripts
cURL
curl --request POST \
--url https://api.influship.com/v1/raw/tiktok/video/transcripts \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"urls": [
"<string>"
]
}
'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.raw.tiktok.getVideoTranscripts({ urls: ['https://example.com'] });
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/tiktok/video/transcripts"
payload = { "urls": ["<string>"] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"requested": 4503599627370495,
"succeeded": 4503599627370495,
"failed": 4503599627370495,
"items": [
{
"success": true,
"url": "<string>",
"data": {
"video_id": "<string>",
"url": "<string>",
"transcript": "<string>",
"full_text": "<string>",
"segments": [
{
"start_ms": 4503599627370495,
"end_ms": 4503599627370495,
"text": "<string>"
}
],
"word_count": 4503599627370495,
"language": "<string>",
"source": "captions",
"duration_seconds": 1,
"scraped_at": "2023-11-07T05:31:56Z"
}
}
],
"scraped_at": "2023-11-07T05:31:56Z",
"mode": "auto"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid Instagram username format",
"param": "username",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "upstream_contract_broken",
"message": "The upstream source returned data this endpoint cannot process. This is not retryable; it has been reported.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"upstream_error": "upstream_contract_broken",
"retryable": false
}
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}