{"info":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","description":"

This is the official documentation for the API.

It lets you build your own service based on the services we provide.

You can view code examples in the dark area to the right; switch the programming language of the examples with the tabs in the top right.

License: Apache 2.0

Authentication

The API is JSON based.

In order to make an authenticated call to the API, you must include your Public Key and Private Key. We use two headers for this, X-Public-Key and X-Private-Key, they are passed along in every request in order to authenticate it.

Register A Client

In order to use the API, you must have an active Reseller Account.

After successfully registering a new application, you will be given a set of 2 unique keys:

PUBLIC_KEY
SECRET_KEY

\n
Make sure to keep these keys secret. \nThese two keys are subsequently used to authenticate all your API calls.
\n

Authenticating A Request

In this step we'll teach you how to authenticate your requests.

The first thing you need to know is the parameters that go into generating the signature, these parameters are:

Private-Key
Public-Key

\n
They are available in your reseller panel, after your application is accepted.
\n

Simply combine both Public-Key and Private-Key into an Header called X-Signature and the request will be authenticated.

X-Signature is built in the following manner:

X-Public-Key&X-Private-Key\n

Testing The Authentication

Use the following request to test the Authentication:

curl -X GET /api/client/me/ \\\n  -H 'Accept: application/json' \\\n  -H 'X-Signature: {{public_key}}&{{private_key}}'\n

\n
You can also use wget.
\n

You can test your authentication headers via an API call.\nThis lets you know if your authentication module is fully operational.

Errors

Information regarding Error Codes.

Error Codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Meaning
invalid_input	One of the inputs is invalid.
json_error	The json sent in the request is invalid.
not_authenticated	The Authorization token is either invalid or missing.
permission_required	The Authorization token doesnt grant permission for the action.
account_has_no_permission	The Account doesnt have permission to join the group.
receiver_has_no_permission	The Receiver doesnt have permission to join the group.
account_and_receiver_have_no_permission	The Receiver and Account both lack permission.
two_factor_required	The Account requires a Two Factor code to login.
verification_required	The Account requires verification.
account_does_not_exist	The Account does not exist.
wrong_password	The Account has wrong password.
not_found_on_tiktok	The Account or Receiver was not found on Tiktok.
receiver_is_private	The Receiver is private.
editing_different_accounts	The Account you're editing has a different ID.
account_has_no_profile_picture	The Account has no profile picture.
account_already_exists	The Account already exists in another user.
subscription_expired	The Subscription has already expired.
max_likes_exceeded	The number of likes selected surpasses the limit.
no_receiver_selected	No Receiver account selected.
max_receivers_exceeded	Only one Receiver account can be selected.
group_not_suported	Your Slot doesn't support that group.
group_doesnt_exist	The selected group doesnt exist.
off_timer	You must wait a few hours before activating the slot again.
server_error	There has been an issue with our servers.
not_found	One of the parameters were not found.
missing_field	One of the parameters is missing.

\n\n\n

Webhooks

Every time an object is changed, either through the API or through our scripts (for example, if your receiver account goes private, and your slots are deactivated), we send a Webhook you can use to use to keep your system synchronized.

Our webhooks have the following model:

key - Represents the type of the webhook
data - The object which was changed (we send the whole object)
date - A timestamp of the moment in which the change occured

These are the possible keys for the webhooks:

account_changed
account_deleted
receiver_changed
receiver_deleted
settings_changed

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Authentication","slug":"authentication"},{"content":"Errors","slug":"errors"},{"content":"Webhooks","slug":"webhooks"}],"owner":"6602131","collectionId":"e708ae26-3bc0-44cb-9441-5f105a6ea348","publishedId":"TVYJ6HHT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"D632AB"},"publishDate":"2020-10-29T15:05:43.000Z"},"item":[{"name":"Products","item":[{"name":"Monthly Engagement Likes","item":[{"name":"Settings","item":[{"name":"Retrieve","id":"c065864c-53c9-4003-aabc-f532598f1036","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"url":"https://likeworker.com/api/clients/{{public_key}}/products/{{product_id}}/settings/","description":"

Retrieve a user's monthly likes product settings.

Update a user's monthly likes product settings.

Turns off a user's monthly likes slot without triggering the off timer.

This is useful to turn a user's slot off in the case he didn't renew his subscription.

The slot will be turned off but it will be possible to turn it on immediately using the update settings endpoint.

\n
This endpoint can only be used once per month.
\n

Manage a user's monthly likes product settings.

\n","event":[{"listen":"prerequest","script":{"id":"ea03f8c4-ed1a-4503-b0d6-4a0427a1f732","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3bb61883-718b-4ddd-86fe-11f531c2e045","type":"text/javascript","exec":[""]}}],"_postman_id":"fbb553d0-9a01-49d1-9b67-c4f0176b4493","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Create","id":"950e2044-31a7-4335-b5c5-0c22ec03915c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n\t\"product_id\": 67,\n\t\"settings\": \n {\n \"receiver\": {\"username\":{{receiver_username}}},\n \"max_engagement\": {{number_of_likes}},\n \"active\": {{active}}\n }\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/products/","description":"

Create a new monthly engagement product slot.

Manage a user's monthly engagement products.

\n","event":[{"listen":"prerequest","script":{"id":"cf97716a-0b0c-41b6-a0e1-ce23cd793411","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"4ddd1646-e767-4e76-8429-4761f7913f40","type":"text/javascript","exec":[""]}}],"_postman_id":"2f00b012-4aad-450c-b195-3214041e0b91","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Monthly Engagement Views","item":[{"name":"Settings","item":[{"name":"Retrieve","id":"8528ab50-6ae5-4b86-aaf5-d7d52161f7a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"url":"https://likeworker.com/api/clients/{{public_key}}/products/{{product_id}}/settings/","description":"

Retrieve a user's monthly likes product settings.

Update a user's monthly likes product settings.

Turns off a user's monthly likes slot without triggering the off timer.

This is useful to turn a user's slot off in the case he didn't renew his subscription.

The slot will be turned off but it will be possible to turn it on immediately using the update settings endpoint.

\n
This endpoint can only be used once per month.
\n

Manage a user's monthly likes product settings.

\n","event":[{"listen":"prerequest","script":{"id":"ec4aeca9-d9b3-4e9e-a0cc-f6e849576485","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a369cd58-66b5-4247-8b0f-9a908379bff5","type":"text/javascript","exec":[""]}}],"_postman_id":"c2b0827b-7466-45b1-95c0-bf726a25c3dc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Create","id":"8ddd0897-2149-4584-a51d-995c939e30e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n\t\"product_id\": 68,\n\t\"settings\": \n {\n \"receiver\": {\"username\":{{receiver_username}}},\n \"max_engagement\": {{number_of_views}},\n \"active\": {{active}}\n }\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/products/","description":"

Create a new monthly engagement product slot.

Manage a user's monthly engagement products.

\n","event":[{"listen":"prerequest","script":{"id":"cf9d6c63-9798-4746-9795-2743fa03ae18","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a105dfad-a359-4983-b544-911c3b563d98","type":"text/javascript","exec":[""]}}],"_postman_id":"5739f4dc-06f0-4cb7-97a0-d3b5cc569b4f","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Growth Service","item":[{"name":"Settings","item":[{"name":"Retrieve","id":"42d3cadf-5696-4f33-80e3-46a258c9e81f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"url":"https://likeworker.com/api/clients/{{public_key}}/products/{{product_id}}/settings/","description":"

Retrieve a user's growth service product settings.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["api","clients","{{public_key}}","products","{{product_id}}","settings",""],"host":["likeworker","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"42d3cadf-5696-4f33-80e3-46a258c9e81f"},{"name":"Update","id":"1570a826-3296-415d-ad3e-cb346800f8ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n \"account\": {\"account\":{{account_pk}}},\n \"targets_json\": {\"users\": [{{target_user}}]},\n \"settings_json\": {\"like\": {\"gender\": \"all\", \"enabled\": false, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"ignore_users\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"follow\": {\"apply_filters\": false, \"gender\": \"all\", \"enabled\": true, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"auto_accept_request\": false, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"user_likes_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"comment\": {\"gender\": \"all\", \"enabled\": false, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"ignore_users\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"timezone\": \"UTC+01:00\", \"unfollow\": {\"enabled\": false, \"activity_speed\": \"fast\", \"whitelist_followings\": true}},\n \"active\": {{is_active}}\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/products/{{product_id}}/settings/","description":"

Update a user's growth service product settings.

Turns off a user's growth service product slot.

Manage a user's growth service product settings.

\n","event":[{"listen":"prerequest","script":{"id":"b9e23d37-fabf-4c66-bd3b-de6eadde4b36","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"8bf21ce5-275e-4a25-b48c-3a296dfda278","type":"text/javascript","exec":[""]}}],"_postman_id":"3e290d72-90ba-4322-a78f-3658f92d3bb2","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Accounts","item":[{"name":"Create","id":"42d4961a-e1ba-4ea1-a8bf-18dde2660cc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n\t\"username\":{{account_username}},\n\t\"password\":{{account_password}},\n \"country\": {{account_country}}\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/","description":"

Add a new Tiktok account.\nCountry field is the 2 characters that matches the country ISO 3166 code which defines the name of the country. Example: \"US\" for United States or \"GB\" for Great Britain. List can be seen here: https://www.iso.org/obp/ui/#search

This request will just add the Tiktok account to your user account, but a login on Tiktok will not be tested until the account gets added into a Product or you send a POST /check/ api call to this account.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["api","clients","{{public_key}}","accounts",""],"host":["likeworker","com"],"query":[],"variable":[]}},"response":[{"id":"e182356e-b60d-43e8-9679-2ff66b77ed18","name":"Create","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n \"username\": \"nike\",\n \"password\": \"123nike123\",\n \"country\": \"GB\"\n}","options":{"raw":{"language":"json"}}},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.17.3"},{"key":"Date","value":"Wed, 11 Nov 2020 16:34:11 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"120"},{"key":"Connection","value":"keep-alive"},{"key":"Allow","value":"GET, POST, HEAD, OPTIONS"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Vary","value":"Origin"}],"cookie":[],"responseTime":null,"body":"{\n \"username\": \"nike\",\n \"user\": 89818,\n \"country\": \"GB\",\n \"id\": 208464585232822272,\n \"pk\": \"208464585232822272\",\n \"follower_count\": 1282443,\n \"followed_count\": 0,\n \"media_count\": 22,\n \"avatar\": \"https://p16-sign-sg.tiktokcdn.com/aweme/1080x1080/tos-alisg-avt-0068/smg83d0d083d1bc6ba08abe87e6d35f1844.webp?x-expires=1605196800&x-signature=i2Be%2BZoi%2B7H91p%2FPy8f9VW2vYv8%3D\",\n \"status\": \"unknown\"\n}"}],"_postman_id":"42d4961a-e1ba-4ea1-a8bf-18dde2660cc5"},{"name":"Create With Phone","id":"4bd399a1-f3a1-4be9-86eb-f12fba877022","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"phone_country_code\": \"44\", //Great Britain country code\r\n \"phone_number\": \"123456678\", //Phone number associated with Tiktok Account\r\n \"code\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/create-with-phone/","description":"

Add a new Tiktok account with its Phone Number.\nCountry will be set by us depending on the Phone country code.

\"code\" field should be null on the first time this request is sent. The Tiktok code will be sent to the original account owner phone, which then must be placed into the code field, for the second time this request is sent.

This request will try to login with the account automatically on Tiktok. If login is successful, the account will be automatically added into your list of accounts and you will get the same Account model on response as Create request.

Check the credentials of a Tiktok account. If fails due to requiring a code from email/phone please use the /validate/ API call.

There are alot of errors due to proxy outage, or maybe temporary block from Tiktok, or temporary connection issues where on fail response will be requested to try later, there is nothing much you can do on these cases other than try later.

Some accounts might not even be able to ever login (around 3-5% of all accounts), in these cases we cannot do much.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["api","clients","{{public_key}}","accounts","{{account_id}}","check",""],"host":["likeworker","com"],"query":[],"variable":[]}},"response":[{"id":"4741ee5e-33bd-47a4-a055-95483ad3d549","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":""},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/{{account_id}}/check/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Thu, 07 Feb 2019 15:05:31 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"129"},{"key":"Connection","value":"keep-alive"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Vary","value":"Origin"}],"cookie":[],"responseTime":null,"body":"{\n\t\"id\":50847104,\n\t\"avatar\":\"https://scontent-lhr3-1.cdninstagram.com/vp/79c06bbfc49e46481bd8711726f3bdf6/5CB698E1/t51.2885-19/25010009_1766741953630246_1169446855134674944_n.jpg?_nc_ht=scontent-lhr3-1.cdninstagram.com\",\n\t\"media_count\":748,\n\t\"follower_count\":6130,\n\t\"followed_count\":380,\n\t\"is_business\":true,\n\t\"username\":\"claudio\",\n\t\"status\":\"ok\",\n\t\"created_date\":\"2018-12-19T15:41:14.473463Z\",\n\t\"user\":529\n}"},{"id":"cd54af61-ba90-49fe-a583-f62adff066f8","name":"Wrong Password","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":""},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/{{account_id}}/check/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Thu, 07 Feb 2019 15:05:31 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"129"},{"key":"Connection","value":"keep-alive"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Vary","value":"Origin"}],"cookie":[],"responseTime":null,"body":"{\n \"source\": null,\n \"message\": [\n \"Claudio has wrong password. Please provide the correct password.\"\n ],\n \"error_code\": \"wrong_password\"\n}"}],"_postman_id":"1ddc46f2-43cf-4ca5-9533-2156f9650d55"},{"name":"Validate","id":"2e7a259c-eaba-4522-89b2-75068ad10977","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n\t\"code\": {{code}}\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/accounts/{{account_id}}/validate/","description":"

When an account is forced to be validated, the original owner receives a code either by phone or email.

Use this endpoint to submit the code, if successful Account model will be received, else there will be an error.

Information regarding a particular Tiktok account.

List all the Tiktok accounts belonging to a client.

Update the credentials of a Tiktok account.

Delete a Tiktok account.

Operate the accounts managed by a client.

Model

Accounts are composed by the following attributes:

id - Tiktok account id - Integer
pk - Tiktok account id - String
username - Tiktok account username - String
country - Tiktok country associated with this Account - String
avatar - Tiktok account avatar - URL
media_count - Total number of Tiktok posts - Integer
follower_count - Tiktok account number of follower accounts - Integer
followed_count - Tiktok account number of followed accounts - Integer
status - Status of the account - String
user - Id of the user who owns the account - Integer

The possible values for the status field are:

unknown - The initial status of the account once it's been added.
ok - Represents an account with a successful session, and ready to engage.
bad_password - Indicates the account has wrong password.
challenge_verification - Code submition is needed for login validation.
challenge_wrong_code - Wrong code was submitted when requested to validate the login.
invalid_user - Indicates the account was not found on Tiktok.
not_registered - Account is not registered on Tiktok.
sentry_block - Account was blocked from logging in.
blocked - Unknown response from tiktok

Context information about status fields:

challenge_verification - Code was sent to the original Tiktok Account user phone or email. Code must be submitted in order to validate the login. Expire time is around 1 minute.
invalid_user - Might happen if after adding account to service the user later changes username of the account.
not_registered - Tiktok replies that the account does not exist however this is not true. Probably a bug from Tiktok, rarely happens but we cannot do much about this.
sentry_block - Account was blocked from logging in, there are multiple reasons behind this. Usually just trying again or later will work. If persists permanent on one account let us know.
blocked - Might happen if there is a new response from Tiktok which is not handled by us yet. Just let know the account and we will update it.

\n","event":[{"listen":"prerequest","script":{"id":"e1b54ef5-d206-41aa-86b0-d93917eaf69a","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"0b0f8778-71b8-4168-8081-8fc0d67fc6c9","type":"text/javascript","exec":[""]}}],"_postman_id":"86a7488a-34cc-4477-b300-f03c7205bf85","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Targets","item":[{"name":"Retrieve","id":"759986df-0fb7-45c6-a739-93f364f81654","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\"username\": \"nike\"}","options":{"raw":{"language":"json"}}},"url":"https://likeworker.com/api/clients/{{public_key}}/growthservice/sources/","description":"

This call will retrieve a source data, that will be placed into targets_json field on Growth Service Product settings.

Get Source Targets with these API calls\nThese targets will then be used on your product settings \"targets_json\" field.

\n","_postman_id":"93034e21-ad54-49eb-aff7-0e5502790290","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Create","id":"4a4ba1be-985b-4745-9d73-03ceacebc731","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"body":{"mode":"raw","raw":"{\n\t\"product_id\": 27,\n\t\"settings\": \n {\n \"account\": {\"pk\":{{account_pk}}},\n \"targets_json\": {\"users\": [{{target_user}}]},\n \"settings_json\": {\"like\": {\"gender\": \"all\", \"enabled\": false, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"ignore_users\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"follow\": {\"apply_filters\": false, \"gender\": \"all\", \"enabled\": true, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"auto_accept_request\": false, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"user_likes_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"comment\": {\"gender\": \"all\", \"enabled\": false, \"targets\": \"all\", \"media_age\": \"2592000\", \"media_type\": \"all\", \"ignore_users\": \"all\", \"public_users\": true, \"repeat_users\": false, \"activity_speed\": \"fast\", \"profile_quality\": true, \"user_posts_limit\": {\"max\": null, \"min\": \"9\"}, \"media_likes_limit\": {\"max\": null, \"min\": null}, \"only_business_users\": false, \"media_comments_limit\": {\"max\": null, \"min\": null}, \"user_followers_limit\": {\"max\": null, \"min\": null}, \"user_followings_limit\": {\"max\": null, \"min\": null}, \"avoid_sensitive_content\": true}, \"timezone\": \"UTC+01:00\", \"unfollow\": {\"enabled\": false, \"activity_speed\": \"fast\", \"whitelist_followings\": true}},\n \"active\": {{is_active}}\n }\n}"},"url":"https://likeworker.com/api/clients/{{public_key}}/products/","description":"

Create a new growth service product slot.\nThe \"settings\" field is not required and we will give you a default which can later be changed with the Update call.

Manage a user's PowerService products.

\n","event":[{"listen":"prerequest","script":{"id":"6b3fb65c-0831-4dd9-91f7-f81d682ad439","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"424a1559-683f-4e90-881d-9ffcaa74e2f4","type":"text/javascript","exec":[""]}}],"_postman_id":"4667e35e-afa4-4efd-a0ea-ea907cb85f51","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"List","id":"ef96a873-061e-4b19-9d72-2eb56d3326ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"}],"url":"https://likeworker.com/api/clients/{{public_key}}/products/","description":"

List all user's active products.

Delete a user's particular product.

Manage a user's products.

\n","event":[{"listen":"prerequest","script":{"id":"e05b247d-745c-4db1-ba71-424658b0725f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"21f81cd1-db0b-4556-a99e-d837b6ed0ad8","type":"text/javascript","exec":[""]}}],"_postman_id":"9b38f7fc-5691-44e5-885d-39633fd9a007","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}},{"name":"Checkout Products","item":[{"name":"Retrieve Posts","id":"f9baa820-884c-472f-b31f-78a2ecd02f9a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Signature","type":"text","value":"{{public_key}}&{{private_key}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"receiver\": {\"username\":{{username}}},\n \"posts_required\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://likeworker.com/api/retrieve-posts/","description":"

Retrieve a Tiktok account's info/posts list.

Send \"posts_required: false\" if you do not need the account posts (for follower orders), this will make the request faster as we won't need to fetch the account posts.

Even if you do not need the posts, you should make this request, to validate that the Tiktok account exists, and retrieve the account info (name, avatar, followers etc) and display on your Frontend if so desired.

Validates the creation of a Checkout Order.

If everything checks out correctly with this request, you should proceed with customer payment and only then make POST request to fulfill the order.

Services: Min-Max Amount
\nlikes: 10-5000
\nviews: 10-50000
\nshares: 10-50000
\nfollowers: 10-5000

posts_json: [posts] - Posts are retrieved from \"Retrieve Posts\" API - pass [] if not applicable (in case of ordering followers)

amount: This amount will be spread throughout the posts_json if applicable.\n
Ex: In case posts_json.length = 2 and amount = 5000, then 2500 (5000/2) will be delivered to each post.

speed: 1-260000 in seconds
\nIf speed = 1 we will always deliver as fast as we possibly can.
\nFor reference we should be able to deliver 1k followers/likes/views/shares every 5 minutes.

Executes the order.

Be careful as it is not possible to cancel orders.

Endpoints to implement a Service Checkout Page.

Services Available: likes, views, shares, followers

\n","event":[{"listen":"prerequest","script":{"id":"a0a5c3c1-239e-4e8e-9107-87a475595f27","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f0093d16-eb01-4a9e-857d-1c50023ad109","type":"text/javascript","exec":[""]}}],"_postman_id":"dd5f4092-ef58-4845-9f46-bddbb3614245","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","id":"e708ae26-3bc0-44cb-9441-5f105a6ea348","name":"TikTok API Resellers","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"8e541cdc-65e8-451b-a4a1-0b230960aa16","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c6eea40a-7876-4340-9841-57d78ba412c4","type":"text/javascript","exec":[""]}}],"variable":[{"key":"public_key","value":"{{public_key}}"},{"key":"private_key","value":"{{private_key}}"},{"key":"evoironment","value":"api"},{"key":"website","value":"https://fueltok.com"}]}