Tiktok for developers api example. Learn more about the UX guidelines here.
Tiktok for developers api example. Introducing TikTok Research API Wrappers on GitHub.
Tiktok for developers api example For example, if a partner has X number of clients, Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents. Content-Type. The name should not include a reference to social media companies (for example, "TikTok app"). list<Condition> The and conditions specify that all the conditions in the list must be met. The unique identification of the user across different apps for the same developer. In order to access our Research Tools, you will need to meet our eligibility requirements, submit an application, and be approved for a specific research project. It is possible that the API returns less videos than the max count due to reasons such as videos deleted/marked as private Webhook Events. Query TikTok Shop Reviews. Can I start using Research Tools? Your developer account alone is not sufficient to grant you access to Research Tools. list<Condition> The not conditions specify that none of the conditions in the list must be met. "min" needs to be after October 1st, 2022. token_type. The partner-facing user ID. The following are some example scopes: user. TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations. The app name must adhere to the TikTok Brand and Use Guidelines. Data Portability Application Guidelines. After successfully completing authentication with TikTok, developers can obtain an access_token for the TikTok user. upload scope. Click to download Support share feature for TikTok 16. Required Actions TikTok Finds: Socializing online shopping. This step is highly recommended but not required. By default, you are subscribed to all events when a callback URL is configured in the TikTok Developer Portal. The app icon must be a clear image. int32. Before you can share to TikTok from your App, make sure you have obtained a Client Key from TikTok and installed the TikTok SDK to your Android project. ad_published_date_range. Query TikTok TikTok API for Business is a series of interface services provided by TikTok for Business to developers. Learn more here. Create or join an organization representing the owning group of the app. Configure redirect URI Key. The flag that indicates if there are more items to be returned. Perfect for testing REST APIs! #programming #coding #webdevelopment”. App review process Key. No This guide will show you how to use the Research API. 5 or Key. Login Kit. See Review Info Object below for a full list of values. Developers can build functions Create a TikTok developer account from our signup page using your email. ; For any portability. The cURL command below shows an example of how you can query the TikTok ads created in Italy between As part of our ongoing efforts to support data portability, the principles of market contestability, as well as provide users with more choice and control over their data, we're excited to announce our Data Portability API. Content Posting API; Research API; Display API; Embed Videos; Data Portability API Key. We will use the Display APIs to display a TikTok user's profile and videos on your platform. Learn more about the creator_info/query API here. If your application does not meet the criteria below, you may be required to resubmit your application or be requested to provide more details, which may delay your application's review. Then add Share Kit to your app by navigating to the Manage apps page, and clicking + Add products . developer): “Generate example data for your projects with Jason Generator, a free tool for developers to define data structures quickly and easily. Access to additional user data requires approval from TikTok for Developers website. The "min" value should represent a date after October 1, 2022. Create a TikTok developer account from our signup page using your email. We recommend that developers targeting Android 7. Prerequisites. single are authorized by This API returns profile and permission information of the current user. Connect your app . Check out TikTok's new Research API Wrappers, which make it easier for researchers of all technical skill levels to use TikTok's Research 10. Number of video ids should not be larger than 20 at Example Use Cases Display User's TikTok Profile. Through our Research API, academic researchers from non-profit universities in the U. apply_time. November 3, 2023. Android Quickstart. Then go to the Manage apps page and select your app. Learn more about the UX guidelines here. 0 for user authorization and API authentication. Before proceeding, make sure you complete all of the steps in the iOS Quickstart. Introducing TikTok Research API Wrappers on GitHub. Community. Max length: 150. For details on these requirements, see Getting started. username. Create a ShareApi to send a share request. fields. Android. It is possible that the API returns less videos than the max count due to reasons such as videos deleted/marked as private by users etc. true. request_id. The access token and open ID of the TikTok user who authorized your app. ; Create a ShareRequest object and set the required parameters. Authorization. TikTok's Content Posting API now supports Photos! Developers can now integrate with the new API endpoints to allow creators post photos to their TikTok account directly from your app Most endpoints provided by TikTok for Developers require direct consent from TikTok users before you can invoke them. MEDIA_UPLOAD: Upload content to TikTok for users to complete the post using TikTok's editing flow. int64 . One example is secure multiparty computation (MPC), We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, including exclusive content from TikTok DevDay. 20. Navigate to the Products section of your app page and click Add Refer to MainActivity in the demo-auth package as an example. We are excited that you are seeking to integrate your app with TikTok. tiktok. "tiktok" music_id. Example curl --location DIRECT POST: Directly post the content to TikTok user's account. The app name should match the app or website name and not describe your app. Obtain the client_key located in the App details section of your app on the TikTok for Developers website. You can pass in a customized timestamp to fetch the user's videos posted before the provided timestamp. For example, do not add "Video Content Analytics Uploader" as the name. Once your application is approved, a research client will be generated for your project. mycoolapp. A complete access sample demo project, you can visually view the access method and API usage through Demo, test Demo uses the test Client Key for reference only. Login Kit is based on OAuth 2. Query TikTok Shop Info. View your client registration. Type. 6. Limits for each API are set and enforced separately. No TikTok API for Business is a series of interface services provided by TikTok for Business to developers. Learn Creator Marketplace API: Enable influencer marketing platforms and developers to easily and programmatically create boosted TikToks from creator content. height. DEFAULT: The default share format. The token that bears the authorization of the TikTok user, which is obtained through /v2/oauth/token/ TikTok API for Business is a series of interface services provided by TikTok for Business to developers. TikTok API limits the number of requests you can send in a given timeframe. The maximum number of followers that can be returned in this response. open_id. Our new API is hosted at open. Description. If response. Before You Start. Query Videos Overview. Integrating with our Login Kit enables users to quickly and securely sign into your app with their TikTok account. iOS. commercial_contents. 8978345345214861235. Webhook Events. Use the /v2/user/info/ API to get a TikTok user's profile data and then display their TikTok identity. For example, Nike Training Club uses the API to create in-app fitness challenges linked to TikTok API for Business is a series of interface services provided by TikTok for Business to developers. Users will receive an inbox notification. The expiration for the access_token in seconds. TikTok provides an open API to developers There are several official TikTok’s APIs which provide developers with tools to integrate TikTok functionalities into their applications and access TikTok data. Rate Limits. Then obtain a client key and secret from the developer portal on https://developers. The description that the creator has set for the TikTok video. The token that bears the authorization of the TikTok user, which is obtained through /v2/oauth/token/. Upon approval, you will be provided Migrating to our new API. As developers, you can help us inspire creativity and bring joy by providing awesome experiences for TikTok users. ; June 12, 2023: Developers will no longer be able to add or modify redirect domains in their Login Kit configurations for web apps. Docs Support Blog. TikTok for Developers offers a wide variety of features that developers can add to their apps: Login Kit, Check out TikTok's new Research API Wrappers, which make it easier for researchers of all technical skill levels to use TikTok's Research API. For more details, please refer to the document. Learn how to obtain the access token and open ID. true Example. S. The longest video a developer can send via the initialize Upload Video endpoint is 10 minutes. int64. Learn more about scopes. ; For cases where multiple portability. Obtain the client_key and client_secret located in the Credentials section of your app page on the TikTok for Developers website. Learn how to use the Research API to query video data and fetch public TikTok account data in the following use case example. It is valid for 2 hours after the initial issuance. The username as the unique identifier "test_username" Yes . Developers worldwide can apply for access to the API and portability will be available for TikTok users in the European Economic Area (EEA). The post information. Up to 20 video IDs can be included per request. As the platform’s reach expands, so does the demand for data and insights. avatar_url. Get approval and authorization of the video. Follow these steps to add your app to TikTok for Developers. 1703186989 Most endpoints provided by TikTok for Developers require direct consent from TikTok users before you can invoke them. DIRECT POST: Directly post the content to TikTok user's account. . 3K Likes, 70 Comments. Content Posting API. *. Size restrictions Notes: If "all_data" is sent as a parameter in category_selection_list, it will take precedence over other categories. By leveraging this API, you can seamlessly retrieve a user's profile details, such as their username, profile picture, and bio, alongside accessing their video posts. 0 and above use FileProvider to share. The height of Explain how your app utilizes the TikTok for Developers APIs, for example: "We would like to enable users to quickly and securely sign into our app with their TikTok account" "We would like to add a "Share to TikTok" button to our app so our users can share their videos to TikTok" How can I track the status of my application? This guide will show you how to use the Research API. Integration Add this access token in the authorization header of the http requests to connect to the Commercial Content API endpoints. com; Example video webpage; Embedded for developers. playlist_id. For example, if a partner has X number of clients, it will get X number of open_id for the same TikTok user, but one persistent union_id for the particular user. Check out TikTok's new Research API Wrappers, which make it easier for researchers of all technical skill levels to use TikTok's Research We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, including exclusive content from TikTok DevDay. iOS Quickstart. Example Value. Discover the various types of data that can be generated and how to incorporate them into your API requests. activity. or. Field names for desired data to be returned. Post Info Object. basic gives read-only access to a user's please refer to the legacy user access token management API guide. has_more. Developer Guidelines. It is possible that the API returns fewer videos than the max count due to content moderation outcomes, UTC Unix epoch (in seconds) of when the TikTok video was posted "username" string. Provides the total number of items in a playlist. Refer to the We provide two ways for you to receive the callback data from TikTok: For example, com. playlist_last_updated More than 500 research teams use TikTok's Research Tools today. The value should be Bearer. list<CommercialContent> The list of commercial contents. "application/json" Yes. true You will hear back from us 1-2 weeks after submitting the application. The request_id for which the status is requested. ; Your app must be approved for the video. See Video Object below for a full list of values. Security advisory: Verifying integrity using client_ticket. post_info. access_token. Through integrating and calling the TikTok API for Business interface, developers can leverage our interface to interact with TikTok Ads Manager, TikTok Accounts and TikTok Creator Marketplace functionalities. content_published_date_range. Research API Usage FAQs Obtain a client key and client secret by logging in to Developer Portal and selecting your app. Products. When you are ready to submit your TikTok API for Business is a series of interface services provided by TikTok for Business to developers. There is a migration plan related to this API. Send the video to TikTok servers (not needed if transfer method is PULL_FROM_URL). We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, Community. In this example, when a visitor clicks the profile_deep_link, they will be redirected to the creator's profile page For example, if a server runs out of memory, a script can automatically restart it. tiktokapis. Additional data access may require approval for additional Scopes. Upload draft to TikTok. list. Obtain a client key and client secret by logging in to Developer Portal and selecting your app. User's profile image. After successfully completing authentication with TikTok, your application will be able to request access to basic user data I have a developer account with TikTok. playlist_item_total. Design Guidelines. Int64. Default limits are provided below Send a share request. single and portability. TikTok video from Tom Shaw (@tom. ; The target TikTok user must have authorized your app for the video. Organizations allow developers to collaborate as a group. This guide Through integrating and calling the TikTok API for Business interface, developers can leverage our interface to interact with TikTok Ads Manager, TikTok Accounts and TikTok Creator Migrating to our new API. The time range during which the commercial contents were published. Our runner-up submission, TikTok Finds, provides users the ability to create and customize their own shopping lists in TikTok and seek inspiration from others' wishlists. The duration of the TikTok video in seconds. ”. Server API. It is possible that the API returns less comments than the max count due to reasons such as Key. publish scope. At TikTok, we strive to encourage innovation, so we're launching this channel to grow resources for our community. For more information about how to set up a webhook subscription, see Webhooks Overview. basic. The generated client access token. string. You can view your approved research projects here. ; The access token and open ID of the TikTok user who authorized your app. video_description. Integration Essentials. The token that bears the authorization of the TikTok user, which is obtained through /v2/oauth/token/ We will use the Display APIs to display a TikTok user's profile and videos on your platform. com. No We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, including exclusive content from TikTok DevDay. 5945 Likes, 40 Comments. It is a comma separated list. In addition, you can design features to This guide will show you how to get an authorization code and an access token in order to utilize the Display APIs. basic gives read-only access to a user's avatar and display Key. String. UTC Unix timestamp at which the data collection was requested. The music ID of the video. ; February 29, 2024: End of life for v1 OAuth API, for web apps only. Webhooks let you subscribe to events and receive notice when an event occurs. To ensure a successful submission to the Data Portability API, please review these guidelines for each question carefully, including the FAQ. This page provides guidelines for you to better understand our integration processes and requirements. max_count. The following example demonstrates how to use the TikTokEntryActivity to receive the Access to additional user data requires approval from TikTok for Developers website. ; If you have a version of the app that has been approved and is live, you can revert back to that configuration by clicking Revert to Live version in the Import dropdown. Test Stage: Query the data using TikTok's query software development kit (SDK). list<Condition> The or conditions specify that at least one of the conditions in the list must be met. Learn more on Scopes Overview . The height of We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, including exclusive content from TikTok DevDay. See User Info Object below for a full list of values. It is strongly recommended that webhook consumers verify these signatures before processing each webhook event. May 12, 2023: All new apps registered on TikTok for Developers must use v2 OAuth APIs. No. developer): “Learn how to automatically generate example data in Postman for API testing, making your testing process more efficient and hassle-free. TikTok webhooks are sent with a signature the destination server can use to verify that the event came from TikTok and not a third party or malicious system. Note that the website behaves differently on Mobile and Desktop devices. The video/query/ endpoint, given a user and a list of video ids, can check if the videos belong to the requesting user and fetch the data of videos belonging to the user. cursor. com under Manage apps. all. DateRange. Upload Overview. Obtain the client_key and client_secret located in Overview. Note: the cursor value is a UTC Unix timestamp in milli-seconds. Cobuilds bring new requirements, however. VCE Reference. LoginKit is available on iOS, Android, Desktop and Web. The VCE allows you to access and analyze TikTok's public data in two stages. cursor to the next request will yield the results for the next page. tiktokapi. Instead of waking up at 2 AM, We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, This guide details how to enable authentication from your desktop app to TikTok. has_more is true, pass in the response. To upload a video without posting it, you must invoke the Content Posting API to do the following: Initialize the video upload. You can use the shareFormat field in the share request object to share images or videos with TikTok in different formats. Open the video webpage on tiktok. Created based on feedback from our partners, our new API follows industry standards including OAuth 2. It can be used to refresh the given videos' cover image URL TTL. What is TikTok API? API refers to Application Program Interface that helps developers leverage each other application’s data and functionality through a documented interface. Log in using your TikTok developer account. Content Posting APIs are compatible with desktop, cloud, and web applications. The username as the unique identifier of the video creator "region_code" string. Prerequisites Register your app. The permissions are granted on a scope level. and Europe can apply to study public data about TikTok content and accounts. ; On the app page, switch the toggle next to your app's name to Production. Follow these Register your app with the TikTok for Developers website. Get started. When rendering the Export to TikTok page, your app must invoke the API and use the latest creator information returned to display the account's available privacy level options and video/photo interaction settings. basic gives read-only access to a user's avatar and display Developer Guidelines. TikTok API for Business is a series of interface services provided by TikTok for Business to developers. avatar_url_100. List items are sourced from TikTok Shop, giving users a delightful pathway to explore and purchase products right inside the TikTok app! TikTok API for Business is a series of interface services provided by TikTok for Business to developers. expires_in. info. There are several official TikTok’s APIs which provide developers with tools to integrate TikTok functionalities into their applications and access TikTok data. Use the /v2/video/list/ and /v2/video/query/ APIs to get the metadata of a TikTok user's videos and integrate an embedded video player into your product. In this blog post, we'll give you an overview of TikTok for Developers and show you how to get started building apps using the TikTok API and SDK. Cursor for pagination. Example. These stages are meant to protect user privacy and help organize your data analysis. TikTokEntryActivity. The maximum number of accounts the user follows returned in a single response. If you're a researcher interested in using TikTok Research API, check out our documentation and explore the examples included inside the TikTok Research Key. basic and video. Content Sharing Guidelines. duration. Query Videos. scope. The date range during which the ads were published. You can now learn about our developer products and interesting stories from the tech teams that build TikTok. The TikTok User Info and Video Posts API is an essential tool for developers looking to integrate user information and video content from the popular TikTok platform into their applications. This section demonstrates how to successfully upload videos or photos to TikTok for the user to review and post. Developers sign in with their TikTok for Developers account, create or join an organization for their company, department, or group, and then cooperate on their project. You will need access to: A TikTok developer account on TikTok Developer Portal; Approval for both a Login Kit and TikTok API products; Granted user. single scope, Add Data Request can only be called once to create a new request. and. The VCE will return random sample data based on your query, limited to 5,000 records per day. The TikTok Developers API makes it easy to integrate TikTok features directly into third-party apps, websites, and tools. If your application is approved, then you can login to TikTok for Developers account and find the client key required for accessing the Commercial APIs. Type . Create research account After ensuring your eligibility, create a TikTok for Developers account using your professional email address All TikTok creators can post 3-minute videos, while some have access to post 5-minute or 10-minute videos. Query TikTok Shop Products. Configure redirect URI Every TikTok for Developer API requires a scope to be accessed, and sensitive fields are protected by additional scopes. single scopes are authorized by the user:; Example: If scopes portability. If it is expired, then re-invoke the get_qrcode API. It is possible that the API returns less comments than the max count due to reasons such as We are excited that you are seeking to integrate your app with TikTok. user. Given an authorized user and a list of video IDs, the /v2/video/query/ endpoint verifies that the videos belong to the user and returns video details. Obtain a client key and client secret by logging into the TikTok for Developers website. API calls to old endpoints will be rejected. Consider a worst case scenario with 3 runners, and for example a large Jest test suite that takes 3 minutes to produce a failing result: Job extra1 acquires the We're launching our official TikTok Every TikTok for Developer API requires a scope to be accessed, and sensitive fields are protected by additional scopes. Follow for more coding videos. video. ; Click Draft in the left navigation panel. list scopes for your app; A TikTok account with a few posted Build awesome experiences and powerful tools that inspire creativity and allow users to create, connect, and share with the world. See Product Info Object below for a full list of values. Product. A comma-separated list (,) of the scopes the user has agreed to authorize. TikTok has rapidly grown into one of the most popular social media platforms, attracting users and businesses alike. effect_id . The unique ID of the playlist. Using organizations, multiple developers can work together on registered apps in TikTok for Developers. not. We’re excited to announce the official TikTok for Developers YouTube channel, a new space for you to learn about TikTok's latest technologies and beyond. Example response The VCE allows you to access and analyze TikTok's public data in two stages. Register your app following these steps. 123451234512345. To directly post a video to users' TikTok accounts, you must invoke the Content Posting API - Direct Post endpoint to perform the following actions: Query creator information to render the UI elements to be displayed on the Export page of your app. list scopes for your app; A TikTok account with a few posted Query TikTok Shop Info. Once authenticated users authorize your app, you can access their basic TikTok profile data including their display name and avatar. Users have the rights to only agree to a subset of scopes you requested from them. bool. Sign up for a developer account on the TikTok for Developers website. 0 and provides an improved integration experience. ; Build share content for images and videos into the MediaContent model. Here are some example scopes: user. ; Click Import, then select the sandbox you want to import from. basic allows access to APIs and data related to the basic user of a TikTok user. 1703186989 Most endpoints provided by TikTok for Developers require direct consent from TikTok users before you Users have the rights to only agree to a subset of scopes you requested from them. A shareable link for this TikTok video. ; Format. The following example demonstrates how to use the TikTokEntryActivity to receive the We're launching our official TikTok for Developers YouTube channel for our community to explore TikTok's tools, APIs, and developer insights, including exclusive content from TikTok DevDay. It can be used to refresh the given videos' cover image url TTL. Programmatically, you may convert a TikTok's video URL into embedded video markup by using the oEmbed API. string To directly post a video to users' TikTok accounts, you must invoke the Content Posting API - Direct Post endpoint to perform the following actions: Query creator information to render the UI elements to be displayed on the Export page of your app. For example, the scope user. Indicate the original media type of the resource. Query TikTok public content data. Create a new app, add the required details, and submit it for review. Key. The target TikTok user must have authorized your app for the video. Mobile SDK. Required. If we need any Key. Additionally, you can provide different posting options in your app by letting creators either post their content directly from your app to their TikTok profile or upload it to TikTok as a draft for further editing. jcarxevcuuutuwmragjztbovmoccostjqkjmxccbhrohxygfyklmvfx