API mạng xã hội

Nhóm này lấy dữ liệu công khai từ 17 nền tảng: chi tiết bài kèm link tải, tìm theo từ khoá, bài của một kênh, thông tin kênh, bình luận, xu hướng, cùng dữ liệu bán hàng TikTok Shop và quảng cáo TikTok tại Việt Nam.

Base URL	https://revidapi.com/v1
Xác thực	header x-api-key: <khoá> (hoặc Authorization: Bearer <khoá>)
Giá	5 credit mỗi lượt gọi thành công — lỗi thì không trừ
Phương thức	POST với thân JSON, hoặc GET với query — cả hai đều được
Kết quả	trả ngay (không phải job), JSON theo cấu trúc của nền tảng

Gọi thử trong 30 giây

# GET với query
curl "https://revidapi.com/v1/tiktok/search?keyword=ph%E1%BB%9F%20b%C3%B2&count=10" \
  -H "x-api-key: $REVID_KEY"

# POST với JSON — cùng kết quả
curl -X POST "https://revidapi.com/v1/tiktok/search" \
  -H "x-api-key: $REVID_KEY" -H "Content-Type: application/json" \
  -d '{"keyword": "phở bò", "count": 10}'

import requests
r = requests.post("https://revidapi.com/v1/tiktokshop/search",
                  headers={"x-api-key": KEY}, json={"keyword": "son môi"})
print(r.json())

Tên tham số dễ nhớ

Mỗi nền tảng gốc đặt tên tham số một kiểu (aweme_id, sec_user_id, search_word…). Cổng nhận cả tên dễ nhớ và tự đổi — xem cột Tên thay thế trong từng bảng. Ba tên dùng được gần như mọi nơi:

Bạn gửi	Ý nghĩa
keyword	từ khoá cần tìm
id hoặc url	mã hoặc đường dẫn của bài / sản phẩm
user	mã hoặc tên kênh

Nền tảng quốc tế và thị trường Việt Nam

TikTok

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/tiktok/ads/hashtags	Hashtag đang lên trong 7/30/120 ngày	—	country_code (VN), period (7), page (1), limit (20)	—	5
/v1/tiktok/ads/search	Tìm quảng cáo TikTok đang chạy theo từ khoá	keyword	country_code (VN), page (1), limit (20)	query→keyword	5
/v1/tiktok/ads/top	Quảng cáo TikTok hiệu quả nhất (CTR, ngành)	—	country_code (VN), page (1), limit (20)	—	5
/v1/tiktok/comments	Bình luận	aweme_id	cursor, count	id→aweme_id, url→aweme_id	5
/v1/tiktok/hashtag	Tìm hashtag kèm số video/lượt xem	keyword	count (20)	query→keyword	5
/v1/tiktok/profile	Thông tin kênh	uniqueId	—	user→uniqueId, username→uniqueId	5
/v1/tiktok/search	Tìm theo từ khoá	keyword	offset, count, sort_type, publish_time, region	keyword→keyword	5
/v1/tiktok/trending	Xu hướng	—	—	—	5
/v1/tiktok/video	Chi tiết bài & link tải	aweme_id	—	id→aweme_id, url→aweme_id	5

Quảng cáo và hashtag (ads/*) mặc định thị trường country_code=VN. ads/hashtags nhận period là 7, 30 hoặc 120 ngày.

curl -X POST "https://revidapi.com/v1/tiktok/ads/top" -H "x-api-key: $REVID_KEY" \
  -H "Content-Type: application/json" -d '{"limit": 20}'
curl -X POST "https://revidapi.com/v1/tiktok/ads/hashtags" -H "x-api-key: $REVID_KEY" \
  -H "Content-Type: application/json" -d '{"period": 30}'

TikTok Shop

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/tiktokshop/hot	Sản phẩm bán chạy trên TikTok Shop	—	region (VN), count (20)	—	5
/v1/tiktokshop/link	Đổi link chia sẻ thành product_id	share_link	region (VN)	url→share_link	5
/v1/tiktokshop/product	Chi tiết sản phẩm: giá, đã bán, shop, biến thể	product_id	region (VN)	id→product_id	5
/v1/tiktokshop/reviews	Đánh giá của người mua	product_id	region (VN)	id→product_id, page→page_start	5
/v1/tiktokshop/search	Tìm theo từ khoá	search_word	region (VN)	keyword→search_word, query→search_word	5

Quy trình hay dùng: search tìm sản phẩm → lấy product_id → product xem giá, đã bán → reviews đọc đánh giá. Có link chia sẻ thì dùng link để đổi ra product_id. region mặc định VN.

curl -X POST "https://revidapi.com/v1/tiktokshop/link" -H "x-api-key: $REVID_KEY" \
  -H "Content-Type: application/json" -d '{"url": "https://vt.tiktok.com/xxxx/"}'
curl -X POST "https://revidapi.com/v1/tiktokshop/product" -H "x-api-key: $REVID_KEY" \
  -H "Content-Type: application/json" -d '{"id": "1729xxxxxxxxxxxxxxx"}'

YouTube

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/youtube/comments	Bình luận	video_id	—	id→video_id, url→video_id	5
/v1/youtube/posts	Bài của kênh	channel_id	lang, sortBy, contentType, nextToken	user→channel_id	5
/v1/youtube/profile	Thông tin kênh	channel_id	—	id→channel_id, user→channel_id	5
/v1/youtube/search	Tìm theo từ khoá	search_query	language_code, order_by, country_code, continuation_token	keyword→search_query	5
/v1/youtube/shorts	Video Shorts của kênh	channel_id	—	id→channel_id, user→channel_id	5
/v1/youtube/video	Chi tiết bài & link tải	video_id	url_access, lang, videos, audios, subtitles, related	id→video_id, url→video_id	5

Instagram

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/instagram/comments	Bình luận	code_or_url	sort_by, pagination_token	id→code_or_url, url→code_or_url, media_id→code_or_url, code→code_or_url, shortcode→code_or_url	5
/v1/instagram/posts	Bài của kênh	user_id	count, max_id	user→user_id	5
/v1/instagram/profile	Thông tin kênh	username	—	user→username	5
/v1/instagram/search	Tìm theo từ khoá	keyword	pagination_token	keyword→keyword	5

Twitter / X

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/twitter/comments	Bình luận	tweet_id	cursor	id→tweet_id, url→tweet_id	5
/v1/twitter/profile	Thông tin kênh	—	screen_name, rest_id	—	5
/v1/twitter/search	Tìm theo từ khoá	keyword	search_type, cursor	keyword→keyword	5
/v1/twitter/trending	Xu hướng	—	country	—	5

Threads

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/threads/comments	Bình luận	post_id	end_cursor	id→post_id, url→post_id	5
/v1/threads/posts	Bài của kênh	user_id	end_cursor	user→user_id	5
/v1/threads/profile	Thông tin kênh	username	—	user→username	5

Reddit

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/reddit/comments	Bình luận	post_id	sort_type, after, need_format	id→post_id, url→post_id	5
/v1/reddit/posts	Bài của kênh	username	sort, after, need_format	user→username	5
/v1/reddit/profile	Thông tin kênh	username	need_format	user→username	5
/v1/reddit/search	Tìm theo từ khoá	query	safe_search, allow_nsfw, need_format	keyword→query	5
/v1/reddit/trending	Xu hướng	—	need_format	—	5
/v1/reddit/video	Chi tiết bài & link tải	post_id	include_comment_id, comment_id, need_format	id→post_id, url→post_id	5

Lemon8

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/lemon8/profile	Thông tin kênh	user_id	—	user→user_id	5
/v1/lemon8/search	Tìm theo từ khoá	query	max_cursor, filter_type, order_by, search_tab	keyword→query	5
/v1/lemon8/trending	Xu hướng	—	—	—	5
/v1/lemon8/video	Chi tiết bài & link tải	item_id	—	id→item_id, url→item_id	5

Nền tảng Trung Quốc

Douyin

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/douyin/posts	Bài của kênh	sec_user_id	max_cursor, count, filter_type, cookie	user→sec_user_id	5
/v1/douyin/profile	Thông tin kênh	unique_id	—	user→unique_id	5
/v1/douyin/search	Tìm theo từ khoá	keyword	—	keyword→keyword	5
/v1/douyin/video	Chi tiết bài & link tải	aweme_id	—	id→aweme_id, url→aweme_id	5

Weibo

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/weibo/profile	Thông tin kênh	uid	since_id	user→uid	5
/v1/weibo/search	Tìm theo từ khoá	query	mode, page	keyword→query	5

Bilibili

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/bilibili/posts	Bài của kênh	uid	pn, ps, keyword	user→uid	5
/v1/bilibili/profile	Thông tin kênh	uid	—	user→uid	5
/v1/bilibili/search	Tìm theo từ khoá	keyword, order, page, page_size	duration, pubtime_begin_s, pubtime_end_s	keyword→keyword	5
/v1/bilibili/video	Chi tiết bài & link tải	a_id, c_id	—	id→a_id, url→a_id	5

Kuaishou

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/kuaishou/posts	Bài của kênh	user_id	pcursor, sort	user→user_id	5
/v1/kuaishou/profile	Thông tin kênh	user_id	—	user→user_id	5
/v1/kuaishou/search	Tìm theo từ khoá	keyword	pcursor	keyword→keyword	5
/v1/kuaishou/video	Chi tiết bài & link tải	photo_id	—	id→photo_id, url→photo_id	5

Xigua

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/xigua/posts	Bài của kênh	user_id	max_behot_time	user→user_id	5
/v1/xigua/profile	Thông tin kênh	user_id	—	user→user_id	5
/v1/xigua/search	Tìm theo từ khoá	keyword	offset, order_type, min_duration, max_duration	keyword→keyword	5
/v1/xigua/video	Chi tiết bài & link tải	item_id	—	id→item_id, url→item_id	5

Pipixia

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/pipixia/posts	Bài của kênh	user_id	cursor, feed_count	user→user_id	5
/v1/pipixia/profile	Thông tin kênh	user_id	—	user→user_id	5
/v1/pipixia/search	Tìm theo từ khoá	keyword	offset, search_type	keyword→keyword	5
/v1/pipixia/video	Chi tiết bài & link tải	cell_id	cell_type	id→cell_id, url→cell_id	5

Zhihu

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/zhihu/profile	Thông tin kênh	user_url_token	—	user→user_url_token	5
/v1/zhihu/search	Tìm theo từ khoá	keyword	limit, offset, search_hash_id	keyword→keyword	5

Toutiao

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/toutiao/profile	Thông tin kênh	user_id	—	user→user_id	5
/v1/toutiao/video	Chi tiết bài & link tải	aweme_id	—	id→aweme_id, url→aweme_id	5

WeChat Channels

Endpoint	Chức năng	Bắt buộc	Tuỳ chọn (mặc định)	Tên thay thế	Credit
/v1/wechat_channels/profile	Thông tin kênh	username	—	user→username	5
/v1/wechat_channels/search	Tìm theo từ khoá	username, keyword	—	keyword→keyword, user→username	5

Kết quả trả về

Mỗi nền tảng trả cấu trúc riêng theo đúng dữ liệu gốc; cổng không đổi hình dạng. Gọi thử một lần, xem các trường có sẵn rồi mới viết code xử lý. Danh sách luôn có thể thay đổi theo nền tảng — kiểm tra GET https://revidapi.com/v1/endpoints để biết endpoint và giá hiện tại.

Lỗi thường gặp

Mã	Nghĩa	Cách xử lý
400 / 422	Thiếu tham số bắt buộc hoặc sai định dạng mã bài	Xem cột Bắt buộc
401	Sai hoặc thiếu API key	Kiểm tra header x-api-key
402	Không đủ credit	Nạp thêm ở dashboard
429	Gọi quá nhanh	Giãn nhịp, thử lại sau vài giây
502	Nền tảng từ chối: bài riêng tư, đã xoá, hoặc tạm lỗi	Thử lại sau; không bị trừ credit

Lượt lỗi không bị trừ credit. Lịch sử gọi xem ở GET /v1/jobs hoặc trang Usage trên dashboard.