Public records, explained field by field

TikTok Hashtag Details API

Use the TikTok Hashtag Details API to look up a tag by full URL or name. Read its public title, description, images and available video and view counts.

1 credits per non-empty successful request; empty results and failures are free.

GETExample response
https://api.goanyapi.com/api/v1/tiktok/hashtag-detail?url=https%3A%2F%2Fwww.tiktok.com%2Ftag%2Ffyp
Visual

Run a request to see the visual result

The response is organized into metrics, lists and tables that match the JSON on the right.

Run a request to see the response here

Fill in the demo parameters to preview an example response for free. Sign in to send live requests with your own parameters.

From a hashtag input to its public profile

The TikTok Hashtag Details API answers a specific question: what public information is available for this known tag? Enter a full tag URL or its name to retrieve a hashtag object and the statistics returned with it. This is useful when adding a tag description and counts to a content index or checking what a shared tag link identifies. It returns tag information rather than a list of videos. The API documentation covers authentication and the complete response reference.

Request a tag, then read the returned objects

For an input example, use GET /api/v1/tiktok/hashtag-detail?challenge_name=fyp with your GoAnyAPI API key in the Authorization header as a Bearer token. Alternatively, supply url=https://www.tiktok.com/tag/fyp and omit the name parameter. These are request examples, not evidence of a new lookup. In the response, start with data.hashtag.title and data.hashtag.desc, then inspect any available counts in data.stats. Keep the returned data.hashtag.id as a reference field if your application needs it. To retrieve videos, send the same tag URL or name directly to the Hashtag Posts API; this details lookup is optional and does not unlock the posts query.

data.hashtag.title / data.hashtag.desc
The title identifies the returned tag; the description is the public descriptive text when available. A blank description does not erase an otherwise useful tag record. These fields can populate a tag information panel, but they are not video captions or a generated summary of the posts.
data.hashtag.id
This is the identifier returned with the tag profile. Preserve it as returned if you store it. The Hashtag Posts API accepts the URL or name directly, so this ID is not a required preparation step for retrieving posts.
data.hashtag.coverThumb / data.hashtag.profileThumb
Cover and profile image fields, including their Medium and Larger variants, may provide image addresses for the tag. They can be absent or empty. An available image describes the tag profile; it does not establish which individual videos belong to the current result.
data.stats.videoCount / data.stats.viewCount
These are the available video and view counts associated with the tag. Video count is not the number of records returned by this details request. View count is not a unique audience total, and neither value establishes growth or the impact of a campaign.
data.statsV2 / data.hashtag.isCommerce
The response may include a second statistics object and a commerce flag. Keep their returned values and labels rather than adding the two statistics objects together. A commerce flag is not sales, revenue or conversion data; a missing flag is not evidence that its value is false.
data.creditsUsed / data.remainingCredits
These fields report the credits used for this request and the remaining balance. Read them separately from hashtag counts. Missing business fields remain missing, null remains null, and valid zero or false values should not be replaced with invented content.

Choose one input and preserve what is returned

Send exactly one of url and challenge_name. A name has no leading # and no spaces. A full URL uses HTTPS on tiktok.com or www.tiktok.com with the /tag/ path; vm.tiktok.com and vt.tiktok.com short links are unsupported. URL handling is included in this request without an extra resolution charge. This is a synchronous GET lookup with no cursor, page size or task polling. Each nonempty successful lookup is billed independently at the configured rate shown in the Tester; empty results and failures are free.

Use tag information in the right place

Describe a known tag

Display the returned title and available description beside a saved tag link, keeping the source fields distinct from your own annotations.

Read counts in context

Show the available video and view counts with your own observation time. Any comparison between saved observations requires your own storage and calculation.

Go straight to posts when needed

Use the posts endpoint directly for videos. Looking up a tag profile and retrieving its posts serve different purposes and are separate requests.

Frequently asked questions

It looks up the tag you supply. It does not accept a free search phrase, return a popular-tag ranking, or discover every tag related to a topic. Choose a known tag URL or name before making the request.

No. The posts endpoint accepts a full tag URL or challenge_name directly. Use this endpoint when you need the tag profile itself. A returned ID can remain reference data without becoming an input to a second request.

Public fields are returned when available, and a successful record need not contain every field. Check the JSON for missing keys, null values and empty strings. Do not interpret an unavailable count as zero or fabricate a description.

No. They are separate returned representations, not two populations to sum. Use a clearly labelled field from the response and keep its provenance. This endpoint does not calculate a reconciled count or a growth percentage.

Opening the saved example does not send a new lookup. Running a real query is a separate action. Its nonempty successful result is charged at the current configured rate, while empty results and failures are free.