--- title: "Extract Async Endpoint" method: POST path: "/v1/extract/async" tags: ["Extract"] --- # Extract Async Endpoint `POST /v1/extract/async` ## Request body - object - `cookies` union - object[] — Browser cookies as array of cookie objects - `name` string - `value` string - `expires` union - string - string - `maxAge` union - number - string - string - `domain` string - `path` string - `secure` boolean - `httpOnly` boolean - `extensions` string[] - `creation` string - `hostOnly` boolean - `pathIsDefault` boolean - `lastAccessed` string - `sameSite` 'strict' | 'lax' | 'none' - string — Browser cookies as string - `parse` boolean — Whether to parse the response content - `parser` union — Custom parser configuration as a key-value map - object - string - `url` string, required — Target URL to scrape - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' — HTTP method for the request - `referrer_type` union — Referrer policy for the request - 'random' | 'no-referer' | 'same-origin' - 'google' | 'bing' | 'facebook' | 'twitter' | 'instagram' - `expected_status_codes` integer[] — Expected HTTP status codes for successful requests - `headers` object — Custom HTTP headers to include in the request - `request_timeout` number — Request timeout in milliseconds - `skill` union - string — Skills or capabilities required for the request - string[] — Skills or capabilities required for the request - `http2` boolean — Whether to use HTTP/2 protocol - `is_xhr` boolean — Whether to emulate XMLHttpRequest behavior - `driver` 'vx6' | 'vx8' | 'vx8-pro' | 'vx10' | 'vx10-pro' | 'vx12' | 'vx12-pro' — Browser driver to use - `consent_header` boolean — Whether to automatically handle cookie consent headers - `formats` string[] — List of acceptable response formats in order of preference - `render` boolean — Whether to render JavaScript content using a browser - `network_capture` object[] — Filters for capturing network traffic - `status_code` union - number - number[] - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH' - `url` object - `type` 'exact' | 'contains' - `value` string, required - `resource_type` union - string — Resource type for network capture filtering - string[] - `validation` boolean - `wait_for_requests_count` number - `browser_actions` BrowserAction[] — Array of browser automation actions to execute sequentially - union — A browser automation action. Exactly one action key must be present. - AutoScrollAction — Continuously scroll to load dynamic content - `auto_scroll` union, required - boolean - union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - number - string - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `max_duration` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `delay_after_scroll` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `step_size` number - `click_selector` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `container` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `idle_timeout` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `pause_on_selector` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `loading_selector` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - ClickAction — Click on an element by selector - `click` union, required - union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - string - string[] - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `offset_x` integer - `offset_y` integer - `strategy` 'linear' | 'ghost-cursor' | 'windmouse' - `visible` boolean - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `scroll` boolean - `count` number - `steps` number - EvalAction — Execute JavaScript code in page context - `eval` union, required - string - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `code` string, required - FetchAction — Make an HTTP request in browser context - `fetch` union, required - string, uri - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `url` string, uri, required - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH' - `headers` object - `body` string - FillAction — Fill text into an input field - `fill` union, required — Fill options with mode-specific fields. Use "type" mode for behavioral typing simulation, or "paste" mode for instant paste. - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `value` string, required - `click_on_element` boolean - `scroll` boolean - `visible` boolean - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `mode` string - `mouse_movement_strategy` 'linear' | 'ghost-cursor' | 'windmouse' - `typing_strategy` 'simple' | 'distribution' - `typing_interval` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `value` string, required - `click_on_element` boolean - `scroll` boolean - `visible` boolean - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - `mode` string, required - GetCookiesAction — Retrieve browser cookies - `get_cookies` union, required - boolean - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - GotoAction — Navigate to a URL - `goto` union, required - string, uri - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `url` string, uri, required - `referer` string - `wait_until` 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2' - PressAction — Press a keyboard key - `press` union, required - string - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `key` '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'Power' | 'Eject' | 'Abort' | 'Help' | 'Backspace' | 'Tab' | 'Numpad5' | 'NumpadEnter' | 'Enter' | ' ' | ' ' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'Pause' | 'CapsLock' | 'Escape' | 'Convert' | 'NonConvert' | 'Space' | 'Numpad9' | 'PageUp' | 'Numpad3' | 'PageDown' | 'End' | 'Numpad1' | 'Home' | 'Numpad7' | 'ArrowLeft' | 'Numpad4' | 'Numpad8' | 'ArrowUp' | 'ArrowRight' | 'Numpad6' | 'Numpad2' | 'ArrowDown' | 'Select' | 'Open' | 'PrintScreen' | 'Insert' | 'Numpad0' | 'Delete' | 'NumpadDecimal' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'ContextMenu' | 'NumpadMultiply' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadDivide' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'NumLock' | 'ScrollLock' | 'AudioVolumeMute' | 'AudioVolumeDown' | 'AudioVolumeUp' | 'MediaTrackNext' | 'MediaTrackPrevious' | 'MediaStop' | 'MediaPlayPause' | 'Semicolon' | 'Equal' | 'NumpadEqual' | 'Comma' | 'Minus' | 'Period' | 'Slash' | 'Backquote' | 'BracketLeft' | 'Backslash' | 'BracketRight' | 'Quote' | 'AltGraph' | 'Props' | 'Cancel' | 'Clear' | 'Shift' | 'Control' | 'Alt' | 'Accept' | 'ModeChange' | ' ' | 'Print' | 'Execute' | '' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'Meta' | '*' | '+' | '-' | '/' | ';' | '=' | ',' | '.' | '`' | '[' | '\' | ']' | ''' | 'Attn' | 'CrSel' | 'ExSel' | 'EraseEof' | 'Play' | 'ZoomOut' | ')' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '(' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | ':' | '<' | '_' | '>' | '?' | '~' | '{' | '|' | '}' | '"' | 'SoftLeft' | 'SoftRight' | 'Camera' | 'Call' | 'EndCall' | 'VolumeDown' | 'VolumeUp', required - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - ScreenshotAction — Capture a page screenshot - `screenshot` union, required - boolean - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `full_page` boolean - `format` 'png' | 'jpeg' | 'webp' - `quality` number - ScrollAction — Scroll the page or an element - `scroll` union, required - number - string - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `x` number - `y` number - `to` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `container` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `visible` boolean - WaitAction — Wait for a specified duration - `wait` union, required - union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - number - string - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `duration` union, required — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h") - … - WaitForElementAction — Wait for an element to appear or reach a specific state - `wait_for_element` union, required - union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - string - string[] - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element. - … - `visible` boolean - WaitForNavigationAction — Wait for page navigation to complete - `wait_for_navigation` union, required - 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2' - object - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true. - … - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false. - … - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms. - `navigation` 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2', required - `session` object - `id` string - `retry` boolean - `prefetch_userbrowser` boolean - `tag` string — User-defined tag for request identification - `locale` union — Locale for browser language and region settings - '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' - string - `country` union — Country code for geolocation and proxy selection - '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' - string - `device` 'desktop' | 'mobile' | 'tablet' — Device type for browser emulation - `browser` union - 'chrome' | 'firefox' — Browser type to emulate - object - `name` 'chrome' | 'firefox', required - `version` string — Specific browser version to emulate - `os` 'windows' | 'mac os' | 'linux' | 'android' | 'ios' — Operating system to emulate - `state` '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' — US state for geolocation (only valid when country is US) - `city` string — City for geolocation - `callback_url` string — URL to call back when async operation completes - `storage_type` string — Type of storage to use for results - `storage_url` string — URL for storage location - `storage_compress` boolean — Whether to compress stored data - `storage_object_name` string — Custom name for the stored object ## Response `200` Task created successfully - ExtractAsyncResponse — Response when an async extract task is created successfully. - `status` string, required — Status indicating the async task was created successfully. - `task` object, required — The created async task details. - `id` string, required — Unique task identifier. - `state` 'pending' | 'success' | 'error', required — Current state of the task. - `output_url` string — Storage location of the output data. - `status_url` string, uri, required — URL for checking the task status. - `download_url` string, uri — URL for downloading the task results. - `error` string — Error message if the task failed. - `error_type` string — Classification of the error type. - `created_at` string, required — Timestamp when the task was created. - `modified_at` string — Timestamp when the task was last modified. - `account_name` string — Account name that owns the task. - `input` unknown, required - `_query` unknown, required - `batch_id` string — Batch ID if this task is part of a batch. - `status_code` number — HTTP status code from the task execution. - `api_type` 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' ## Changes - **2026-03-25** `403f2145d293` — 1 breaking, 2 info - the `allOf[#/components/schemas/ExtractPayload]/formats` request property's minItems was increased to `1` - the `formats` request property default value `html` was removed - added the new `headers` enum value to the request property `allOf[#/components/schemas/ExtractPayload]/formats/items/` - **2026-02-26** `90aef9d85902` — 1 warning - added the new `media` enum value to the `task/api_type` response property for the response status `200` - **2026-02-23** `9aed7e5e19ad` — 2 warning - added the new `agent` enum value to the `task/api_type` response property for the response status `200` - added the new `extract` enum value to the `task/api_type` response property for the response status `200` [Change history](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/extract/async/post.md) --- [API](https://skmtc.dev/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.dev/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/403f2145d293/schema)