Unofficial TikTok Photo Search API
GET/api/v1/search_photos· paginated
Search photo/slideshow posts (one page per call, cursor-paginated).
| Parameter | Description | |
|---|---|---|
query | required | What to search for. |
cursor | optional | Page cursor. Omit (or 0) for the first page; pass the next_cursor from the previous response. |
format | optional | Omit for raw photo objects (default). clean for a trimmed subset (id, desc, images, author, stats). |
Returns
query, next_cursor, has_more, count, and a results array of aweme (photo) objects — raw by default, trimmed with format=clean.
Example Request
https://dev.omar-thing.site/api/v1/search_photos?query=japan&cursor=0&format=clean&key=YOUR_API_KEY
Example Response
{
"data": {
"count": 15,
"has_more": true,
"next_cursor": "15|17...",
"query": "japan",
"results": [
{
"...": "more (format=clean shown; raw aweme by default)",
"author": {
"nickname": "Someone",
"username": "someone"
},
"aweme_id": "74...",
"desc": "Tokyo trip 🇯🇵",
"image_count": 6,
"images": [
"https://..."
],
"stats": {
"comments": 44,
"likes": 1203
}
}
]
},
"status": "success"
}Sends a live request using your API key above.
More Search endpoints
- Unofficial TikTok User Search API — Search users/accounts (one page per call, cursor-paginated). Filter by
followers,verifiedaccounts, ormatchusernames only. - Unofficial TikTok Video Search API — Search videos (one page per call, cursor-paginated). Filter by
dateand sort bylikesornewest. - Unofficial TikTok Hashtag Search API — Search hashtags (one page per call, cursor-paginated).
- Unofficial TikTok Place Search API — Search places/POIs (venues, landmarks, restaurants). Results are localized to the
countryyou pass (ISO-2). One page per call, cursor-paginated. - Unofficial TikTok Music Search API — Search sounds/music (one page per call, cursor-paginated).
- Unofficial TikTok Search Suggestions API — Search autocomplete — the suggestions shown while you type.
- Unofficial TikTok Related Searches API — Related search terms suggested under a video ("others searched for"). Add
queryto steer them toward a topic.