xHamster Video Downloader

Save supported xHamster videos from a URL for offline viewing, archiving favorites, QA, or organizing a personal media library. Paste a video link, optionally add your logged-in cookie for pages that require authentication, and the Actor returns a browser-ready download link and useful metadata without making you dig through page code or browser network requests.

What You Get

• A simple URL-based workflow for supported xHamster videos
• Support for modern /videos/{slug}-{id} URLs and legacy /movies/{id}/{slug}.html URLs
• Support for xHamster domains and mirrors, including localized/mobile subdomains
• A browser-ready download link you can open or pass into your own workflow
• Metadata for each video, including title, description, creator, duration, thumbnail, tags, views, likes, dislikes, and comments

Common Use Cases

• Build a personal offline xHamster media library from supported video URLs
• Prepare downloaded videos for organizers like Stash App or a Plex Media Library
• Keep favorite videos together with useful metadata
• Archive videos your account can access so your collection is easier to browse later
• Collect video metadata for cataloging, QA, or research workflows

Input

Download a public video

Use this when the video page does not require a logged-in session.

{
  "url": "https://xhamster.com/videos/decorate-my-tree-with-me-sfw-xhYm0sm",
  "debug": false
}

Download a video that requires authentication

Paste the Cookie header value from a logged-in xHamster browser session.

{
  "url": "https://xhamster.com/videos/decorate-my-tree-with-me-sfw-xhYm0sm",
  "cookie": "session=value; another=value",
  "debug": false
}

Field	Required	Description
url	Yes	Full xHamster video page URL.
cookie	No	Full Cookie header value from your browser session, used only when the page requires authentication.
debug	No	Adds selected diagnostics and raw page model data. Usually only needed while troubleshooting.

Output

The Actor saves one item to the default dataset. Successful results include normalized metadata plus:

{
  "thumbnailUrl": "https://...",
  "downloadUrl": "https://...",
  "downloadType": "free",
  "title": "Decorate my tree with me SFW",
  "description": "A clean, HTML-free description of the video.",
  "creatorName": "destinationkat",
  "price": 0,
  "currency": "USD",
  "tags": ["Christmas", "Vlog"],
  "likes": 43,
  "dislikes": 6,
  "scrapeStatus": "ok",
  "scrapedAt": "2026-07-08T13:39:42.160Z",
  "videoId": "27933507"
}

Important download fields:

• downloadUrl: browser-ready download page link. The page resolves a fresh media source at click time.
• downloadType: currently always free.
• price / currency: currently always 0 / USD.

If the video cannot be resolved, the dataset item still contains a machine-readable status:

• invalid_input: Required input is missing or malformed.
• not_found: The video could not be found or was closed.
• api_error: The page could not be fetched or parsed.

Cookie Tips

• Copy only the Cookie header value, for example session=value; another=value.
• Use a fresh cookie from an active browser session. Cookies can expire quickly.
• Keep debug disabled when using real cookies unless you are actively troubleshooting.

How to get your Cookie?

1. Install the Cookie-Editor browser extension from https://cookie-editor.com/.
2. Open xHamster in the same browser and make sure you are logged in.
3. Click the Cookie-Editor cookie icon in the browser toolbar.
4. Click Export in the bottom right.
5. Choose Header String.
6. Paste the exported value into the Actor's cookie input field.

Limits and Notes

• The Actor returns one video download result per run.
• Site changes, unavailable videos, expired cookies, or changed page scripts can affect results.
• Users are responsible for making sure their use of downloads complies with applicable laws and website terms.