TikTok Public Data API
Collect supported public TikTok profiles, direct video metadata, top-level comments, video search results, and videos for specified hashtags through one normalized asynchronous workflow.
Available TikTok APIs
Choose profile lookup, direct video enrichment, top-level comments, keyword video search, or video collection for explicit hashtags.
What TikTok data can you retrieve?
SocQ converts supported public TikTok results into normalized records for creator research, content analysis, monitoring, and data pipelines.
Public profiles
Retrieve identity, biography, account flags, and visible follower, following, video, and like counts by username.
Public videos
Collect captions, creator context, engagement snapshots, media references, duration, hashtags, mentions, sounds, and content flags.
Top-level comments
Collect public top-level comment text, author context, likes, reply counts, mentions, and creator interaction flags.
Video discovery
Search public videos with supported filters or collect public videos for specified hashtags.
SocQ and TikTok developer products
SocQ focuses on supported public-data collection and normalized records. Use TikTok's official developer products when your application requires platform authorization or official account and content operations.
| Capability | SocQ | TikTok developer products |
|---|---|---|
| Primary use | Supported public-data collection and normalization | Official integrations under the applicable TikTok product and approval |
| Authentication | SocQ API key | TikTok developer credentials and applicable authorization |
| Content actions | Does not upload, edit, delete, like, follow, message, or manage TikTok content | Depends on the approved official product and permissions |
| Private or restricted data | Not supported | Limited to the official product, authorization, and platform policy |
| Response format | Normalized SocQ records | Product-specific native responses |
How the TikTok APIs work
All five endpoints share an asynchronous submit, poll, and cursor-pagination lifecycle.
1. Submit public inputs
POST usernames, direct video URLs, a search query, or explicit hashtags with endpoint-specific options.
2. Poll the task
Use the returned task_id with /v1/tasks/{task_id} until processing succeeds or fails.
3. Read and paginate
Read normalized records from data.results.items and follow next_cursor while has_more is true.
Authenticate with a SocQ API key. This example retrieves a public profile; select another endpoint for direct videos, top-level comments, search, or hashtags.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCommon TikTok API use cases
Creator research
Normalize public profile identity and collection-time account counters for known usernames.
Content and feedback monitoring
Capture selected video metadata and public top-level comment snapshots for review and reporting.
Topic discovery
Search public videos by keyword or collect videos associated with explicit hashtags.
Data pipelines
Send normalized records into warehouses, classifiers, search indexes, review tools, and dashboards.
Limits and public-data policy
TikTok public results are dynamic and depend on current visibility, source eligibility, ordering, region, and availability.
- Private, deleted, restricted, filtered, or otherwise inaccessible resources may not produce records.
- Visible counters, search rankings, comment ordering, and public availability can change after collection.
- A requested results_limit is a cap and does not guarantee that many eligible public records exist.
- SocQ is not an official TikTok API and does not perform account authorization, content management, likes, follows, uploads, or direct messages.
TikTok API frequently asked questions
Is SocQ the official TikTok API?
No. SocQ collects and normalizes supported public results. Use TikTok's developer products for official authorization and approved platform operations.
Do users need to connect TikTok accounts?
No customer TikTok OAuth is required for these public-data endpoints. Requests authenticate with a SocQ API key.
Which TikTok resources are available?
Profiles, Videos, Comments, Search, and Hashtags are available, each with a documented input and normalized result contract.
How is usage priced?
Profiles cost 0.6 credits per result, Videos, Search, and Hashtags cost 0.7, and Comments cost 0.25.