> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape a public TikTok profile and its newest videos > Fetches a public TikTok creator profile for `username` and returns it as JSON: `username`, `userId`, `secUid`, `nickname`, `bio`, `bioLink`, `verified`, `privateAccount`, `isOrganization`, `createdAt`, `avatar` (thumb/medium/large), exact `stats` (followers, following, likes, videos, friends), `commerce` (commerceUser, seller), privacy `settings`, and a `videos` array of the creator's newest posts (up to 10). With `video_details=true` (default) every listed video carries the full `/social/tiktok-video` shape - exact plays, likes, comments, shares, saves, reposts, hashtags, mentions, music, play/download URLs, subtitles and timestamps. `username` accepts a bare handle, `@handle` or a profile URL. No login or cookies - only public profiles are read; private or missing accounts return 404 with TikTok's reason. ## OpenAPI ````yaml /api-reference/openapi.json post /social/tiktok-profile openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Three endpoints are documented here: page-source extraction, Google SERP scraping, and image fetch. All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /social/tiktok-profile: post: tags: - Plugins summary: Scrape a public TikTok profile and its newest videos description: >- Fetches a public TikTok creator profile for `username` and returns it as JSON: `username`, `userId`, `secUid`, `nickname`, `bio`, `bioLink`, `verified`, `privateAccount`, `isOrganization`, `createdAt`, `avatar` (thumb/medium/large), exact `stats` (followers, following, likes, videos, friends), `commerce` (commerceUser, seller), privacy `settings`, and a `videos` array of the creator's newest posts (up to 10). With `video_details=true` (default) every listed video carries the full `/social/tiktok-video` shape - exact plays, likes, comments, shares, saves, reposts, hashtags, mentions, music, play/download URLs, subtitles and timestamps. `username` accepts a bare handle, `@handle` or a profile URL. No login or cookies - only public profiles are read; private or missing accounts return 404 with TikTok's reason. operationId: tiktok_profile_social_tiktok_profile_post parameters: - name: username in: query required: true schema: type: string description: >- TikTok handle ('nasa' or '@nasa') or a profile URL like 'https://www.tiktok.com/@nasa'. title: Username description: >- TikTok handle ('nasa' or '@nasa') or a profile URL like 'https://www.tiktok.com/@nasa'. - name: max_videos in: query required: false schema: type: integer maximum: 200 minimum: 0 description: >- How many of the creator's newest videos to include (0-200). 0 = profile only (fastest). Up to 10 come from TikTok's server-rendered widget in a couple of seconds; asking for more opens the profile in a browser and scrolls the real grid (about 35 videos a batch, 10-30 s), newest first, all with full details. default: 10 title: Max Videos description: >- How many of the creator's newest videos to include (0-200). 0 = profile only (fastest). Up to 10 come from TikTok's server-rendered widget in a couple of seconds; asking for more opens the profile in a browser and scrolls the real grid (about 35 videos a batch, 10-30 s), newest first, all with full details. - name: video_details in: query required: false schema: type: boolean description: >- Fetch each listed video's own page for full engagement (exact plays, likes, comments, shares, saves), hashtags, music, media URLs and timestamps. false = only id, caption, cover and play count (one fetch fewer per video). default: true title: Video Details description: >- Fetch each listed video's own page for full engagement (exact plays, likes, comments, shares, saves), hashtags, music, media URLs and timestamps. false = only id, caption, cover and play count (one fetch fewer per video). - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Optional - TikTok's public pages are the same worldwide; set it only for region-restricted items. title: Proxy Country description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Optional - TikTok's public pages are the same worldwide; set it only for region-restricted items. responses: '200': description: >- JSON profile object with a `videos` array (`videosCollected` gives its length). content: application/json: schema: {} '400': description: Missing or malformed username / proxy_country. '404': description: Profile does not exist, was banned, or is private. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked by TikTok or no profile returned. '504': description: Fetch timed out. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ````