TikTok Photo Search
A TikTok photo post is a swipeable set of still images published with a caption, hashtags and a sound, and it collects the same view, like, comment and share counters as a video. Searching only these posts shows which visual formats work for a topic, from outfit grids and recipe steps to listicles and product roundups.
TikTok Photo Search API Features
- Photo posts onlyEvery result is a photo carousel and videos are left out, so a keyword search is not diluted by video results.
- Every slide with its sizeIn every TikTok Photo Search API result, media lists each image of the post in slide order, with its type, url, width and height.
- Engagement and post contextmetrics reports likes, comments, shares, plays and views, and each post comes with its caption in text, hashtags, mentions, the audio and the creator's profile fields.
TikTok Photo Search API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | The keyword to find photo posts for. |
results_limit | Optional | How many photo posts to return, from 1 to 500. Defaults to 20. |
How to Use the TikTok Photo Search API
Search a keyword with the TikTok Photo Search API and page through matching photo posts.
- POST {"query": "outfit ideas", "results_limit": 20} to /v1/tiktok/search-photos.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read photo posts from results.items and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"outfit ideas","results_limit":20}'
# media holds every image of each carousel, in slide order.TikTok Photo Search API Use Cases
- Slideshow format benchmarking: Compare the number of images in media with likes, comments, shares and views across a keyword's carousels to see which lengths get the response.
- Caption and hashtag research: Read text and hashtags from the strongest photo posts for a keyword to see how creators word and tag the content that performs.
- Visual trend boards: Use the TikTok Photo Search API to collect the slide images of top posts for a keyword such as outfit ideas to build reference boards for fashion, food or travel content.
TikTok Photo Search API Pro Tips
- Rank posts by likes, comments and shares added together and divided by views_count rather than by raw likes, so a strong post from a small account is not buried by a large one; skip posts whose views_count is empty or zero.
- Run each phrasing of a topic as its own query, such as outfit ideas and ootd, and deduplicate by id when you merge the results, since one slideshow can match several.
- Download the slide images soon after a TikTok Photo Search API task finishes if you need the files, because TikTok serves them through signed links that expire.
- Group posts by audio.id rather than audio.title, since many photo posts carry the creator's own sound whose title is only a generic original-sound label.
Related APIs
Beyond the TikTok Photo Search API, use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Comment Keywords API — Find the keywords that come up most in a video's comments, with the comments behind them.
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API