tiktok/
search-photos

The TikTok Photo Search API searches TikTok photo carousels by keyword with videos left out, and get every slide image plus caption, hashtags, creator and view, like, comment and share counts.

TikTok Photo Search API

Keyword search
Photo posts only
Every carousel image
0.6 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
queryRequiredThe keyword to find photo posts for.
results_limitOptionalHow 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.

  1. POST {"query": "outfit ideas", "results_limit": 20} to /v1/tiktok/search-photos.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Photo Search API — FAQ

TikTok Photo Search API is a programmatic interface for searching TikTok photo carousel posts by keyword. It returns every image of each post together with the caption, creator, hashtags and view, like, comment and share counts.

This endpoint returns photo carousels only, with videos left out of the results.

In practice, yes. TikTok calls the format photo posts or Photo Mode and creators call them slideshows or carousels; each result here is one such post, with its slides in media.

All of them. media lists every image in slide order, each with its url, width and height.

No. A result reports likes, comments, shares, plays and views, but it does not include a saves count.

Top Search returns videos and photo carousels mixed together for a keyword, while Photo Search keeps only the carousels, so every result has its images in media.

results_limit accepts 1 to 500 and defaults to 20. Each photo post returned is billed at 0.6 credits, and a search with no matching photo posts costs nothing.