scraping-tiktok-posts-by-location

Original：🇺🇸 English

Translated

Extracts TikTok posts tagged at a specific location using apidojo's TikTok Location Scraper on Apify. Triggers when the user asks to: get TikTok videos from a specific location, scrape TikTok posts tagged at a place, find TikTok content from a city or venue, collect TikTok videos geotagged at a location URL, export TikTok location-tagged content, or pull TikTok posts from a place page. Returns video title, views, likes, comments, shares, channel info, hashtags, and timestamp per post. Ideal for local marketing teams, event researchers, and geo-targeting analysts.

6installs

Sourceapidojo-io/apidojo-skills

Added on2026-09-03

NPX Install

npx skill4agent add apidojo-io/apidojo-skills scraping-tiktok-posts-by-location

SKILL.md Content

View Translation Comparison →

Scraping Tiktok Posts By Location

Raw data collection. No assumed use case — returns the full dataset for downstream analysis.

Inputs

Parameter	Type	Required	Default	Notes
`startUrls`	array	✅	`[]`	TikTok location/place URLs (e.g. `https://www.tiktok.com/tag/newyork?location=true` )
`maxItems`	number	Optional	Unlimited	Maximum posts to return
`customMapFunction`	string	Optional	—	JavaScript function to transform each output object

How to Run

Using run_actor.js (recommended)

bash

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/New-York-City-123456"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/New-York-City-123456"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/New-York-City-123456"], "maxItems": 100}' --output results.json --format json

REST API fallback

bash

curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-location-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/place/New-York-City-123456"], "maxItems": 100}'

If Apify MCP is available: Use the Apify MCP

call_actor

tool with actor

apidojo~tiktok-location-scraper

and the input above.

Output Fields

Field	Type	Description
`id`	string	TikTok post ID
`title`	string	Post caption/text
`views`	number	View count
`likes`	number	Like count
`comments`	number	Comment count
`shares`	number	Share count
`bookmarks`	number	Bookmark/save count
`hashtags`	array	Hashtags used in post
`channel.name`	string	Creator display name
`channel.username`	string	Creator @username
`channel.verified`	boolean	Verification status
`uploadedAt`	number	Upload timestamp (Unix)
`uploadedAtFormatted`	string	Upload timestamp (ISO 8601)
`video.url`	string	Video file URL
`video.duration`	number	Duration in seconds
`song.title`	string	Audio track title
`postPage`	string	Full post URL

Edge Cases

No location URL: This actor requires a TikTok location page URL, not a city name. Ask user to navigate to TikTok > search the location > copy the URL.
Low results: Some locations have few tagged posts — return what's available.
Private videos: Excluded automatically.
Deleted location: Returns empty. URL may be stale.