Search TikTok users by keyword via Scavio API at $0.005/request. The search/users endpoint returns creator profiles matching your query, enabling programmatic influencer discovery by niche, topic, or brand name.
Prerequisites
- Scavio API key
- Python 3.8+ or Node.js 18+
- Target keyword or niche
Walkthrough
Step 1: Search for users
Call the search/users endpoint with a keyword.
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/search/users',
headers=HEADERS,
json={'keyword': 'fitness coach', 'count': 20, 'cursor': 0})
users = resp.json()['data'].get('users', [])
for u in users:
print(f"@{u['unique_id']} | {u['follower_count']:,} followers")Step 2: Filter by follower count
Filter search results to find micro-influencers in your target range.
Python
micro_influencers = [u for u in users
if 10_000 <= u['follower_count'] <= 100_000]
print(f'{len(micro_influencers)} micro-influencers found')
for u in micro_influencers:
print(f" @{u['unique_id']}: {u['follower_count']:,} followers")Python Example
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
def search_creators(keyword, min_followers=10000, max_followers=100000, pages=3):
creators = []
cursor = 0
for _ in range(pages):
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/search/users',
headers=HEADERS,
json={'keyword': keyword, 'count': 20, 'cursor': cursor}).json()['data']
for u in resp.get('users', []):
if min_followers <= u.get('follower_count', 0) <= max_followers:
creators.append({'username': u['unique_id'],
'followers': u['follower_count'], 'sec_uid': u['sec_uid']})
if not resp.get('has_more'):
break
cursor = resp['cursor']
return creators
creators = search_creators('skincare routine')
print(f'{len(creators)} micro-influencers in skincare')JavaScript Example
JavaScript
const H = {'Authorization': `Bearer ${process.env.SCAVIO_API_KEY}`, 'Content-Type': 'application/json'};
async function searchCreators(keyword, minF = 10000, maxF = 100000) {
const creators = [];
let cursor = 0;
for (let i = 0; i < 3; i++) {
const r = await fetch('https://api.scavio.dev/api/v1/tiktok/search/users', {
method: 'POST', headers: H,
body: JSON.stringify({keyword, count: 20, cursor})
}).then(r => r.json());
(r.data.users || []).forEach(u => {
if (u.follower_count >= minF && u.follower_count <= maxF)
creators.push({username: u.unique_id, followers: u.follower_count});
});
if (!r.data.has_more) break;
cursor = r.data.cursor;
}
return creators;
}
searchCreators('skincare routine').then(c => console.log(`${c.length} creators`));Expected Output
JSON
Filtered list of TikTok creators matching the keyword with follower counts within the specified range.