Skip to main content
POST
Extract Async

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required

Target URL to scrape

auto_driver_configuration
object

Custom flow for the optimization engine: maps candidate names to the number of attempts to spend on each candidate before advancing (0 skips it). Key order defines the flow order. Providing it opts the request into 'auto' driver selection.

Example:
body
any

Request body for POST, PUT, PATCH methods

Example:
browser

Browser type to emulate

Available options:
chrome,
firefox
Example:

"chrome"

browser_actions
object[]

Array of browser automation actions to execute sequentially

Minimum array length: 1

A browser automation action. Exactly one action key must be present.

Example:
city
string

City for geolocation

Example:

"Los Angeles"

Whether to automatically handle cookie consent headers

cookies

Browser cookies as array of cookie objects

country
default:ALL

Country code for geolocation and proxy selection

Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BL,
BM,
BN,
BO,
BQ,
BR,
BS,
BT,
BV,
BW,
BY,
BZ,
CA,
CC,
CD,
CF,
CG,
CH,
CI,
CK,
CL,
CM,
CN,
CO,
CR,
CU,
CV,
CW,
CX,
CY,
CZ,
DE,
DJ,
DK,
DM,
DO,
DZ,
EC,
EE,
EG,
EH,
ER,
ES,
ET,
FI,
FJ,
FK,
FM,
FO,
FR,
GA,
GB,
GD,
GE,
GF,
GG,
GH,
GI,
GL,
GM,
GN,
GP,
GQ,
GR,
GS,
GT,
GU,
GW,
GY,
HK,
HM,
HN,
HR,
HT,
HU,
ID,
IE,
IL,
IM,
IN,
IO,
IQ,
IR,
IS,
IT,
JE,
JM,
JO,
JP,
KE,
KG,
KH,
KI,
KM,
KN,
KP,
KR,
KW,
KY,
KZ,
LA,
LB,
LC,
LI,
LK,
LR,
LS,
LT,
LU,
LV,
LY,
MA,
MC,
MD,
ME,
MF,
MG,
MH,
MK,
ML,
MM,
MN,
MO,
MP,
MQ,
MR,
MS,
MT,
MU,
MV,
MW,
MX,
MY,
MZ,
NA,
NC,
NE,
NF,
NG,
NI,
NL,
NO,
NP,
NR,
NU,
NZ,
OM,
PA,
PE,
PF,
PG,
PH,
PK,
PL,
PM,
PN,
PR,
PS,
PT,
PW,
PY,
QA,
RE,
RO,
RS,
RU,
RW,
SA,
SB,
SC,
SD,
SE,
SG,
SH,
SI,
SJ,
SK,
SL,
SM,
SN,
SO,
SR,
SS,
ST,
SV,
SX,
SY,
SZ,
TC,
TD,
TF,
TG,
TH,
TJ,
TK,
TL,
TM,
TN,
TO,
TR,
TT,
TV,
TW,
TZ,
UA,
UG,
UM,
US,
UY,
UZ,
VA,
VC,
VE,
VG,
VI,
VN,
VU,
WF,
WS,
XK,
YE,
YT,
ZA,
ZM,
ZW
Example:

"US"

device
enum<string>
default:desktop

Device type for browser emulation

Available options:
desktop,
mobile,
tablet
Example:

"desktop"

driver
enum<string>

Browser driver to use

Available options:
auto,
vx6,
vx8,
vx8-pro,
vx10,
vx10-pro,
vx12,
vx12-pro,
media-vx6,
fast-vx6
Example:

"vx8"

expected_status_codes
integer[]

Expected HTTP status codes for successful requests

Required range: -9007199254740991 <= x <= 9007199254740991
Example:
formats
enum<string>[]

List of acceptable response formats in order of preference

Minimum array length: 1
Available options:
html,
markdown,
screenshot,
headers,
links
Example:
headers
object

Custom HTTP headers to include in the request

Example:
http2
boolean
default:false

Whether to use HTTP/2 protocol

Example:

true

is_xhr
boolean
default:false

Whether to emulate XMLHttpRequest behavior

Example:

true

locale
default:en

Locale for browser language and region settings

Available options:
aa-DJ,
aa-ER,
aa-ET,
af,
af-NA,
af-ZA,
ak,
ak-GH,
am,
am-ET,
an-ES,
ar,
ar-AE,
ar-BH,
ar-DZ,
ar-EG,
ar-IN,
ar-IQ,
ar-JO,
ar-KW,
ar-LB,
ar-LY,
ar-MA,
ar-OM,
ar-QA,
ar-SA,
ar-SD,
ar-SY,
ar-TN,
ar-YE,
as,
as-IN,
asa,
asa-TZ,
ast-ES,
az,
az-AZ,
az-Cyrl,
az-Cyrl-AZ,
az-Latn,
az-Latn-AZ,
be,
be-BY,
bem,
bem-ZM,
ber-DZ,
ber-MA,
bez,
bez-TZ,
bg,
bg-BG,
bho-IN,
bm,
bm-ML,
bn,
bn-BD,
bn-IN,
bo,
bo-CN,
bo-IN,
br-FR,
brx-IN,
bs,
bs-BA,
byn-ER,
ca,
ca-AD,
ca-ES,
ca-FR,
ca-IT,
cgg,
cgg-UG,
chr,
chr-US,
crh-UA,
cs,
cs-CZ,
csb-PL,
cv-RU,
cy,
cy-GB,
da,
da-DK,
dav,
dav-KE,
de,
de-AT,
de-BE,
de-CH,
de-DE,
de-LI,
de-LU,
dv-MV,
dz-BT,
ebu,
ebu-KE,
ee,
ee-GH,
ee-TG,
el,
el-CY,
el-GR,
en,
en-AG,
en-AS,
en-AU,
en-BE,
en-BW,
en-BZ,
en-CA,
en-DK,
en-GB,
en-GU,
en-HK,
en-IE,
en-IN,
en-JM,
en-MH,
en-MP,
en-MT,
en-MU,
en-NA,
en-NG,
en-NZ,
en-PH,
en-PK,
en-SG,
en-TT,
en-UM,
en-US,
en-VI,
en-ZA,
en-ZM,
en-ZW,
eo,
es,
es-419,
es-AR,
es-BO,
es-CL,
es-CO,
es-CR,
es-CU,
es-DO,
es-EC,
es-ES,
es-GQ,
es-GT,
es-HN,
es-MX,
es-NI,
es-PA,
es-PE,
es-PR,
es-PY,
es-SV,
es-US,
es-UY,
es-VE,
et,
et-EE,
eu,
eu-ES,
fa,
fa-AF,
fa-IR,
ff,
ff-SN,
fi,
fi-FI,
fil,
fil-PH,
fo,
fo-FO,
fr,
fr-BE,
fr-BF,
fr-BI,
fr-BJ,
fr-BL,
fr-CA,
fr-CD,
fr-CF,
fr-CG,
fr-CH,
fr-CI,
fr-CM,
fr-DJ,
fr-FR,
fr-GA,
fr-GN,
fr-GP,
fr-GQ,
fr-KM,
fr-LU,
fr-MC,
fr-MF,
fr-MG,
fr-ML,
fr-MQ,
fr-NE,
fr-RE,
fr-RW,
fr-SN,
fr-TD,
fr-TG,
fur-IT,
fy-DE,
fy-NL,
ga,
ga-IE,
gd-GB,
gez-ER,
gez-ET,
gl,
gl-ES,
gsw,
gsw-CH,
gu,
gu-IN,
guz,
guz-KE,
gv,
gv-GB,
ha,
ha-Latn,
ha-Latn-GH,
ha-Latn-NE,
ha-Latn-NG,
ha-NG,
haw,
haw-US,
he,
he-IL,
hi,
hi-IN,
hne-IN,
hr,
hr-HR,
hsb-DE,
ht-HT,
hu,
hu-HU,
hy,
hy-AM,
id,
id-ID,
ig,
ig-NG,
ii,
ii-CN,
ik-CA,
is,
is-IS,
it,
it-CH,
it-IT,
iu-CA,
iw-IL,
ja,
ja-JP,
jmc,
jmc-TZ,
ka,
ka-GE,
kab,
kab-DZ,
kam,
kam-KE,
kde,
kde-TZ,
kea,
kea-CV,
khq,
khq-ML,
ki,
ki-KE,
kk,
kk-Cyrl,
kk-Cyrl-KZ,
kk-KZ,
kl,
kl-GL,
kln,
kln-KE,
km,
km-KH,
kn,
kn-IN,
ko,
ko-KR,
kok,
kok-IN,
ks-IN,
ku-TR,
kw,
kw-GB,
ky-KG,
lag,
lag-TZ,
lb-LU,
lg,
lg-UG,
li-BE,
li-NL,
lij-IT,
lo-LA,
lt,
lt-LT,
luo,
luo-KE,
luy,
luy-KE,
lv,
lv-LV,
mag-IN,
mai-IN,
mas,
mas-KE,
mas-TZ,
mer,
mer-KE,
mfe,
mfe-MU,
mg,
mg-MG,
mhr-RU,
mi-NZ,
mk,
mk-MK,
ml,
ml-IN,
mn-MN,
mr,
mr-IN,
ms,
ms-BN,
ms-MY,
mt,
mt-MT,
my,
my-MM,
nan-TW,
naq,
naq-NA,
nb,
nb-NO,
nd,
nd-ZW,
nds-DE,
nds-NL,
ne,
ne-IN,
ne-NP,
nl,
nl-AW,
nl-BE,
nl-NL,
nn,
nn-NO,
nr-ZA,
nso-ZA,
nyn,
nyn-UG,
oc-FR,
om,
om-ET,
om-KE,
or,
or-IN,
os-RU,
pa,
pa-Arab,
pa-Arab-PK,
pa-Guru,
pa-Guru-IN,
pa-IN,
pa-PK,
pap-AN,
pl,
pl-PL,
ps,
ps-AF,
pt,
pt-BR,
pt-GW,
pt-MZ,
pt-PT,
rm,
rm-CH,
ro,
ro-MD,
ro-RO,
rof,
rof-TZ,
ru,
ru-MD,
ru-RU,
ru-UA,
rw,
rw-RW,
rwk,
rwk-TZ,
sa-IN,
saq,
saq-KE,
sc-IT,
sd-IN,
se-NO,
seh,
seh-MZ,
ses,
ses-ML,
sg,
sg-CF,
shi,
shi-Latn,
shi-Latn-MA,
shi-Tfng,
shi-Tfng-MA,
shs-CA,
si,
si-LK,
sid-ET,
sk,
sk-SK,
sl,
sl-SI,
sn,
sn-ZW,
so,
so-DJ,
so-ET,
so-KE,
so-SO,
sq,
sq-AL,
sq-MK,
sr,
sr-Cyrl,
sr-Cyrl-BA,
sr-Cyrl-ME,
sr-Cyrl-RS,
sr-Latn,
sr-Latn-BA,
sr-Latn-ME,
sr-Latn-RS,
sr-ME,
sr-RS,
ss-ZA,
st-ZA,
sv,
sv-FI,
sv-SE,
sw,
sw-KE,
sw-TZ,
ta,
ta-IN,
ta-LK,
te,
te-IN,
teo,
teo-KE,
teo-UG,
tg-TJ,
th,
th-TH,
ti,
ti-ER,
ti-ET,
tig-ER,
tk-TM,
tl-PH,
tn-ZA,
to,
to-TO,
tr,
tr-CY,
tr-TR,
ts-ZA,
tt-RU,
tzm,
tzm-Latn,
tzm-Latn-MA,
ug-CN,
uk,
uk-UA,
unm-US,
ur,
ur-IN,
ur-PK,
uz,
uz-Arab,
uz-Arab-AF,
uz-Cyrl,
uz-Cyrl-UZ,
uz-Latn,
uz-Latn-UZ,
uz-UZ,
ve-ZA,
vi,
vi-VN,
vun,
vun-TZ,
wa-BE,
wae-CH,
wal-ET,
wo-SN,
xh-ZA,
xog,
xog-UG,
yi-US,
yo,
yo-NG,
yue-HK,
zh,
zh-CN,
zh-HK,
zh-Hans,
zh-Hans-CN,
zh-Hans-HK,
zh-Hans-MO,
zh-Hans-SG,
zh-Hant,
zh-Hant-HK,
zh-Hant-MO,
zh-Hant-TW,
zh-SG,
zh-TW,
zu,
zu-ZA
Example:

"en-US"

markdown_backend
enum<string>
default:full_page

Selects which markdown conversion strategy to use. "full_page" converts the entire HTML page. "main_content" uses Mozilla Readability to extract the main article content before converting.

Available options:
full_page,
main_content
Example:

"full_page"

method
enum<string>
default:GET

HTTP method for the request

Available options:
GET,
POST,
PUT,
PATCH,
DELETE
Example:

"GET"

network_capture
object[]

Filters for capturing network traffic

os
enum<string>

Operating system to emulate

Available options:
windows,
mac os,
linux,
android,
ios
Example:

"windows"

parse
boolean
default:false

Whether to parse the response content

Example:

true

parser

Custom parser configuration as a key-value map

Example:
referrer_type

Referrer policy for the request

Available options:
random,
no-referer,
same-origin
Example:

"no-referrer"

render

Whether to render JavaScript content using a browser

Example:

true

request_timeout
number

Request timeout in milliseconds

Required range: x >= 1
Example:

30000

session
object
skill

Skills or capabilities required for the request

Example:

"dynamic-content"

state
enum<string>

US state for geolocation (only valid when country is US)

Available options:
AL,
AK,
AS,
AZ,
AR,
CA,
CO,
CT,
DE,
DC,
FL,
GA,
GU,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
MP,
OH,
OK,
OR,
PA,
PR,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VA,
VI,
WA,
WV,
WI,
WY
Example:

"CA"

tag
string

User-defined tag for request identification

Example:

"campaign-2024-q1"

callback_url
string

URL to call back when async operation completes

Example:

"https://example.com/webhook/callback"

storage_compress
boolean

Whether to compress stored data

Example:

true

storage_object_name
string

Custom name for the stored object

Example:

"result-2024-01-15.json"

storage_type
string

Type of storage to use for results

Example:

"s3"

storage_url
string

URL for storage location

Example:

"s3://bucket-name/path/to/object"

Response

200 - application/json

Task created successfully

Response when an async extract task is created successfully.

status
string
required

Status indicating the async task was created successfully.

Allowed value: "success"
task
object
required

The created async task details.