Config
Reference data for building requests
/config/js-instructions List the supported js_instructions actions
GET /config/js-instructionsThe canonical list of browser actions accepted in attributes.js_instructions, with their
argument shape and an example. Actions with iframe: true also accept the iframe_ prefix
(e.g. iframe_click). Static and cacheable for an hour.
curl https://scraping-api.datafuel.ai/api/v1/config/js-instructionsSupported actions
{ "instructions": [ { "action": "fill", "description": "Type text into an input.", "value": "array", "args": [ { "name": "selector", "type": "string", "required": true }, { "name": "text", "type": "string", "required": true } ], "iframe": true, "example": { "fill": [ "input[name=q]", "laptops" ] } } ] }
/config/ai-providers List the AI providers and models for result post-processing
GET /config/ai-providersThe providers accepted in attributes.ai_provider and, for each, the models accepted in
attributes.ai_model when result_use_ai is on. Any other value is rejected with
400 INVALID_ATTRIBUTES. Omit ai_model to use the provider's default. Cacheable for an hour.
curl https://scraping-api.datafuel.ai/api/v1/config/ai-providersSupported providers and models
{ "providers": [ { "name": "anthropic", "models": [ "claude-opus-5-5", "claude-sonnet-5-5" ] } ] }
/config/proxy/locations Countries, regions and cities available on a proxy plan
GET /config/proxy/locationsproxy_typestringcurl https://scraping-api.datafuel.ai/api/v1/config/proxy/locations \ --header 'X-API-Key: df_key_your_key_here'
Location tree, usable as proxy_country / proxy_state / proxy_city
[ { "code": "us", "name": "United States", "regions": [ { "code": "ny", "name": "New York", "cities": [ { "code": "newyork", "name": "New York" } ] } ] } ]
Malformed request or invalid attributes
{ "code": "INVALID_ATTRIBUTES", "message": "Invalid attributes for selected task type" }
Missing or invalid API key
{ "code": "UNAUTHORIZED", "message": "You are not authorized to perform this action" }
/config/proxy/asn ASNs available in one country on a proxy plan
GET /config/proxy/asnproxy_typestringcountry REQUIREDstring400 INVALID_COUNTRY.curl https://scraping-api.datafuel.ai/api/v1/config/proxy/asn \ --header 'X-API-Key: df_key_your_key_here'
ASNs, usable as proxy_asn
[ { "code": "7922", "name": "Comcast Cable" } ]
Malformed request or invalid attributes
{ "code": "INVALID_ATTRIBUTES", "message": "Invalid attributes for selected task type" }
Missing or invalid API key
{ "code": "UNAUTHORIZED", "message": "You are not authorized to perform this action" }
/filter/check Detect the anti-bot protection of URLs
POST /filter/checkProbes each URL and reports the protection in front of it. Invalid or non-http(s) URLs are skipped;
when none is left the call answers 400 URL_LENGTH_CANNOT_BE_ZERO. Not billed.
curl https://scraping-api.datafuel.ai/api/v1/filter/check \ --request POST \ --header 'Content-Type: application/json' \ --header 'X-API-Key: df_key_your_key_here' \ --data '[ "https://example.com/product/1" ]'
One entry per distinct host and path
[ { "host": "example.com", "path": "/product/1", "protection_type": "cloudflare" } ]
Malformed request or invalid attributes
{ "code": "INVALID_ATTRIBUTES", "message": "Invalid attributes for selected task type" }
Missing or invalid API key
{ "code": "UNAUTHORIZED", "message": "You are not authorized to perform this action" }