cURL
curl --request GET \
--url https://api.influship.com/v1/raw/tiktok/profile/{username}/videos \
--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.listProfileVideos('creator');
console.log(response.data);import os
from influship import Influship
client = Influship(
api_key=os.environ.get("INFLUSHIP_API_KEY"), # This is the default and can be omitted
)
response = client.raw.tiktok.list_profile_videos(
username="creator",
)
print(response.data){
"data": {
"username": "<string>",
"videos": [
{
"video_id": "<string>",
"url": "<string>",
"author": {
"user_id": "<string>",
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"is_verified": true
},
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"duration_seconds": 1,
"thumbnail_url": "<string>",
"video_url": "<string>",
"has_watermark": true,
"images": [
"<string>"
],
"view_count": 4503599627370495,
"like_count": 4503599627370495,
"comment_count": 4503599627370495,
"share_count": 4503599627370495,
"save_count": 4503599627370495,
"hashtags": [
"<string>"
],
"music": {
"music_id": "<string>",
"title": "<string>",
"author": "<string>",
"duration_seconds": 1
},
"is_pinned": true
}
],
"has_more": true,
"next_cursor": "<string>",
"scraped_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}Live Scraping
List Live TikTok Profile Videos
Fetch one cursor-paginated page of normalized TikTok videos. Signed media URLs are temporary and should be downloaded promptly.
Pricing: 0.5 credits per video page scraped ($0.005)
GET
/
v1
/
raw
/
tiktok
/
profile
/
{username}
/
videos
cURL
curl --request GET \
--url https://api.influship.com/v1/raw/tiktok/profile/{username}/videos \
--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.listProfileVideos('creator');
console.log(response.data);import os
from influship import Influship
client = Influship(
api_key=os.environ.get("INFLUSHIP_API_KEY"), # This is the default and can be omitted
)
response = client.raw.tiktok.list_profile_videos(
username="creator",
)
print(response.data){
"data": {
"username": "<string>",
"videos": [
{
"video_id": "<string>",
"url": "<string>",
"author": {
"user_id": "<string>",
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"is_verified": true
},
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"duration_seconds": 1,
"thumbnail_url": "<string>",
"video_url": "<string>",
"has_watermark": true,
"images": [
"<string>"
],
"view_count": 4503599627370495,
"like_count": 4503599627370495,
"comment_count": 4503599627370495,
"share_count": 4503599627370495,
"save_count": 4503599627370495,
"hashtags": [
"<string>"
],
"music": {
"music_id": "<string>",
"title": "<string>",
"author": "<string>",
"duration_seconds": 1
},
"is_pinned": true
}
],
"has_more": true,
"next_cursor": "<string>",
"scraped_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}Authorizations
Path Parameters
TikTok username, with or without a leading @
Example:
"creator"
Query Parameters
Opaque cursor from the previous response
Required string length:
1 - 512Video ordering
Available options:
latest, popular Example:
"latest"
Two-letter region code
Required string length:
2Pattern:
^[a-zA-Z]{2}$Example:
"GB"
Response
Successful response
Show child attributes
Show child attributes
⌘I