cURL
curl --request GET \
--url https://api.influship.com/v1/raw/tiktok/video/comment/replies \
--header 'X-API-Key: <api-key>'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.listCommentReplies({
comment_id: '7517114944362499343',
url: 'https://www.tiktok.com/@creator/video/7517114944362499342',
});
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/tiktok/video/comment/replies"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"video_id": "<string>",
"comments": [
{
"comment_id": "<string>",
"video_id": "<string>",
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"like_count": 4503599627370495,
"reply_count": 4503599627370495,
"is_pinned": true,
"author": {
"user_id": "<string>",
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"is_verified": true
}
}
],
"total": 4503599627370495,
"has_more": true,
"next_cursor": "<string>",
"scraped_at": "2023-11-07T05:31:56Z",
"parent_comment_id": "<string>"
}
}{
"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
List Live TikTok Comment Replies
Fetch one cursor-paginated page of replies to a numeric parent comment ID. Keep the same video URL and parent comment ID when continuing with next_cursor.
Pricing: 0.2 credits per reply page scraped ($0.002)
GET
/
v1
/
raw
/
tiktok
/
video
/
comment
/
replies
cURL
curl --request GET \
--url https://api.influship.com/v1/raw/tiktok/video/comment/replies \
--header 'X-API-Key: <api-key>'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.listCommentReplies({
comment_id: '7517114944362499343',
url: 'https://www.tiktok.com/@creator/video/7517114944362499342',
});
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/tiktok/video/comment/replies"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"video_id": "<string>",
"comments": [
{
"comment_id": "<string>",
"video_id": "<string>",
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"like_count": 4503599627370495,
"reply_count": 4503599627370495,
"is_pinned": true,
"author": {
"user_id": "<string>",
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"is_verified": true
}
}
],
"total": 4503599627370495,
"has_more": true,
"next_cursor": "<string>",
"scraped_at": "2023-11-07T05:31:56Z",
"parent_comment_id": "<string>"
}
}{
"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"
}
}
}Authorizations
Query Parameters
HTTPS TikTok video or share URL
Example:
"https://www.tiktok.com/@creator/video/7517114944362499342"
Opaque cursor from the previous response
Required string length:
1 - 2048Numeric ID of the parent comment
Pattern:
^[1-9][0-9]{0,24}$Example:
"7517114944362499343"
Response
Successful response
Show child attributes
Show child attributes