01 / Identify the account.
A query starts with a TikTok username. Tikvoya removes a leading @ and normalizes the handle for lookup. A full profile URL, or a full TikTok link containing an author’s @username, is reduced to that username.
| Input | How it is handled |
|---|---|
tiktok or @tiktok | Look up the exact handle tiktok. |
tiktok.com/@tiktok | Extract the handle from the profile path. |
A full /@username/video/… link | Look up the author’s profile. The video itself is not retrieved. |
| A supported TikTok share link | Attempt a bounded redirect check on allowed TikTok hosts. If no handle can be extracted, ask for the full profile URL. |
Short links are not guaranteed to resolve. Tikvoya does not treat an arbitrary web address as a profile source, and it does not perform a search for similar names.
02 / Request public profile data.
The Tikvoya server sends the normalized username to the SerpBase TikTok Profile API. The API credential stays on the server. Your browser communicates with Tikvoya rather than receiving that credential.
SerpBase is the third-party data provider. Tikvoya is not reading from an official TikTok account-management connection. Source access, parsing and upstream restrictions can all affect what comes back.
A successful source response contains a profile record. Tikvoya checks that response before preparing a result. A network failure or a source error is shown as a lookup problem, not relabeled as a deleted account.
03 / Display what was actually returned.
The server selects the supported fields and sends JSON to the browser. JavaScript then builds the profile panel. It does not generate a separate public profile page.
| Field group | What you may see | How to read it |
|---|---|---|
| Account details | Name, username, avatar and bio | Information attributed to the account by the source. |
| Status | Verified or private-account indicator | A source-reported status, not independent verification by Tikvoya. |
| Counts | Followers, following, likes and posts | A snapshot; not an audit or a historical series. |
| Links | Original profile and a listed website | External destinations. A listed site is not an endorsement. |
Counts use compact notation for readability. Hovering a count shows its full returned number. A dash means that a usable count was not returned; zero is displayed as zero. Missing text is described rather than invented.
04 / Reuse a short-lived snapshot.
A successful lookup is cached under the normalized username for up to five minutes. Another lookup of the same handle during that window can reuse the result, reducing duplicate source requests.
The result shows when Tikvoya retrieved the snapshot and whether it came from cache. That is not a claim that TikTok updated the account at that moment. We do not know the provider’s underlying observation time unless it explicitly supplies one.
There is no refresh button that bypasses this cache. Repeated submissions during the window may show the same snapshot.
05 / Keep uncertainty visible.
- No video or Story browsing. A returned post count does not include the posts themselves. This version does not retrieve TikTok Stories or viewer lists.
- No access to private content. A limited profile response does not bypass account privacy settings.
- No completeness guarantee. A bio, avatar, count or link may be absent or outdated.
- No identity conclusion. A matching handle does not establish someone’s legal identity or trustworthiness.
- No deletion conclusion from an error. Restrictions, timeouts and source failures can prevent a lookup.
Queries are limited to 10 per minute per connection address. Requests may take up to a minute; a share-link resolution can add a short delay. Upstream limits may still apply. If the source is unavailable, retry later rather than drawing a conclusion about the person.
Question a result or this method.
Use the contact form with the affected username, field, approximate lookup time and a public source supporting the correction. Please distinguish a data problem from a misunderstanding of what a count represents.
We can investigate Tikvoya’s handling and wording. Changes to the underlying TikTok profile must be made through TikTok.