TikTok Explore Scraper
Try for free
This Actor is paid per event
Go to Store
TikTok Explore Scraper
clockworks/tiktok-explore-scraper
Try for free
This Actor is paid per event
Extract data from TikTok explore categories including post, author, video, and music data. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.
Do you want to learn more about this Actor?
Get a demoYou can access the TikTok Explore Scraper programmatically from your own applications by using the Apify API. You can choose the language preference from below. To use the Apify API, youāll need an Apify account and your API token, found in Integrations settings in Apify Console.
1{
2 "openapi": "3.0.1",
3 "info": {
4 "version": "0.0",
5 "x-build-id": "r5lOpuwScjgcao5Zf"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/clockworks~tiktok-explore-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-clockworks-tiktok-explore-scraper",
16 "x-openai-isConsequential": false,
17 "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18 "tags": [
19 "Run Actor"
20 ],
21 "requestBody": {
22 "required": true,
23 "content": {
24 "application/json": {
25 "schema": {
26 "$ref": "#/components/schemas/inputSchema"
27 }
28 }
29 }
30 },
31 "parameters": [
32 {
33 "name": "token",
34 "in": "query",
35 "required": true,
36 "schema": {
37 "type": "string"
38 },
39 "description": "Enter your Apify token here"
40 }
41 ],
42 "responses": {
43 "200": {
44 "description": "OK"
45 }
46 }
47 }
48 },
49 "/acts/clockworks~tiktok-explore-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-clockworks-tiktok-explore-scraper",
52 "x-openai-isConsequential": false,
53 "summary": "Executes an Actor and returns information about the initiated run in response.",
54 "tags": [
55 "Run Actor"
56 ],
57 "requestBody": {
58 "required": true,
59 "content": {
60 "application/json": {
61 "schema": {
62 "$ref": "#/components/schemas/inputSchema"
63 }
64 }
65 }
66 },
67 "parameters": [
68 {
69 "name": "token",
70 "in": "query",
71 "required": true,
72 "schema": {
73 "type": "string"
74 },
75 "description": "Enter your Apify token here"
76 }
77 ],
78 "responses": {
79 "200": {
80 "description": "OK",
81 "content": {
82 "application/json": {
83 "schema": {
84 "$ref": "#/components/schemas/runsResponseSchema"
85 }
86 }
87 }
88 }
89 }
90 }
91 },
92 "/acts/clockworks~tiktok-explore-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-clockworks-tiktok-explore-scraper",
95 "x-openai-isConsequential": false,
96 "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97 "tags": [
98 "Run Actor"
99 ],
100 "requestBody": {
101 "required": true,
102 "content": {
103 "application/json": {
104 "schema": {
105 "$ref": "#/components/schemas/inputSchema"
106 }
107 }
108 }
109 },
110 "parameters": [
111 {
112 "name": "token",
113 "in": "query",
114 "required": true,
115 "schema": {
116 "type": "string"
117 },
118 "description": "Enter your Apify token here"
119 }
120 ],
121 "responses": {
122 "200": {
123 "description": "OK"
124 }
125 }
126 }
127 }
128 },
129 "components": {
130 "schemas": {
131 "inputSchema": {
132 "type": "object",
133 "required": [
134 "exploreCategoryTypes"
135 ],
136 "properties": {
137 "exploreCategoryTypes": {
138 "title": "Explore these categories",
139 "minItems": 1,
140 "uniqueItems": true,
141 "type": "array",
142 "description": "Just select TikTok Explore categories and the scraper will collect information.",
143 "items": {
144 "type": "string",
145 "enum": [
146 "pc_web_explorePage_all",
147 "pc_web_explorePage_topics_singing_dancing",
148 "pc_web_explorePage_topics_comedy",
149 "pc_web_explorePage_topics_sports",
150 "pc_web_explorePage_topics_anime_comics",
151 "pc_web_explorePage_topics_relationship",
152 "pc_web_explorePage_topics_shows",
153 "pc_web_explorePage_topics_lipsync",
154 "pc_web_explorePage_topics_daily_life",
155 "pc_web_explorePage_topics_beauty_care",
156 "pc_web_explorePage_topics_games",
157 "pc_web_explorePage_topics_society",
158 "pc_web_explorePage_topics_outfit",
159 "pc_web_explorePage_topics_cars",
160 "pc_web_explorePage_topics_food",
161 "pc_web_explorePage_topics_animals",
162 "pc_web_explorePage_topics_family",
163 "pc_web_explorePage_topics_drama",
164 "pc_web_explorePage_topics_fitness_health",
165 "pc_web_explorePage_topics_education",
166 "pc_web_explorePage_topics_technology"
167 ],
168 "enumTitles": [
169 "All",
170 "Singing & Dancing",
171 "Comedy",
172 "Sports",
173 "Anime & Comics",
174 "Relationship",
175 "Shows",
176 "Lipsync",
177 "Daily Life",
178 "Beauty Care",
179 "Games",
180 "Society",
181 "Outfit",
182 "Cars",
183 "Food",
184 "Animals",
185 "Family",
186 "Drama",
187 "Fitness & Health",
188 "Education",
189 "Technology"
190 ]
191 }
192 },
193 "resultsPerPage": {
194 "title": "Max posts per category (up to ~300 posts - hard limit by TikTok)",
195 "minimum": 1,
196 "type": "integer",
197 "description": "Maximum number of posts that will be scraped from every Explore category.",
198 "default": 100
199 },
200 "shouldDownloadVideos": {
201 "title": "Include videos",
202 "type": "boolean",
203 "description": "Tick to download TikTok videos. Note that this will increase time and costs needed to extract the data.",
204 "default": false
205 },
206 "shouldDownloadCovers": {
207 "title": "Include thumbnails",
208 "type": "boolean",
209 "description": "Tick to download TikTok video cover images (thumbnails). Note that this will increase time and costs needed to extract the data.",
210 "default": false
211 },
212 "shouldDownloadSubtitles": {
213 "title": "Include subtitles",
214 "type": "boolean",
215 "description": "Tick to download TikTok video subtitles (only when present on the video). Note that this will increase time and costs needed to extract the data.",
216 "default": false
217 },
218 "shouldDownloadSlideshowImages": {
219 "title": "Download slideshow images",
220 "type": "boolean",
221 "description": "Tick to download TikTok slideshow images. Note that this will increase costs and time required for scraping.",
222 "default": false
223 },
224 "videoKvStoreIdOrName": {
225 "title": "āļø Name your storage for videos",
226 "pattern": "^[a-zA-Z0-9-]+$",
227 "type": "string",
228 "description": "Name (or ID) of the Key Value Store where the videos and other media like thumbnails will be stored. Omit to store in the default one. Using this option will provide a named Key-Value store can help bypass data retention and store the content forever until the store is manually deleted.<br><br>The Key-Value store's name can consist of a versatile combination of uppercase letters, lowercase letters, digits, or hyphens, all without any spaces."
229 },
230 "proxyCountryCode": {
231 "title": "Proxy country",
232 "enum": [
233 "None",
234 "AF",
235 "AL",
236 "DZ",
237 "AS",
238 "AD",
239 "AO",
240 "AI",
241 "AQ",
242 "AG",
243 "AR",
244 "AM",
245 "AW",
246 "AU",
247 "AT",
248 "AZ",
249 "BS",
250 "BH",
251 "BD",
252 "BB",
253 "BY",
254 "BE",
255 "BZ",
256 "BJ",
257 "BM",
258 "BT",
259 "BO",
260 "BQ",
261 "BA",
262 "BW",
263 "BV",
264 "BR",
265 "IO",
266 "VG",
267 "BN",
268 "BG",
269 "BF",
270 "BI",
271 "KH",
272 "CM",
273 "CA",
274 "CV",
275 "KY",
276 "CF",
277 "TD",
278 "CL",
279 "CN",
280 "CX",
281 "CC",
282 "CO",
283 "KM",
284 "CK",
285 "CR",
286 "HR",
287 "CU",
288 "CW",
289 "CY",
290 "CZ",
291 "CD",
292 "DK",
293 "DJ",
294 "DM",
295 "DO",
296 "TL",
297 "EC",
298 "EG",
299 "SV",
300 "GQ",
301 "ER",
302 "EE",
303 "ET",
304 "FK",
305 "FO",
306 "FJ",
307 "FI",
308 "FR",
309 "GF",
310 "PF",
311 "TF",
312 "GA",
313 "GM",
314 "GE",
315 "DE",
316 "GH",
317 "GI",
318 "GR",
319 "GL",
320 "GD",
321 "GP",
322 "GU",
323 "GT",
324 "GG",
325 "GN",
326 "GW",
327 "GY",
328 "HT",
329 "HM",
330 "HN",
331 "HK",
332 "HU",
333 "IS",
334 "IN",
335 "ID",
336 "IR",
337 "IQ",
338 "IE",
339 "IM",
340 "IL",
341 "IT",
342 "CI",
343 "JM",
344 "JP",
345 "JE",
346 "JO",
347 "KZ",
348 "KE",
349 "KI",
350 "XK",
351 "KW",
352 "KG",
353 "LA",
354 "LV",
355 "LB",
356 "LS",
357 "LR",
358 "LY",
359 "LI",
360 "LT",
361 "LU",
362 "MO",
363 "MG",
364 "MW",
365 "MY",
366 "MV",
367 "ML",
368 "MT",
369 "MH",
370 "MQ",
371 "MR",
372 "MU",
373 "YT",
374 "MX",
375 "FM",
376 "MD",
377 "MC",
378 "MN",
379 "ME",
380 "MS",
381 "MA",
382 "MZ",
383 "MM",
384 "NA",
385 "NR",
386 "NP",
387 "NL",
388 "NC",
389 "NZ",
390 "NI",
391 "NE",
392 "NG",
393 "NU",
394 "NF",
395 "KP",
396 "MK",
397 "MP",
398 "NO",
399 "OM",
400 "PK",
401 "PW",
402 "PS",
403 "PA",
404 "PG",
405 "PY",
406 "PE",
407 "PH",
408 "PN",
409 "PL",
410 "PT",
411 "PR",
412 "QA",
413 "CG",
414 "RO",
415 "RU",
416 "RW",
417 "RE",
418 "BL",
419 "SH",
420 "KN",
421 "LC",
422 "MF",
423 "PM",
424 "VC",
425 "WS",
426 "SM",
427 "SA",
428 "SN",
429 "RS",
430 "SC",
431 "SL",
432 "SG",
433 "SX",
434 "SK",
435 "SI",
436 "SB",
437 "SO",
438 "ZA",
439 "GS",
440 "KR",
441 "SS",
442 "ES",
443 "LK",
444 "SD",
445 "SR",
446 "SJ",
447 "SZ",
448 "SE",
449 "CH",
450 "SY",
451 "ST",
452 "TW",
453 "TJ",
454 "TZ",
455 "TH",
456 "TG",
457 "TK",
458 "TO",
459 "TT",
460 "TN",
461 "TR",
462 "TM",
463 "TC",
464 "TV",
465 "UM",
466 "VI",
467 "UG",
468 "UA",
469 "AE",
470 "GB",
471 "US",
472 "UY",
473 "UZ",
474 "VU",
475 "VA",
476 "VE",
477 "VN",
478 "WF",
479 "EH",
480 "YE",
481 "ZM",
482 "ZW",
483 "AX"
484 ],
485 "type": "string",
486 "description": "Country to use with proxy. Use it in case you want to scrape posts only available for some country. Proxies here use RESIDENTIAL group, which is slower and more expensive.",
487 "default": "None"
488 }
489 }
490 },
491 "runsResponseSchema": {
492 "type": "object",
493 "properties": {
494 "data": {
495 "type": "object",
496 "properties": {
497 "id": {
498 "type": "string"
499 },
500 "actId": {
501 "type": "string"
502 },
503 "userId": {
504 "type": "string"
505 },
506 "startedAt": {
507 "type": "string",
508 "format": "date-time",
509 "example": "2025-01-08T00:00:00.000Z"
510 },
511 "finishedAt": {
512 "type": "string",
513 "format": "date-time",
514 "example": "2025-01-08T00:00:00.000Z"
515 },
516 "status": {
517 "type": "string",
518 "example": "READY"
519 },
520 "meta": {
521 "type": "object",
522 "properties": {
523 "origin": {
524 "type": "string",
525 "example": "API"
526 },
527 "userAgent": {
528 "type": "string"
529 }
530 }
531 },
532 "stats": {
533 "type": "object",
534 "properties": {
535 "inputBodyLen": {
536 "type": "integer",
537 "example": 2000
538 },
539 "rebootCount": {
540 "type": "integer",
541 "example": 0
542 },
543 "restartCount": {
544 "type": "integer",
545 "example": 0
546 },
547 "resurrectCount": {
548 "type": "integer",
549 "example": 0
550 },
551 "computeUnits": {
552 "type": "integer",
553 "example": 0
554 }
555 }
556 },
557 "options": {
558 "type": "object",
559 "properties": {
560 "build": {
561 "type": "string",
562 "example": "latest"
563 },
564 "timeoutSecs": {
565 "type": "integer",
566 "example": 300
567 },
568 "memoryMbytes": {
569 "type": "integer",
570 "example": 1024
571 },
572 "diskMbytes": {
573 "type": "integer",
574 "example": 2048
575 }
576 }
577 },
578 "buildId": {
579 "type": "string"
580 },
581 "defaultKeyValueStoreId": {
582 "type": "string"
583 },
584 "defaultDatasetId": {
585 "type": "string"
586 },
587 "defaultRequestQueueId": {
588 "type": "string"
589 },
590 "buildNumber": {
591 "type": "string",
592 "example": "1.0.0"
593 },
594 "containerUrl": {
595 "type": "string"
596 },
597 "usage": {
598 "type": "object",
599 "properties": {
600 "ACTOR_COMPUTE_UNITS": {
601 "type": "integer",
602 "example": 0
603 },
604 "DATASET_READS": {
605 "type": "integer",
606 "example": 0
607 },
608 "DATASET_WRITES": {
609 "type": "integer",
610 "example": 0
611 },
612 "KEY_VALUE_STORE_READS": {
613 "type": "integer",
614 "example": 0
615 },
616 "KEY_VALUE_STORE_WRITES": {
617 "type": "integer",
618 "example": 1
619 },
620 "KEY_VALUE_STORE_LISTS": {
621 "type": "integer",
622 "example": 0
623 },
624 "REQUEST_QUEUE_READS": {
625 "type": "integer",
626 "example": 0
627 },
628 "REQUEST_QUEUE_WRITES": {
629 "type": "integer",
630 "example": 0
631 },
632 "DATA_TRANSFER_INTERNAL_GBYTES": {
633 "type": "integer",
634 "example": 0
635 },
636 "DATA_TRANSFER_EXTERNAL_GBYTES": {
637 "type": "integer",
638 "example": 0
639 },
640 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
641 "type": "integer",
642 "example": 0
643 },
644 "PROXY_SERPS": {
645 "type": "integer",
646 "example": 0
647 }
648 }
649 },
650 "usageTotalUsd": {
651 "type": "number",
652 "example": 0.00005
653 },
654 "usageUsd": {
655 "type": "object",
656 "properties": {
657 "ACTOR_COMPUTE_UNITS": {
658 "type": "integer",
659 "example": 0
660 },
661 "DATASET_READS": {
662 "type": "integer",
663 "example": 0
664 },
665 "DATASET_WRITES": {
666 "type": "integer",
667 "example": 0
668 },
669 "KEY_VALUE_STORE_READS": {
670 "type": "integer",
671 "example": 0
672 },
673 "KEY_VALUE_STORE_WRITES": {
674 "type": "number",
675 "example": 0.00005
676 },
677 "KEY_VALUE_STORE_LISTS": {
678 "type": "integer",
679 "example": 0
680 },
681 "REQUEST_QUEUE_READS": {
682 "type": "integer",
683 "example": 0
684 },
685 "REQUEST_QUEUE_WRITES": {
686 "type": "integer",
687 "example": 0
688 },
689 "DATA_TRANSFER_INTERNAL_GBYTES": {
690 "type": "integer",
691 "example": 0
692 },
693 "DATA_TRANSFER_EXTERNAL_GBYTES": {
694 "type": "integer",
695 "example": 0
696 },
697 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
698 "type": "integer",
699 "example": 0
700 },
701 "PROXY_SERPS": {
702 "type": "integer",
703 "example": 0
704 }
705 }
706 }
707 }
708 }
709 }
710 }
711 }
712 }
713}š TikTok Explore Scraper OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for TikTok Explore Scraper from the options below:
If youād like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
Developer
Clockworks Maintained by Apify
Actor Metrics
15 monthly users
-
1 star
>99% runs succeeded
Created in Oct 2024
Modified 4 days ago
Categories
