wotohub

English API reference for WOTOHUB, prepared for Theneo import.

## How to Access the WOTOHUB API

If you need API data services, please first contact our account manager to discuss your business needs and use cases.

We will tailor a suitable data solution based on your requirements and provide a clear pricing plan.

Once everything is confirmed, we will generate a dedicated `client_secret` for you.

After that, you can follow this documentation to integrate with the WOTOHUB API and start using the data services.

## Base Information

**Base URL**
`https://api.wotohub.com/api-gateway`

**Request Format**
`application/json`

**Authentication**
`Authorization: Bearer <client_secret>`

## Required Headers

| Header | Description |
|---|---|
| `Content-Type` | Must be `application/json` |
| `Authorization` | Format: `Bearer <client_secret>` |

## Notes

To ensure service stability, the request frequency for each `client_secret` is limited.

We recommend keeping your requests within **60 requests per minute**.

WOTOHUB API

Common onboarding and shared lookup endpoints.

This group corresponds to the introductory part of the original documentation, including:
- Basic request rules
- Authentication
- Status codes
- Dictionary lookup


Base Info

Retrieve dictionary data by dictionary type code.

This endpoint is typically used before creator search requests so you can translate business filters into supported dictionary values.

### Supported dictionary type codes

- `blog_cate_new`: Creator category
- `dim_region`: Creator country / region


Dictionary Lookup

YouTube creator search, creator profile lookup, creator contact lookup, and video detail endpoints.

YouTube

Search YouTube creators by keyword or creator name with advanced filters.

### Search modes

- `KEYWORD`: Search creators by keywords
- `NAME`: Search creators by creator name

### Common filter groups

- Region filter
- Creator category filter
- Followers range
- Average engagement rate range
- Email availability
- View volume conditions

### Sorting

Supported sort fields include:
- `FANS_NUM`
- `VIEW_AVG`
- `INTERACTIVE_RATE`
- `TOTAL_STAR`


YouTube Creator Search

Retrieve `channelUid` by YouTube username.

Use this endpoint when you already know the creator handle or channel name and need the internal `channelUid` required by detail, contact, and video-list endpoints.


Get YouTube Creator Channel UID

Retrieve detailed creator information by `channelUid`.

The response includes creator profile information, performance metrics, and audience distribution data.


Get YouTube Creator Details

Retrieve the creator video list by `channelUid`.

This endpoint is useful for reviewing recent content performance and building downstream video-level analysis.


Get YouTube Creator Video List

Retrieve creator contact information by `channelUid`.

Get YouTube Creator Contact Info

Get YouTube Video Details

TikTok creator search, creator profile lookup, creator contact lookup, and video detail endpoints.

TikTok

Search TikTok creators by keyword or creator name with advanced filters.

The filter model is broadly aligned with the YouTube creator search endpoint.

In addition to common creator data, TikTok responses may include:
- GMV-related fields
- TikTok Union indicator
- Additional recent performance metrics


TikTok Creator Search

Retrieve `channelUid` by TikTok username.

Get TikTok Creator Channel UID

Retrieve detailed creator information by `channelUid`.

The response typically includes profile information, content performance metrics, and audience distribution fields.


Get TikTok Creator Details

Retrieve the creator video list by `channelUid`.

Get TikTok Creator Video List

Get TikTok Creator Contact Info

Retrieve video details by `videoId`.

The published source page exposes the request model but provides limited response-field detail.
The response schema here is standardized to match sibling video-detail endpoints for documentation consistency.


Get TikTok Video Details

Instagram creator search, creator profile lookup, creator contact lookup, and video detail endpoints.

Instagram

Search Instagram creators by keyword or creator name with advanced filters.

The request model is aligned with the broader creator-search pattern used across platforms.


Instagram Creator Search

Retrieve `channelUid` by Instagram username.

Get Instagram Creator Channel UID

Retrieve detailed creator information by `channelUid`.

The response includes profile, business, performance, and audience distribution fields.


Get Instagram Creator Details

Get Instagram Creator Video List

Get Instagram Creator Contact Info

Get Instagram Video Details

Brand

Search brands with pagination, fuzzy brand name matching, and sorting.

### Supported sort values

- `bloggerCountDesc`: Sort by follower count descending
- `contentCountDesc`: Sort by video count descending
- `interactiveRateDesc`: Sort by engagement rate descending
- `viewCountDesc`: Sort by view count descending


Brand Search

Default

wotohub_api_en

Production

The WOTOHUB API provides authorized users with secure access to customized data services that support a variety of business requirements. By integrating with the API using your dedicated client credentials, you can efficiently retrieve and manage data to enhance your applications and workflows.The WOTOHUB API enables authorized users to access tailored data services designed to meet specific business needs. After coordinating with your account manager and obtaining a dedicated client secret, you can seamlessly integrate and interact with WOTOHUB’s data solutions to enhance your applications.

The WOTOHUB API provides authorized users with secure access to customized data services that support a variety of business requirements. By integrating with the API using your dedicated client credentials, you can efficiently retrieve and manage data to enhance your applications and workflows.

The WOTOHUB API enables authorized users to access tailored data services designed to meet specific business needs. After coordinating with your account manager and obtaining a dedicated client secret, you can seamlessly integrate and interact with WOTOHUB’s data solutions to enhance your applications.

The Base Info section provides essential onboarding guidelines and shared reference data to streamline integration. Users can access core authentication details, standard status codes, and lookup key-value dictionaries to ensure consistent and accurate API requests. This foundational information supports a smooth and efficient development experience with the platform.

The Base Info section provides essential onboarding guidelines and shared reference data to streamline integration. Users can access core authentication details, standard status codes, and lookup key-value dictionaries to ensure consistent and accurate API requests. This foundational information supports a smooth and efficient development experience with the platform.

Access comprehensive YouTube creator data to search for creators, retrieve detailed profiles, and obtain contact information. Additionally, explore video-specific details and content associated with individual channels to enhance your integration with YouTube-related insights.

Discover and filter YouTube creators using keywords or creator names combined with advanced criteria such as region, category, follower count, engagement rate, and view metrics. This enables precise targeting and ranking of creators to find the best matches for marketing, collaboration, or analysis.

Defines the type of search to perform, either by keyword (KEYWORD) or by creator name (NAME)

searchType

Creator's name used for the search when searchType is set to NAME

bloggerName

Advanced set of keyword filters used when searchType is KEYWORD to perform detailed searches

advancedKeywordList

List of region codes to filter creators based on specific geographic areas, using dim_region dictionary values

regionList

List of creator category IDs to filter results based on content categories, using blog_cate_new dictionary codes

blogCateIds

Lower limit for the number of fans a creator must have to be included in the search results

minFansNum

Upper limit for the number of fans a creator can have to be included in the search results

maxFansNum

Minimum average engagement rate (percentage between 0 and 100) required for search inclusion

minInteractiveRate

Maximum average engagement rate (percentage between 0 and 100) for filtering creators

maxInteractiveRate

Boolean flag indicating whether to filter creators who have publicly available email addresses

hasEmail

Defines the logic for combining view volume filters, e.g., AND or OR conditions between min and max values

viewVolumeCombination

Defines the sorting criteria applied to the search results, e.g., by views, engagement, or relevance

searchSort

Defines the sorting order of the search results, e.g., ascending or descending

sortOrder

Page number of results to retrieve, supporting pagination of search responses

pageNum

Number of search results returned per page for pagination purposes

pageSize

Bearer token for authenticating requests to the API endpoint

Authorization

Response code indicating the status of the API request

code

Response message providing additional information or status details

message

Unique identifier for tracking the request for debugging and support

traceId

Contains the main payload of the response, including metadata and the list of bloggers matching the search criteria.

data

success

Obtain the unique internal `channelUid` associated with a YouTube creator by providing their username or channel name. This identifier is essential for accessing detailed information, contact data, and video listings related to the creator within the platform.

The YouTube creator's username or channel name used to retrieve the channel UID

username

Bearer token used to authenticate the API request and authorize access to the endpoint

Numeric or string code representing the status or error type of the API response

A descriptive message providing additional context about the API response status

A unique identifier for the API request used for tracing and debugging purposes

The main payload containing detailed information returned by the API

Retrieve comprehensive YouTube creator profiles using a unique channel identifier. This section provides in-depth insights into creator demographics, performance metrics, audience distribution, and content details to help you analyze and understand creator influence and engagement.

The unique identifier for the YouTube creator's channel

channelUid

Bearer token used to authenticate and authorize the API request

Status code indicating the result of the API request (e.g., success or error)

A descriptive message providing additional context about the API response

Unique identifier for tracking and debugging the API request

Container object holding detailed metrics and attributes related to the creator’s profile.

Retrieve a comprehensive list of videos from a specified YouTube creator channel using their unique channel ID. This allows users to access detailed information on recent videos, enabling performance review and supporting in-depth video-level analytics.

The unique identifier of the YouTube creator's channel used to retrieve their video list

HTTP header carrying the bearer token used to authenticate the API request

Numeric or alphanumeric status code indicating the result of the API request

Unique identifier for tracing and debugging the API request lifecycle

The main response payload containing the requested video information and metadata

Use this section to obtain contact details for a YouTube creator by providing their unique channel identifier. It enables you to access verified email information associated with the specified creator, facilitating direct communication or collaboration.

The unique identifier of the YouTube creator's channel used to fetch contact information

Numeric or alphanumeric code indicating the result status of the API request

A descriptive message detailing the outcome of the API request

The main payload containing the requested contact information and related metadata

Retrieve comprehensive metadata for a specific YouTube video by providing its unique identifier. This allows users to access detailed information such as the video's title, channel, publication date, view count, likes, comments, tags, and duration to support content analysis and integration.

Unique identifier of the YouTube video to retrieve details for

videoId

Bearer token used for authenticating the API request

Numeric status code representing the API response outcome

Response message providing additional information about the API request status

Unique identifier for tracing and debugging the API request

Boolean flag indicating whether the API request was successful

Object containing detailed information about the video

This section enables users to search for TikTok creators and retrieve detailed information about their profiles, channels, and contact details. It also provides access to comprehensive data on individual TikTok videos, allowing for in-depth content analysis and creator insights.

Retrieve and explore detailed information about Instagram creators, including searching for creators, accessing their profiles, and obtaining their contact details. Additionally, users can fetch in-depth video data associated with specific creators to enhance content insights and engagement strategies.

Retrieve detailed information about brands and access brand-level metrics to analyze performance and trends. This section enables users to search for brands efficiently and gain insights that support data-driven decision-making.

Sections

Ask an AI

Code with AI