TikTok Public Music Page Scraper

Extract public TikTok music/sound-page metadata from public music URLs or numeric sound IDs. The Actor retrieves a public reader representation first and then tries the direct page, parses title, description, creator, duration, cover images, links, visible video URLs, and bounded page text, and writes one record per target.

This Actor does not crawl every video using a sound and does not use cookies, private profiles, or authenticated endpoints.

Example input

{
  "musicUrls": [
    "https://www.tiktok.com/music/original-sound-7595604258835401494"
  ],
  "maxItems": 2
}

Numeric IDs can be supplied instead:

{
  "musicIds": ["7595604258835401494"]
}

If no URL or ID is supplied, the Actor uses two representative public music-page URLs. maxItems limits the number of unique pages requested.

Example output

{
  "recordType": "tiktok-music",
  "status": "success",
  "dataAvailable": true,
  "source": "tiktok.com",
  "provenance": "public_tiktok_music_page",
  "sourceTransport": "jina-reader",
  "extractionMethod": "public_music_page_text_and_links",
  "musicUrl": "https://www.tiktok.com/music/original-sound-7595604258835401494",
  "musicId": "7595604258835401494",
  "musicTitle": "Original sound",
  "artist": "creator",
  "durationSeconds": 12,
  "coverImageUrl": "https://cdn.example/cover.jpg",
  "postUrls": ["https://www.tiktok.com/@creator/video/1234567890"],
  "postCount": 1,
  "postsAvailable": true,
  "scrapedAt": "2026-08-18T00:00:00.000Z"
}

When neither public retrieval path returns usable content, the dataset receives a tiktok-music-access-diagnostic or tiktok-music-request-diagnostic record, and the OUTPUT summary reports failure.

Input

• musicUrls (array, optional): Public HTTPS TikTok music-page URLs containing /music/.
• musicIds (array, optional): Numeric sound IDs, 10–30 digits; converted to public /music/<id> URLs.
• maxItems (integer, 1–10): Maximum unique public music pages to request. Default: 10.

The historical controls for maximum sound posts and separate music/post row modes were removed because this implementation only parses each public music page and does not crawl its post list.

Output and storage

Music-page records and access diagnostics are written to the default dataset. The Output tab links to the dataset and to OUTPUT in the default key-value store.

OUTPUT contains requested and processed target counts, usable record count, failed URL list, status, and timestamp. postUrls in a music record are links visible in the page representation; they are not individually fetched.

Limitations and cost

The Actor makes at most one public reader request and one direct page request per target. TikTok page markup, signed image URLs, and visible post links can change. Missing source values are omitted, and the returned post count is only the count of visible links found in the bounded representation.

Apify compute and public HTTP traffic are the main costs. Start with one target and a small maxItems value, and avoid high-frequency retries.

FAQ and disclaimer

Does it return every video using the sound?

No. It reports only public video URLs visible in the retrieved music-page representation and does not crawl those videos.

Why did the Actor use jina-reader?

The public reader representation is tried first because TikTok may return a challenge or script-heavy page to direct HTTP clients. The transport is recorded for auditability.

Does it access private music or user data?

No. It requests public pages only and does not bypass authentication or access controls.

Use public data for a legitimate purpose, follow TikTok and r.jina.ai terms and robots guidance, and review privacy and data-protection obligations. For support, use the Actor Issues tab.