Skip to Content
AnySolver logo
AnySolver
Token

HuntXHDToken

Generate the Hunt X-HD fingerprint for your proxy IP before you call a Hunt-protected site. Shows the request schema, an example and provider prices.

HuntXHDToken generates the Hunt X-HD fingerprint for your proxy IP, which you send to the site in later requests. Hunt is an anti-bot system that protects some sites with a fingerprint header and a follow-up CAPTCHA, and this task is the first step of that flow.

If the site then returns a CAPTCHA error with meta.token, continue with HuntCaptchaToken.

Send the proxy

task.proxy is required on this task type, and the X-HD value is generated for the IP of that proxy. When you change the proxy, create a new HuntXHDToken task. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve.

Create a new task when you start a Hunt-protected session, when you need an X-HD value before you call a protected endpoint, and when you change proxy.

Find apiGetLib

apiGetLib is the full URL of Hunt's api.js file.

  1. Open DevTools on the page where Hunt is loaded.
  2. In the Network tab, reload the page and search for hd-api or api.js.
  3. Copy the full request URL of the Hunt script. It has this shape:
https://example.com/hd-api/external/apps/app-id/api.js

You can also search the Elements tab for hd-api or api.js and read the src of the script tag.

Optional parameters

  • userAgent: the User-Agent to use for the fingerprint.

Do not send a data value to this task. Fingerprint generation needs only websiteURL, apiGetLib, your proxy and, optionally, the User-Agent.

Use the fingerprint

solution.token is the X-HD fingerprint. Send it to the target site, in the request header the site uses for it, together with the same proxy you used for the task.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
2Captcha
$2.99
CapMonster
$1.00
SCTG
$0.24
VoidCaptcha
$1.50

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes.

View settings reference

Task Object Properties

The task field accepts an object with the following properties:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://example.com/

apiGetLib*
URLYes

Full URL of the Hunt api.js file. Find it in DevTools by searching the network requests or the page for hd-api or api.js.

Example: https://example.com/hd-api/external/apps/app-id/api.js

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

userAgent
stringNo

Browser User-Agent string. Must match the browser used on the target page. Not all providers properly support this parameter. Verify the compatibility with the provider you are using.

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "HuntXHDToken",
        "websiteURL": "https://example.com/",
        "apiGetLib": "https://example.com/hd-api/external/apps/app-id/api.js",
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
token*
stringYes

HuntXHDToken: the X-HD fingerprint to send with requests to the target site. HuntCaptchaToken: the captcha solution to submit to the target site.

Example: 6IyDCCpDd.../z/kLNSpjewI=

raw
Record<string, unknown>No

Raw provider response data for advanced use cases.

{
    "status": "ready",
    "errorId": 0,
    "solution": {
        "token": "6IyDCCpDd.../z/kLNSpjewI="
    }
}