{"id":16609952,"url":"https://github.com/MiniGlome/Tiktok-uploader","last_synced_at":"2025-10-29T17:30:40.534Z","repository":{"id":65731989,"uuid":"589560166","full_name":"MiniGlome/Tiktok-uploader","owner":"MiniGlome","description":"Python3 script to upload and schedule TikTok videos","archived":false,"fork":false,"pushed_at":"2023-12-19T00:12:38.000Z","size":16,"stargazers_count":190,"open_issues_count":22,"forks_count":25,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-12T01:30:39.231Z","etag":null,"topics":["tiktok","tiktok-api","tiktok-automation","tiktok-upload"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MiniGlome.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"MiniGlome","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-01-16T12:08:50.000Z","updated_at":"2024-09-29T18:47:48.000Z","dependencies_parsed_at":"2024-10-12T01:29:59.267Z","dependency_job_id":null,"html_url":"https://github.com/MiniGlome/Tiktok-uploader","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniGlome%2FTiktok-uploader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniGlome%2FTiktok-uploader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniGlome%2FTiktok-uploader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniGlome%2FTiktok-uploader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MiniGlome","download_url":"https://codeload.github.com/MiniGlome/Tiktok-uploader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238856058,"owners_count":19542134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["tiktok","tiktok-api","tiktok-automation","tiktok-upload"],"created_at":"2024-10-12T01:29:22.634Z","updated_at":"2025-10-29T17:30:40.198Z","avatar_url":"https://github.com/MiniGlome.png","language":"Python","funding_links":["https://ko-fi.com/MiniGlome"],"categories":["Python"],"sub_categories":[],"readme":"![made-with-python](https://img.shields.io/badge/Made%20with-Python3-brightgreen)\n\n\u003c!-- LOGO --\u003e\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/54740007/212677385-8f453f16-06fd-41e2-83a6-8a25d5435418.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n\n  \u003ch3 align=\"center\"\u003eTikTok-Uploader\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Python3 script to upload and schedule TikTok videos\n    \u003cbr /\u003e\n    \u003c/p\u003e\n\u003c/p\u003e\n\n\n## About The Project\n\nThis project is a Python3 script that allows you to automatically upload and schedule TikTok videos. With this script, you can automate the process of uploading videos to TikTok, allowing you to save time and focus on creating content.\n\nThe script is easy to use and requires minimal setup. Simply provide your TikTok *sessionid* cookie, the video file you wish to upload and the video details, and the script will handle the rest. You can also schedule videos to be uploaded at a specific time, making it easy to plan your content in advance.\n\n## Getting Started\nTo get started you need to have python3 installed. If it is not the case you can download it here : https://www.python.org/downloads/\u003cbr\u003e\u003cbr\u003e\nYou will also need your TikTok ***sessionid* cookie**. To get it log in to your TikTok account and on the page https://www.tiktok.com/ press the F12 key on your keyboard then Application \u003e Storage \u003e Cookies and find the value of the *sessionid* cookie. You should have something like this: `7a9f3c5d8f6e4b2a1c9d8e7f6a5b4c3d` \u003cbr\u003e\u003cbr\u003e\n*Note that you need a **Business account** in order to use the **schedule feature**, if the option is not available on your computer you can switch to a Business account using the smartphone app.*\n\n### Installation\nMake sure you've already git installed. Then you can run the following commands to get the scripts on your computer:\n   ```sh\n   git clone https://github.com/MiniGlome/Tiktok-uploader.git\n   cd Tiktok-uploader\n   ```\nThe script only requires the `requests` module, you can install it with this command:\n```sh\npip install -r requirements.txt\n```\n   \n## Usage\n### Import in your script\nYou can copy the file `Tiktok_uploader.py` in your project folder and use it like this:\n```python\nfrom Tiktok_uploader import uploadVideo\n\nsession_id = \"7a9f3c5d8f6e4b2a1c9d8e7f6a5b4c3d\"\nfile = \"my_video.mp4\"\ntitle = \"MY SUPER TITLE\"\ntags = [\"Funny\", \"Joke\", \"fyp\"]\nschedule_time = 1672592400\n\n# Publish the video\nuploadVideo(session_id, file, title, tags, verbose=True)\n# Schedule the video\nuploadVideo(session_id, file, title, tags, schedule_time, verbose=True)\n```\n- `session_id`: Your TikTok *sessionid* cookie.\u003cbr\u003e\n- `file`: The path to the video you want to upload.\u003cbr\u003e\n- `title`: The title of your publication (without hashtags).\u003cbr\u003e\n- `tags`: The list of hashtags you want to add to your post (without `#` symbol). May be empty list `[]`.\u003cbr\u003e\n- `schedule_time`: The timestamp (in seconds) at which you want to schedule your video.\u003cbr\u003e\n**Note that you cannot schedule a video more than 10 days in advance.**\u003cbr\u003e\n**Note that your TikTok *sessionid* cookie needs to be updated every 2 months.**\n\n### With the command line\n```\nusage: Tiktok_uploader.py [-h] -i SESSION_ID -p PATH -t TITLE [--tags [TAGS ...]] [-s SCHEDULE_TIME]\n\noptions:\n  -h, --help            show this help message and exit\n  -i SESSION_ID, --session_id SESSION_ID\n                        Tiktok sessionid cookie\n  -p PATH, --path PATH  Path to video file\n  -t TITLE, --title TITLE\n                        Title of the video\n  --tags [TAGS ...]     List of hashtags for the video\n  -s SCHEDULE_TIME, --schedule_time SCHEDULE_TIME\n                        schedule timestamp for video upload\n```                        \nThe `session_id`, `path` and `title` fields are required.\n    \n#### Example\nThis command will publish the video `my_video.mp4` as `MY SUPER TITLE #Funny #Joke #fyp`\n```sh\npython3 Tiktok_uploader.py -i 7a9f3c5d8f6e4b2a1c9d8e7f6a5b4c3d -p my_video.mp4 -t \"MY SUPER TITLE\" --tags Funny Joke Fyp\n```\nThis command will schedule the video `my_video.mp4` for `01/01/2023 18:00:00` (timestamp 1672592400)\n```sh\npython3 Tiktok_uploader.py -i 7a9f3c5d8f6e4b2a1c9d8e7f6a5b4c3d -p my_video.mp4 -t \"MY SUPER TITLE\" --tags Funny Joke Fyp -s 1672592400\n```\n\n## Donation\nIf you want to support my work, you can send 2 or 3 Bitcoins 🙃 to this address: \n```\nbc1q4nq8tjuezssy74d5amnrrq6ljvu7hd3l880m7l\n```\n![bitcoin_address](https://user-images.githubusercontent.com/54740007/169100171-1061c7a0-207e-459b-84de-2d6bb93b0f38.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiniGlome%2FTiktok-uploader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMiniGlome%2FTiktok-uploader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiniGlome%2FTiktok-uploader/lists"}