{"openapi":"3.1.0","info":{"title":"Scrape Creators API","description":"The easiest way to scrape public social media data at scale. Extract profiles, posts, videos, comments, and more from TikTok, Instagram, YouTube, Twitter, LinkedIn, Facebook, Reddit, and 27+ platforms.","version":"1.0.0","contact":{"name":"Scrape Creators","url":"https://scrapecreators.com","email":"support@scrapecreators.com"}},"servers":[{"url":"https://api.scrapecreators.com","description":"Production server"}],"security":[{"apiKeyAuth":[]}],"tags":[{"name":"TikTok","description":"Scrape TikTok profiles, videos, and more"}],"paths":{"/v1/tiktok/search/keyword":{"get":{"tags":["TikTok"],"summary":"Search by Keyword","description":"Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. Returns `search_item_list`, an array of objects each containing `aweme_info` with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor`.","parameters":[{"name":"query","in":"query","required":true,"description":"Keyword to search for","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"Time Frame","schema":{"type":"string","enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"]},"example":"all-time"},{"name":"sort_by","in":"query","required":false,"description":"Sort by","schema":{"type":"string","enum":["relevance","most-liked","date-posted"]},"example":"relevance"},{"name":"region","in":"query","required":false,"description":"Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Cursor to get more videos. Get 'cursor' from previous response.","schema":{"type":"number"},"example":10},{"name":"trim","in":"query","required":false,"description":"Set to true to get a trimmed response","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"search_item_list":[{"aweme_id":"7268287584244124971","desc":"Tìm 'musclesandnursing'","desc_language":"vi","region":"US","statistics":{"aweme_id":"7268287584244124971","collect_count":6978,"comment_count":187,"digg_count":481608,"download_count":458,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":1282645,"repost_count":0,"share_count":2721,"whatsapp_share_count":56},"video":{"CoverTsp":0,"ai_dynamic_cover":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"ai_dynamic_cover_bak":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"animated_cover":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"big_thumbs":[],"bit_rate":[{"HDR_bit":"","HDR_type":"","bit_rate":1225469,"dub_infos":null,"fid_profile_labels":"","fps":30,"gear_name":"normal_540_0","is_bytevc1":0,"play_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000","https://v15m.tiktokcdn-eu.com/6c9dc53edb12347e833248d3eb85ae4c/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000b8000","https://api16-normal-no1a.tiktokv.eu/aweme/v1/play/?faid=1233&file_id=2599b2bd38f34dd6b835c9d0205bac5e&is_play_url=1&item_id=7268287584244124971&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjBhOTJmMjdmN2FhMmMzNTFkZTZhZTg0ZGM2MzQ4YzBi&source=SEARCH&video_id=v12025gd0000cjf2aabc77u3cqbmfgsg"],"url_prefix":null,"width":576},"quality_type":20}],"bit_rate_audio":[],"cdn_url_expired":0,"cla_info":{"caption_infos":[{"caption_format":"webvtt","caption_length":438,"cla_subtitle_id":7270020544014290000,"complaint_id":7270020544014290000,"expire":1752947008,"is_auto_generated":true,"is_original_caption":true,"lang":"eng-US","language_code":"en","language_id":2,"source_tag":"vv_counter,","sub_id":-956551204,"sub_version":"1","subtitle_type":1,"translation_type":0,"translator_id":0,"url":"https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2600&bt=1300&cs=0&ds=6&ft=BiFzHV~3wUxl7K2gUtIvk84jWLpiNOz~xjKJ~iu8gG0P3-I&mime_type=video_mp4&qs=13&rc=ampwdDY6ZmQ1bTMzZzgzNEBpampwdDY6ZmQ1bTMzZzgzNEBwY19gcjRfXmNgLS1kLy9zYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e00078000","url_list":["https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2600&bt=1300&cs=0&ds=6&ft=BiFzHV~3wUxl7K2gUtIvk84jWLpiNOz~xjKJ~iu8gG0P3-I&mime_type=video_mp4&qs=13&rc=ampwdDY6ZmQ1bTMzZzgzNEBpampwdDY6ZmQ1bTMzZzgzNEBwY19gcjRfXmNgLS1kLy9zYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e00078000","https://v19-cla.tiktokcdn.com/4eacae0c5eb2cd31bf9682dbb31d41b2/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2600&bt=1300&cs=0&ds=6&ft=BiFzHV~3wUxl7K2gUtIvk84jWLpiNOz~xjKJ~iu8gG0P3-I&mime_type=video_mp4&qs=13&rc=ampwdDY6ZmQ1bTMzZzgzNEBpampwdDY6ZmQ1bTMzZzgzNEBwY19gcjRfXmNgLS1kLy9zYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e00078000","https://vas-useast2a.tiktokv.com/tiktok/v1/subtitle/url?aid=1233&format=webvtt&language=eng-US&sign=f7af2712604d3759a90b364b98718f9b&version=1&vid=v12025gd0000cjf2aabc77u3cqbmfgsg"],"variant":"default"}],"captions_type":1,"creator_edited_caption_id":0,"enable_auto_caption":0,"has_original_audio":0,"hide_original_caption":false,"no_caption_reason":0,"original_language_info":{"can_translate_realtime":false,"can_translate_realtime_skip_translation_lang_check":true,"first_subtitle_time":0,"is_burnin_caption":true,"lang":"eng-US","language_code":"en","language_id":2,"original_caption_type":5},"vertical_positions":null},"cover":{"height":720,"uri":"tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=10397&idc=no1a&ps=13740610&refresh_token=b8b3e6e4&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1750374000&x-signature=OmrZk9jL5t%2FLXtkV8oZOuLa3xvM%3D"],"url_prefix":null,"width":720},"did_profile_labels":"","download_addr":{"data_size":3577718,"height":720,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_list":["https://v45.tiktokcdn-eu.com/53531e0e8cb8cabe9f9fb43d31f0477a/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/osgGPDi7kD0SShpGAnBhusf3egUQSobVpCSz8y/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2442&bt=1221&cs=0&ds=3&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=ZGkzZDw8OzRpOzppNWk0OUBpampwdDY6ZmQ1bTMzZzgzNEBgMWAxLi0tXjQxNF5hYGIwYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":720},"download_no_watermark_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":576},"duration":22874,"dynamic_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=8a667f0e&x-expires=1750438800&x-signature=61HY87iHMGwIIjamvp5W6BMWgZc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&s=SEARCH&sc=dynamic_cover&biz_tag=tt_video"],"url_prefix":null,"width":720},"has_watermark":true,"height":1024,"is_bytevc1":0,"is_callback":true,"need_set_token":false,"origin_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121","url_list":["https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=01618ed2&x-expires=1750438800&x-signature=enrj%2FQcrnnqO5EfF6R%2FI98%2F2GKA%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=feed_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null,"width":720},"play_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":576},"ratio":"540p","source_HDR_type":0,"tags":null,"vid_profile_labels":"{\"tier3\":\"10014\"}","width":576},"author":{"accept_private_policy":false,"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_video.video_user_cover&dr=9606&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","aweme_count":0,"bold_fields":null,"can_message_follow_status_list":null,"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":null,"custom_verify":"","cv_level":"","download_prompt_ts":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{},"fb_expire_time":0,"follow_status":0,"follower_count":147630,"follower_status":0,"followers_detail":null,"following_count":0,"friends_status":0,"geofencing":null,"hide_search":false,"homepage_bottom_toast":null,"ins_id":"","is_ad_fake":false,"is_block":false,"is_discipline_member":false,"is_mute":0,"is_mute_lives":0,"is_mute_non_story_post":0,"is_mute_story":0,"is_star":false,"item_list":null,"live_agreement":0,"live_commerce":false,"live_verify":0,"mention_status":1,"mutual_relation_avatars":null,"name_field":"nickname","need_points":null,"need_recommend":0,"nickname":"thatgreygentlemanitdxz","platform_sync_info":null,"prevent_download":false,"relative_users":null,"reply_with_video_flag":4,"room_id":0,"search_highlight":null,"search_user_desc":"thatgreygentlemanitdxz","search_user_name":"thatgreygentlemanitdxz","sec_uid":"MS4wLjABAAAAvNxDh4anLimQvVERJDHqzySHDb0fYq9sx_qfGpZwcwmyK3nnKYE8e60RkdSh22qq","secret":0,"shield_comment_notice":0,"shield_digg_notice":0,"shield_edit_field_info":null,"shield_follow_notice":0,"short_id":"0","show_image_bubble":false,"special_account":{"special_account_list":null},"special_lock":1,"status":1,"stitch_setting":0,"total_favorited":0,"type_label":null,"uid":"7267964228375413803","unique_id":"thatgreygentlemanitdxz","user_canceled":false,"user_mode":1,"user_period":0,"user_profile_guide":null,"user_rate":1,"user_spark_info":{},"user_tags":null,"verification_type":1,"verify_info":"","video_icon":{"height":720,"uri":"","url_list":[],"url_prefix":null,"width":720},"white_cover_url":null,"with_commerce_entry":false,"with_shop_entry":false},"create_time":1692280120,"is_ad":false,"is_eligible_for_commission":false,"create_time_utc":"2023-08-17T13:48:40.000Z","url":"https://www.tiktok.com/@thatgreygentlemanitdxz/video/7268287584244124971"}],"cursor":30}}}}}}}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Scrape Creators API key"}}}}