scraping-tiktok-posts-by-location

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)

# 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

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.