> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Keyword search > Returns the TikTok videos matching a keyword `query` in a `region` (default NG), about 12 per page in TikTok’s relevance order. Each video comes with its description, created date, language, stats (views, likes, comments, shares, saves, reposts — large view/like/comment/share counts are rounded; saves are exact), author (with stats, also rounded), video details (duration, size, covers, play/download URLs, every rendition, subtitles), music (with its TikTok sound page and Apple Music / Spotify links), hashtags, mentions, tagged place, effects, stickers, link anchors, AI-generated labels, flags and related searches. `servedRegion` is the region the results are for. Pass the returned `cursor` (with the same query and region) to get the next page; it is null on the last page. **About the results:** TikTok matches loosely, so even an unusual query returns a few close matches. Results can shift slightly between identical searches. Results are videos only; filtering by post date and sorting are not available. Search isn’t available in every region (e.g. the United States); then the response is a 404 and another `region` may work. The first search in a region can take up to about a minute; later ones are much faster. **Downloading video files:** TikTok only serves `video.playUrl`, `video.downloadUrl` and `video.formats[].url` to requests that send the `Cookie` and `Referer` headers returned in `mediaHeaders` (without them: 403 Access Denied). Send both headers from your code, e.g. `curl -H "Cookie: " -H "Referer: " "" -o video.mp4`. Covers, music and subtitles need no headers. Media URLs expire within hours. **Watermarks:** `playUrl` and every `formats[].url` are watermark-free; `downloadUrl` is TikTok’s download copy with the TikTok logo and @username burned in. **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). ```text Prompt I want to make an API call to /v1/tiktok/search/keyword. Here are the details: Endpoint: GET https://api.scraperize.com/v1/tiktok/search/keyword Description: Returns the TikTok videos matching a keyword `query` in a `region` (default NG), about 12 per page in TikTok’s relevance order. Each video comes with its description, created date, language, stats (views, likes, comments, shares, saves, reposts — large view/like/comment/share counts are rounded; saves are exact), author (with stats, also rounded), video details (duration, size, covers, play/download URLs, every rendition, subtitles), music (with its TikTok sound page and Apple Music / Spotify links), hashtags, mentions, tagged place, effects, stickers, link anchors, AI-generated labels, flags and related searches. `servedRegion` is the region the results are for. Pass the returned `cursor` (with the same query and region) to get the next page; it is null on the last page. Required Headers: - x-api-key: Your API key Parameters: - query (string) [required]: The keyword(s) to search for (1–100 characters). - region (select): The region (country) to get results for, as a two-letter code (ISO 3166-1). Defaults to NG (Nigeria). - cursor (string): The `cursor` from the previous response (same query and region), to get the next page. Omit for the first page. - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. Example Response: { "data": { "query": "lagos", "region": "NG", "regionName": "Nigeria", "servedRegion": "NG", "videos": [ { "id": "7684727102066658578", "url": "https://www.tiktok.com/@realokadaman/video/7684727102066658578", "type": "video", "description": "Our question today why Lagos state tack-force are not posting our bike when they arrested like before this is our question may be there’s something going on the…", "createdAt": "2026-09-12T19:06:07.000Z", "language": "en", "stats": { "playCount": 305600, "likeCount": 35200, "commentCount": 776, "shareCount": 22500, "collectCount": 7445, "repostCount": 0 }, "author": { "id": "7510720009678210104", "secUid": "MS4wLjABAAAANShGKSKT626JzyipEKLY8jYc14LpZOze4CG1X9N5SEFmYFEXHtpyEsqEDFhd3-Bh", "handle": "realokadaman", "nickname": "okada man", "bio": "Bike riders ambassador in Africa WhatsApp 09068141390", "avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7ff…", "verified": false, "privateAccount": false, "stats": { "followerCount": 53200, "followingCount": 27, "likeCount": 336300, "videoCount": 414, "friendCount": 0, "diggCount": 5006 } }, "video": { "duration": 91, "width": 576, "height": 1024, "definition": "540p", "format": "mp4", "codec": "h264", "bitrate": 555440, "quality": "lowest", "size": 6322793, "coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oIoZEjFMzPc9bYNlBBDAIFphRsqgoBiEgaEefD~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…", "originCoverUrl": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owoLQGcRlEyasNDyBqgFxpUeQfR8q9EBPEFhLA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…", "dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osoEpEGDgxZB8FyFfeqRBHAhQslPqpQCa9HK0c~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signatur…", "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD…", "downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oYcBpBPAmaeDcshKQQZRv9fFEYBFloEqgIjEZv/?a=1988&bti=ODszNWYuMDE6&&bt=1475&eid=20480&ft…", "volume": { "loudness": -12, "peak": 0.53703 }, "formats": [ { "gearName": "adapt_lower_720_1", "qualityType": 14, "codec": "h265_hvc1", "format": null, "bitrate": 579733, "fps": null, "width": 720, "height": 1280, "size": 6599320, "url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o4felk9ABQBESZgshYDYcqELpIGF0qRDaFjEyP/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mIUPD…" } ], "subtitles": [] }, "photo": null, "music": { "id": "7684727154324540181", "title": "original sound", "url": "https://www.tiktok.com/music/original-sound-7684727154324540181", "authorName": "okada man", "album": null, "duration": 91, "preciseDuration": null, "shootDuration": null, "original": true, "isCopyrighted": false, "isCommerceMusic": false, "isUnlimitedMusic": false, "isPrivate": false, "coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7ff…", "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/ooqAQml4iBhEaCFJeBXEUqJAApUqgpfCiKoDEv/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO…", "streaming": [] }, "hashtags": [ { "id": "1662313548384262", "name": "nigeriangovernment", "description": null } ], "mentions": [], "effects": [ { "id": "2140391842", "name": "MOVIE" } ], "stickerTexts": [], "location": null, "contentCategory": { "id": 120, "name": "General" }, "anchors": [], "warnings": [], "playlistId": null, "isAd": false, "isPinned": false, "isPrivate": false, "isCommerce": false, "aigcDescription": null, "aigcLabelType": null, "duetEnabled": true, "stitchEnabled": true, "shareEnabled": true, "canRepost": true, "commentStatus": 0, "suggestedSearches": [] } ], "mediaHeaders": { "Cookie": "tt_chain_token=", "Referer": "https://www.tiktok.com/" }, "count": 12, "cursor": "12_20261005224548CC93FFEA156288A9DC30", "hasMore": true, "fetchedAt": "2026-10-05T14:45:50.785Z" }, "meta": { "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", "creditsCharged": 1, "creditsRemaining": 4999, "cached": false } } Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/tiktok/search/keyword openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints paths: /v1/tiktok/search/keyword: get: tags: - TikTok summary: Keyword search description: >- Returns the TikTok videos matching a keyword `query` in a `region` (default NG), about 12 per page in TikTok’s relevance order. Each video comes with its description, created date, language, stats (views, likes, comments, shares, saves, reposts — large view/like/comment/share counts are rounded; saves are exact), author (with stats, also rounded), video details (duration, size, covers, play/download URLs, every rendition, subtitles), music (with its TikTok sound page and Apple Music / Spotify links), hashtags, mentions, tagged place, effects, stickers, link anchors, AI-generated labels, flags and related searches. `servedRegion` is the region the results are for. Pass the returned `cursor` (with the same query and region) to get the next page; it is null on the last page. **About the results:** TikTok matches loosely, so even an unusual query returns a few close matches. Results can shift slightly between identical searches. Results are videos only; filtering by post date and sorting are not available. Search isn’t available in every region (e.g. the United States); then the response is a 404 and another `region` may work. The first search in a region can take up to about a minute; later ones are much faster. **Downloading video files:** TikTok only serves `video.playUrl`, `video.downloadUrl` and `video.formats[].url` to requests that send the `Cookie` and `Referer` headers returned in `mediaHeaders` (without them: 403 Access Denied). Send both headers from your code, e.g. `curl -H "Cookie: " -H "Referer: " "" -o video.mp4`. Covers, music and subtitles need no headers. Media URLs expire within hours. **Watermarks:** `playUrl` and every `formats[].url` are watermark-free; `downloadUrl` is TikTok’s download copy with the TikTok logo and @username burned in. parameters: - name: query in: query required: true description: The keyword(s) to search for (1–100 characters). schema: type: string minLength: 1 maxLength: 100 example: lagos - name: region in: query required: false description: >- The region (country) to get results for, as a two-letter code (ISO 3166-1). Defaults to NG (Nigeria). schema: type: string enum: - AL - DZ - AR - AU - AT - AZ - BY - BE - BO - BR - KH - CM - CA - CL - CO - CR - CZ - EG - FR - DE - GH - GR - HK - IS - IE - IL - IT - JM - JP - KZ - KE - KW - LI - LT - LU - MX - MA - MZ - NA - NL - NG - MK - 'NO' - PA - PE - PH - PT - PR - RO - SA - SG - ZA - KR - ES - SE - CH - TW - TH - TT - TN - TR - UG - UA - AE - GB - US - UY - UZ - VE x-enumNames: - Albania (AL) - Algeria (DZ) - Argentina (AR) - Australia (AU) - Austria (AT) - Azerbaijan (AZ) - Belarus (BY) - Belgium (BE) - Bolivia (BO) - Brazil (BR) - Cambodia (KH) - Cameroon (CM) - Canada (CA) - Chile (CL) - Colombia (CO) - Costa Rica (CR) - Czechia (CZ) - Egypt (EG) - France (FR) - Germany (DE) - Ghana (GH) - Greece (GR) - Hong Kong (HK) - Iceland (IS) - Ireland (IE) - Israel (IL) - Italy (IT) - Jamaica (JM) - Japan (JP) - Kazakhstan (KZ) - Kenya (KE) - Kuwait (KW) - Liechtenstein (LI) - Lithuania (LT) - Luxembourg (LU) - Mexico (MX) - Morocco (MA) - Mozambique (MZ) - Namibia (NA) - Netherlands (NL) - Nigeria (NG) - North Macedonia (MK) - Norway (NO) - Panama (PA) - Peru (PE) - Philippines (PH) - Portugal (PT) - Puerto Rico (PR) - Romania (RO) - Saudi Arabia (SA) - Singapore (SG) - South Africa (ZA) - South Korea (KR) - Spain (ES) - Sweden (SE) - Switzerland (CH) - Taiwan (TW) - Thailand (TH) - Trinidad and Tobago (TT) - Tunisia (TN) - Türkiye (TR) - Uganda (UG) - Ukraine (UA) - United Arab Emirates (AE) - United Kingdom (GB) - United States (US) - Uruguay (UY) - Uzbekistan (UZ) - Venezuela (VE) default: NG example: NG - name: cursor in: query required: false description: >- The `cursor` from the previous response (same query and region), to get the next page. Omit for the first page. schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: One page of matching videos. content: application/json: schema: type: object properties: data: type: object properties: query: type: string region: type: string regionName: type: string servedRegion: type: string nullable: true videos: type: array items: type: object mediaHeaders: type: object nullable: true description: >- Send these headers when downloading video files (playUrl / downloadUrl / formats[].url); TikTok returns 403 without them. properties: Cookie: type: string Referer: type: string count: type: integer cursor: type: string nullable: true hasMore: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: query: lagos region: NG regionName: Nigeria servedRegion: NG videos: - id: '7684727102066658578' url: >- https://www.tiktok.com/@realokadaman/video/7684727102066658578 type: video description: >- Our question today why Lagos state tack-force are not posting our bike when they arrested like before this is our question may be there’s something going on the ground we don’t know that’s why we are here to expose the secret we are losing thousands of bikes presently in Lagos state why Nigerian we are all your youths pity for us to keep surviving under the prosperity of feeding ourselves #nigeriangovernment #Okada #lagos OKADA MAN createdAt: '2026-09-12T19:06:07.000Z' language: en stats: playCount: 305600 likeCount: 35200 commentCount: 776 shareCount: 22500 collectCount: 7445 repostCount: 0 author: id: '7510720009678210104' secUid: >- MS4wLjABAAAANShGKSKT626JzyipEKLY8jYc14LpZOze4CG1X9N5SEFmYFEXHtpyEsqEDFhd3-Bh handle: realokadaman nickname: okada man bio: Bike riders ambassador in Africa WhatsApp 09068141390 avatarUrl: >- https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 verified: false privateAccount: false stats: followerCount: 53200 followingCount: 27 likeCount: 336300 videoCount: 414 friendCount: 0 diggCount: 5006 video: duration: 91 width: 576 height: 1024 definition: 540p format: mp4 codec: h264 bitrate: 555440 quality: lowest size: 6322793 coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oIoZEjFMzPc9bYNlBBDAIFphRsqgoBiEgaEefD~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=dohMxCu4ZqL%2B4rEZ%2BDV%2FLKjcykA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 originCoverUrl: >- https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owoLQGcRlEyasNDyBqgFxpUeQfR8q9EBPEFhLA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=o6FiMikYWHFgpcZoF6vPPxTCpqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 dynamicCoverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osoEpEGDgxZB8FyFfeqRBHAhQslPqpQCa9HK0c~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=v3jtS0%2BELQXzMvam7RvbERkO3ac%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000 downloadUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oYcBpBPAmaeDcshKQQZRv9fFEYBFloEqgIjEZv/?a=1988&bti=ODszNWYuMDE6&&bt=1475&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmVlNzdpNzQ8ZWY7NGk0NkBpanJzNGo5cnl0ZDMzODczNEAzNDQ0YTEtXi8xYTAwMWAwYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=2f189ad59eb5573c18c97c570e8491ef&tk=tt_chain_token&btag=e00088000 volume: loudness: -12 peak: 0.53703 formats: - gearName: adapt_lower_720_1 qualityType: 14 codec: h265_hvc1 format: null bitrate: 579733 fps: null width: 720 height: 1280 size: 6599320 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o4felk9ABQBESZgshYDYcqELpIGF0qRDaFjEyP/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=O2Y5OjpkODg1OzZlOjU8ZkBpanJzNGo5cnl0ZDMzODczNEAxNS4wMzZjNmMxYC00MGI2YSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c1a53782b3279acbd5dbd521b5393043&tk=tt_chain_token&btag=e00048000 - gearName: lowest_540_0 qualityType: 25 codec: h264 format: null bitrate: 555440 fps: null width: 576 height: 1024 size: 6322793 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oo6EeoZrIshEcEpBYlBDfBjRF9AFQBagGwPqEP/?a=1988&bti=ODszNWYuMDE6&&bt=542&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=aTtlO2czNTM0ZmllZzMzaEBpanJzNGo5cnl0ZDMzODczNEBgYDMzYDY2X18xMy5eNGBeYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=481ceddafd3f4b808bd9ef88b3b03db1&tk=tt_chain_token&btag=e00048000 - gearName: adapt_540_1 qualityType: 28 codec: h265_hvc1 format: null bitrate: 411808 fps: null width: 576 height: 1024 size: 4687767 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ooPqpgDyQBBEIGhBfEAgIBeF8al92GxFHisRcq/?a=1988&bti=ODszNWYuMDE6&&bt=402&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZmdoNDVlZGlpOzM5Zjk5OEBpanJzNGo5cnl0ZDMzODczNEAzLmEwMzBeXjUxYV5hYGIxYSNlZnNvMmRjL2ZhLS1kMWBzcw%3D%3D&expire=1791384440&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=4ed18f70e33f87e1c9e54e055f8558f6&tk=tt_chain_token&btag=e00048000 subtitles: [] photo: null music: id: '7684727154324540181' title: original sound url: >- https://www.tiktok.com/music/original-sound-7684727154324540181 authorName: okada man album: null duration: 91 preciseDuration: null shootDuration: null original: true isCopyrighted: false isCommerceMusic: false isUnlimitedMusic: false isPrivate: false coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/12908100026978c790f49747ccef657a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=91af7fff&x-expires=1791381600&x-signature=AWK32U%2BJ7VjgLk3DUtrcgwqkdGk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/ooqAQml4iBhEaCFJeBXEUqJAApUqgpfCiKoDEv/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajQ8OHg5cjt0ZDMzODU8NEBpajQ8OHg5cjt0ZDMzODU8NEBrYzJwMmRrMmZhLS1kMS1zYSNrYzJwMmRrMmZhLS1kMS1zcw%3D%3D&expire=1791215239&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=2f47dd8426e8bb14347b4c2869f79589&tk=0&btag=e00050000 streaming: [] hashtags: - id: '1662313548384262' name: nigeriangovernment description: null - id: '41082360' name: okada description: null - id: '75619' name: lagos description: null mentions: [] effects: - id: '2140391842' name: MOVIE stickerTexts: [] location: null contentCategory: id: 120 name: General anchors: [] warnings: [] playlistId: null isAd: false isPinned: false isPrivate: false isCommerce: false aigcDescription: null aigcLabelType: null duetEnabled: true stitchEnabled: true shareEnabled: true canRepost: true commentStatus: 0 suggestedSearches: [] - id: '7540669549193039122' url: >- https://www.tiktok.com/@jr.amani/video/7540669549193039122 type: video description: >- #traditional #lagos #ijorabadia #ijora #virall @Minister4Enjoyment createdAt: '2025-08-20T14:09:11.000Z' language: un stats: playCount: 257300 likeCount: 5711 commentCount: 113 shareCount: 176 collectCount: 513 repostCount: 0 author: id: '7044823145950741510' secUid: >- MS4wLjABAAAAfNQrVdQqF3vGI9OyfFETlmgxmy1tA9zpr78F9cRJwO9aJFVEqkb1LkHfDT6orKa1 handle: jr.amani nickname: Emmy bio: >- Love, laughs & Nigerian content — your daily dose of family fun 💛 children 💗 avatarUrl: >- https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4d936abfb5ac8e25b72237d0c222a7f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=210d0a31&x-expires=1791381600&x-signature=cGU8RZ0fyGzNUZ%2FrspjTgdpBsR4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 verified: false privateAccount: false stats: followerCount: 1640 followingCount: 320 likeCount: 14500 videoCount: 448 friendCount: 0 diggCount: 2276 video: duration: 32 width: 480 height: 854 definition: 480p format: mp4 codec: h264 bitrate: 1572595 quality: normal size: 6390045 coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0uIENCGEFAxnpIgIRWDUXpLde1ma3olsByfBw~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=sg1uPwSj%2FsBT5yYDGiuwPZm6W14%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 originCoverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owp8QMURREndxeDLBtgF8pwOQf1poXEByGa3lA~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=6KPmy4huQybswpPs2XAvmXoBgmw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 dynamicCoverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYGp1dlxDQCwMl3aALFJUgRX8Bf0ofBQErgyEp~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=ogyzyvy5aOGklFqben7gC8QDxvc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000 downloadUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/owwffFBK4AKaBKYfiwbXSHiAkuNfrLievggAMx/?a=1988&bti=ODszNWYuMDE6&&bt=3907&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=NztlZGU2NzM2ODw5PGZmN0BpM3hsaHU5cjh3NTMzODczNEBeMDQzNDNiXi4xNTU1YjNjYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=f94e14df1f04b557235785036750512c&tk=tt_chain_token&btag=e00088000 volume: loudness: -23.1 peak: 0.35075 formats: - gearName: lower_540_0 qualityType: 24 codec: h264 format: null bitrate: 2097803 fps: null width: 576 height: 1024 size: 8524163 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/okxQkF8yBDrppULLkMFlgaIERA3UgfXfEQBoQd/?a=1988&bti=ODszNWYuMDE6&&bt=2048&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGZnNDU8OjYzOTlnNGc0Z0BpM3hsaHU5cjh3NTMzODczNEA1MjAwMjI1Nl4xYmIxLV4tYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=feb2674b6098f0de6641e0d807a5d1b5&tk=tt_chain_token&btag=e00048000 - gearName: adapt_lower_720_1 qualityType: 14 codec: h265_hvc1 format: null bitrate: 1608520 fps: null width: 720 height: 1280 size: 6536021 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ocImEQBORQppAzDoxF6vfe8yGa3EXEGgULdXBx/?a=1988&bti=ODszNWYuMDE6&&bt=1570&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=ZGc1Omg6NjlmOWhnaDVlNEBpM3hsaHU5cjh3NTMzODczNEAtMzJfNi4wXzMxNDAvNmAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=fdcb915fe3371482443db4d7987b1ed8&tk=tt_chain_token&btag=e00048000 - gearName: normal_480_0 qualityType: 30 codec: h264 format: null bitrate: 1572595 fps: null width: 480 height: 854 size: 6390045 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oQDyGE3QaE1pXFuEeUKfCpYyvLGGBRgxloIdAB/?a=1988&bti=ODszNWYuMDE6&&bt=1535&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Zjc5NjQ4NTpnN2ZnODwzOEBpM3hsaHU5cjh3NTMzODczNEAuY2IxLTI1X2MxLWNhMzAyYSMwX15wMmRzYWZhLS1kMTFzcw%3D%3D&expire=1791384381&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=7bf2912775b83993bb0439eca72270cc&tk=tt_chain_token&btag=e00048000 subtitles: [] photo: null music: id: '7483909320038468358' title: original sound url: >- https://www.tiktok.com/music/original-sound-7483909320038468358 authorName: JACK IPARIPATE album: null duration: 32 preciseDuration: null shootDuration: null original: true isCopyrighted: false isCommerceMusic: false isUnlimitedMusic: false isPrivate: false coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/79310f9ff32cc69b31662d2633168f6b~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=95b12f50&x-expires=1791381600&x-signature=a1daAMrTQ5xKvUXqyUiDXeZbyQc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-v-27dcd7/oEASeJOeMfIsGIKLJBG4FfLLA8fcASuIVmXAIh/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=ajw1cXU5cnM1eTMzNzU8M0Bpajw1cXU5cnM1eTMzNzU8M0AwMmxmMmQ0c2JgLS1kMTZzYSMwMmxmMmQ0c2JgLS1kMTZzcw%3D%3D&expire=1791215180&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=ae82fc283da89998edbb7dd27df654de&tk=0&btag=e00050000 streaming: [] hashtags: - id: '364353' name: traditional description: null - id: '75619' name: lagos description: null - id: '7015638879273222150' name: ijorabadia description: null mentions: - userId: '7244950240003720197' handle: minister4enjoyment100 secUid: >- MS4wLjABAAAAJA0CNtHkedY2-sW8Ha0xPU9pVq83uu1jnASppwTq8RKGltHRZTJ-PNXg6I3ghhhu effects: - id: '2140391842' name: MOVIE stickerTexts: [] location: id: '22535865247435187' name: Badia address: Lagos, Nigeria city: null province: null category: Place and Address contentCategory: id: 120 name: General anchors: [] warnings: [] playlistId: null isAd: false isPinned: false isPrivate: false isCommerce: false aigcDescription: null aigcLabelType: null duetEnabled: true stitchEnabled: true shareEnabled: true canRepost: true commentStatus: 0 suggestedSearches: - aye cult battle ijora badia2026 at aliwo - the street fighter ijora badia vs aliwo - obale vs akamaye fight ijora badia - id: '7670142818631044370' url: >- https://www.tiktok.com/@__slimtalldora/video/7670142818631044370 type: video description: >- #CapCut #foryoupage #trend #__slimtalldora pool time at the continental Lagos❤️ createdAt: '2026-08-04T11:51:34.000Z' language: en stats: playCount: 65500 likeCount: 1898 commentCount: 40 shareCount: 54 collectCount: 267 repostCount: 0 author: id: '7057403778752037893' secUid: >- MS4wLjABAAAAMHMBDmwudz_iVgfeqWEcM6-OdRkpRRclH16IfQ2YqANKrv_hpYfFwctFGtzA0jel handle: __slimtalldora nickname: __slimtalldora bio: Hi I'm Dora🤭 avatarUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/947783683b0b9fab698e666e792d23da~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=0a391b6d&x-expires=1791381600&x-signature=%2Fp7zIQvG4LzM1eLHepsWFjHGB7c%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 verified: false privateAccount: false stats: followerCount: 4540 followingCount: 1318 likeCount: 85100 videoCount: 2785 friendCount: 0 diggCount: 44300 video: duration: 11 width: 576 height: 1024 definition: 540p format: mp4 codec: h264 bitrate: 982428 quality: lowest size: 1461362 coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owq4cbxZ7B4IdAFRqBfIykjFlcEHgTfVPF0DES~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=0R3vbM0nH4Wc8jf3cY5NX0P8Rig%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 originCoverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oYIxICBGR0HcAcDqZFpEf4LySFqE7EagcfdkBi~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=99qvTx0Yg89aWJ3a9Ay5afgBBzE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 dynamicCoverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o0kIke6xfAgjGpGQHPUIA3C40D4LQaQkUwLzeB~tplv-tiktokx-origin.image?dr=14575&x-expires=1791381600&x-signature=zEhmW%2FTAtmVYNtAU3nOT1mTv4bg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000 downloadUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oMUzQjwIAGIffArIkpPCeLSULD4d3Ikzj64P1g/?a=1988&bti=ODszNWYuMDE6&&bt=2989&eid=20480&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmaWQ4Zjg7M2U4ZGlmNjZpZEBpM3JpaG85cnh3PDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNhL2I0MF9jNmIxM2E2MGAwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=c8594d6f580f0ca2d7f6c3027d1b79c0&tk=tt_chain_token&btag=e000b0000 volume: loudness: -23.5 peak: 0.30549 formats: - gearName: lowest_540_0 qualityType: 25 codec: h264 format: null bitrate: 982428 fps: null width: 576 height: 1024 size: 1461362 url: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYqZcLxZ7B4IdAFRqBfEylOQBcEHg4fN5F0DES/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mIUPD12N1tEon-UxrN5PY6e3wv257cAp&mime_type=video_mp4&rc=Mzs6ZDlkNTs1N2Q8ODU4OEBpM3JpaG85cnh3PDMzODczNEAxMGFjYDEzNl8xMi4wNDUwYSM2czUzMmRzL2xhLS1kMWBzcw%3D%3D&expire=1791384360&l=20261005224548CC93FFEA156288A9DC30&ply_type=2&policy=2&signature=ffe7b65902a1a32a40b194968b54aea8&tk=tt_chain_token&btag=e00070000 subtitles: [] photo: null music: id: '7649070669913361173' title: THAT GIRL X COME CLOSER SPXNZO EDIT url: >- https://www.tiktok.com/music/THAT-GIRL-X-COME-CLOSER-SPXNZO-EDIT-7649070669913361173 authorName: deejayspxnzo album: null duration: 27 preciseDuration: null shootDuration: null original: true isCopyrighted: false isCommerceMusic: false isUnlimitedMusic: false isPrivate: false coverUrl: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/a940d0cf04de032f88718dbddc5e11a6~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=ededef4a&x-expires=1791381600&x-signature=9pIk%2FMS%2F5UkUUy7WN0o3ay1oszU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2 playUrl: >- https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oQABAAbuEQCBYlUACPUa1EAi0imn9ii7AADtQ/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThqfO-GXq8Zmo&mime_type=audio_mpeg&rc=MzY5O3U5cmppOzMzODU8NEBpMzY5O3U5cmppOzMzODU8NEBucGQ1MmQ0XmdhLS1kMS1zYSNucGQ1MmQ0XmdhLS1kMS1zcw%3D%3D&expire=1791215175&l=20261005224548CC93FFEA156288A9DC30&ply_type=3&policy=3&signature=e11e3b0a48d25e4fb9b2b77293aeed55&tk=0&btag=e00078000 streaming: [] hashtags: - id: '1663935709411330' name: capcut description: >- CapCut is a new, easy-to-use video editing tool designed for mobile platforms. CapCut provides users with a wide range of video editing functions, filters, audio & visual effects, video templates, while keeping it free of charge and ads-free. Everyone can be a creator by using CapCut. Start creating your cool videos today: https://capcut.onelink.me/XKqI/228cad85 - id: '88764338' name: foryoupage description: null - id: '44895' name: trend description: null mentions: [] effects: - id: '2140391842' name: MOVIE stickerTexts: - 💕 location: null contentCategory: id: 120 name: General anchors: - id: '0' type: 54 keyword: CapCut · Editing made easy description: CapCut · Video Editor url: >- https://www.capcut.com/tools/desktop-video-editor?channel=capcutpc_ttweb_anchor_edit1&download_channel=capcutpc_ttweb_anchor_edit1&enter_from=capcutpc_ttweb_anchor_edit1&force_dp=1&from_page=capcutpc_ttweb_anchor_edit1&type=tools iconUrl: >- https://p16-common-sign.tiktokcdn.com/tiktok-obj/capcut_logo_64px_bk.png~tplv-tiktokx-origin.image?dr=14566&x-expires=1791230400&x-signature=CWfYyIFO1N%2FLSGJtr3w7Jbbpa3M%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my2 warnings: [] playlistId: null isAd: false isPinned: false isPrivate: false isCommerce: false aigcDescription: null aigcLabelType: null duetEnabled: true stitchEnabled: true shareEnabled: true canRepost: true commentStatus: 0 suggestedSearches: [] mediaHeaders: Cookie: tt_chain_token= Referer: https://www.tiktok.com/ count: 12 cursor: 12_20261005224548CC93FFEA156288A9DC30 hasMore: true fetchedAt: '2026-10-05T14:45:50.785Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid cursor. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: >- Search isn’t available in the selected region; another region may work. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: >- Invalid query parameters (missing / empty / too-long query, or an unsupported region). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.