Question 1

What does one credit buy?

Accepted Answer

One successfully resolved post. A request that returns a post bills 1 credit; a lookup that fails — deleted, private, region-blocked, bad URL — bills 0. Credits are never consumed by 4xx or 5xx responses.

Question 2

What can I send to the endpoint?

Accepted Answer

A post URL (https://www.tiktok.com/@user/video/123…), a short vm.tiktok.com link. Send them as the url parameter.

Question 3

Do I need a TikTok account, cookies or a proxy?

Accepted Answer

No. Authentication is your JoJ API key only. There is nothing to log in to, no cookies to refresh and no proxy list to maintain.

Question 4

Is the video watermark-free?

Accepted Answer

Yes. `media_list.no_watermak.url` is the clean MP4 (the field name keeps TikTok's original spelling); `media_list.watermark.url` is the watermarked copy. Both carry a size in bytes.

Question 5

Does it work with photo and slideshow posts?

Accepted Answer

Yes. `media_list.images` is an array of image URLs for photo posts and null for videos, so one code path handles both.

Question 6

How fresh is the data?

Accepted Answer

Every request is fetched live. Engagement counts are as of the moment of the request — nothing is served from a shared cache.

Question 7

What happens with private, deleted or region-blocked posts?

Accepted Answer

The call returns HTTP 404 with `ok: false`, a message explaining why, and `data: null`. Your code branches once on `ok`; you are not charged.

Question 8

Is this the official TikTok API?

Accepted Answer

No. It is an independent, unaffiliated service that reads public post data. It is not endorsed by TikTok and does not touch private accounts, DMs or follower data.

Question 9

Can I use it in a commercial product?

Accepted Answer

Yes, under the JoJ API terms. You are responsible for how you use the content and for the rights attached to it — the API gives you the data, not a licence to the videos or music in it.

Question 10

How do quotas work?

Accepted Answer

Fixed plans include a monthly post quota that resets each billing period; unused posts do not carry over. Every response returns `X-Jojapi-Posts-Used` so you can meter from your own code.

Question 11

What happens when I exceed my rate limit?

Accepted Answer

You get HTTP 429 with a retry hint. Rate limits are per plan (3 to 120 requests per second); your quota is not touched by a throttled request.

Question 12

Can I fetch many posts at once?

Accepted Answer

One post per request today — run them in parallel, the rate limit is per second, not per minute. A bulk endpoint metered per returned post is next on the roadmap; message me if you need it and it moves up.

Question 13

Can AI agents call it?

Accepted Answer

Yes. Every JoJ API is also an MCP server (mcp.jojapi.com/itsrose-tiktok-api), and agents can pay per request with x402 or MPP without opening an account.

Question 14

How do I cancel or get a refund?

Accepted Answer

Cancel any time from Workspace → Subscriptions; access runs to the end of the period. Refunds follow the JoJ refund policy, and a plan that never worked for you is refunded without argument.

TikTok Content

Frequently Asked Questions