Skip to main content

Getting Started

Base URLs​

All API calls are plain HTTP GET (or POST for batch endpoints). No authentication headers required.

# From n8n or any service inside the Docker network (preferred)
http://video-scraper-api:80

# From anywhere on the internet
https://scraper.shin0x.space

Your First API Call​

The fastest way to get video data is the hybrid endpoint. Pass any TikTok or Douyin URL — it auto-detects the platform.

curl "http://video-scraper-api:80/api/hybrid/video_data?url=https://www.tiktok.com/@owlcitymusic/video/7218694761253735723"

Response:

{
  "code": 200,
  "router": "/api/hybrid/video_data",
  "data": {
    "type": "video",
    "platform": "tiktok",
    "video_id": "7218694761253735723",
    "desc": "Vegas - see you this fall! #cocomoon #owlcity",
    "create_time": 1680733358,
    "author": {
      "nickname": "Owl City",
      "unique_id": "owlcitymusic"
    },
    "statistics": {
      "play_count": 11459,
      "digg_count": 505,
      "comment_count": 15
    },
    "video_data": {
      "nwm_video_url": "https://...",
      "nwm_video_url_HQ": "https://..."
    }
  }
}

Check code == 200 for success. All data lives under the data key.

Browse All Endpoints​

The full interactive API reference (Swagger UI) is available at:

👉 https://scraper.shin0x.space/docs

Or browse the auto-generated reference in the sidebar under API Reference.

Minimal Mode​

Add &minimal=true to the hybrid endpoint to get a trimmed response (fewer fields, smaller payload). Useful when you only need the download URLs and basic metadata:

curl "http://video-scraper-api:80/api/hybrid/video_data?url=<URL>&minimal=true"

No Auth Required​

This API has no authentication layer. No API keys, no tokens, no Authorization headers. Every n8n HTTP Request node can hit it directly.