---
title: "Extract Async Endpoint"
method: POST
path: "/v1/extract/async"
tags: ["Extract"]
---

# Extract Async Endpoint

`POST /v1/extract/async`

## Request body

- object
  - `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.
  - `body` unknown
  - `browser` union
    - 'chrome' | 'firefox' — Browser type to emulate
    - object
      - `name` 'chrome' | 'firefox', required
      - `version` string — Specific browser version to emulate
  - `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
            - `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.
              - …
            - `delay_after_scroll` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `idle_timeout` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `loading_selector` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `max_duration` 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.
              - …
            - `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.
              - …
            - `step_size` number
      - 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
            - `count` number
            - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `offset_x` integer
            - `offset_y` integer
            - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true.
              - …
            - `scroll` boolean
            - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `skip` union — Whether to skip this action. Accepts boolean or string "true"/"false". Default: false.
              - …
            - `steps` number
            - `strategy` 'linear' | 'ghost-cursor' | 'windmouse'
            - `timeout` number — Timeout in milliseconds. Set to 0 for infinite timeout (no timeout). Default: 15000ms.
            - `visible` boolean
      - EvalAction — Execute JavaScript code in page context
        - `eval` union, required
          - string
          - object
            - `code` string, required
            - `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.
      - FetchAction — Make an HTTP request in browser context
        - `fetch` union, required
          - string, uri
          - object
            - `body` string
            - `headers` object
            - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH'
            - `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
      - 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
            - `click_on_element` boolean
            - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `mode` 'type'
            - `mouse_movement_strategy` 'linear' | 'ghost-cursor' | 'windmouse'
            - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true.
              - …
            - `scroll` boolean
            - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `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.
            - `typing_interval` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `typing_strategy` 'simple' | 'distribution'
            - `value` string, required
            - `visible` boolean
          - object
            - `click_on_element` boolean
            - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `mode` 'paste', required
            - `required` union — Whether this action is required. If true, pipeline stops on failure. Accepts boolean or string "true"/"false". Default: true.
              - …
            - `scroll` boolean
            - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `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.
            - `value` string, required
            - `visible` boolean
      - 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
            - `referer` string
            - `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
            - `wait_until` 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2'
      - PressAction — Press a keyboard key
        - `press` union, required
          - string
          - object
            - `delay` union — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `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
            - `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.
              - …
      - ScreenshotAction — Capture a page screenshot
        - `screenshot` union, required
          - boolean
          - object
            - `format` 'png' | 'jpeg' | 'webp'
            - `full_page` boolean
            - `quality` number
            - `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.
              - …
      - ScrollAction — Scroll the page or an element
        - `scroll` union, required
          - number
          - string
          - object
            - `container` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `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.
              - …
            - `to` union — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `visible` boolean
            - `x` number
            - `y` number
      - 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
            - `duration` union, required — Duration value that accepts various formats. Supports: number (ms), string ("1000"), or string with unit ("2s", "500ms", "2m", "1h")
              - …
            - `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.
              - …
      - 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.
              - …
            - `selector` union, required — CSS selector or array of alternative selectors. Use an array when you have multiple possible selectors for the same element.
              - …
            - `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.
            - `visible` boolean
      - WaitForNavigationAction — Wait for page navigation to complete
        - `wait_for_navigation` union, required
          - 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2'
          - object
            - `navigation` 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2', required
            - `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.
  - `city` string — City for geolocation
  - `consent_header` boolean — Whether to automatically handle cookie consent headers
  - `cookies` union
    - object[] — Browser cookies as array of cookie objects
      - `creation` string, nullable
      - `domain` string, nullable
      - `expires` union
        - string
        - 'Infinity'
      - `extensions` string[], nullable
      - `hostOnly` boolean, nullable
      - `httpOnly` boolean, nullable
      - `lastAccessed` string, nullable
      - `maxAge` union
        - number
        - 'Infinity'
        - '-Infinity'
      - `name` string
      - `path` string, nullable
      - `pathIsDefault` boolean, nullable
      - `sameSite` 'strict' | 'lax' | 'none'
      - `secure` boolean
      - `value` string
    - string — Browser cookies as 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'
    - 'ALL'
  - `device` 'desktop' | 'mobile' | 'tablet' — Device type for browser emulation
  - `driver` 'auto' | 'vx6' | 'vx8' | 'vx8-pro' | 'vx10' | 'vx10-pro' | 'vx12' | 'vx12-pro' | 'media-vx6' | 'fast-vx6' — Browser driver to use
  - `expected_status_codes` integer[] — Expected HTTP status codes for successful requests
  - `formats` string[] — List of acceptable response formats in order of preference
  - `headers` object — Custom HTTP headers to include in the request
  - `http2` boolean — Whether to use HTTP/2 protocol
  - `is_xhr` boolean — Whether to emulate XMLHttpRequest behavior
  - `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'
    - 'auto'
  - `markdown_backend` 'full_page' | 'main_content' — 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.
  - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' — HTTP method for the request
  - `network_capture` object[] — Filters for capturing network traffic
    - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH'
    - `resource_type` union
      - string — Resource type for network capture filtering
      - string[]
    - `status_code` union
      - number
      - number[]
    - `url` object
      - `type` 'exact' | 'contains'
      - `value` string, required
    - `validation` boolean
    - `wait_for_requests_count` number
    - `wait_for_requests_count_timeout` number
  - `os` 'windows' | 'mac os' | 'linux' | 'android' | 'ios' — Operating system to emulate
  - `parse` boolean — Whether to parse the response content
  - `parser` union — Custom parser configuration as a key-value map
    - object
    - string
  - `realtime_total_timeout` number — Overall deadline in milliseconds for a realtime request. Clamped to the account total timeout — it can shorten the deadline but never extend it. Has no effect on async requests.
  - `referrer_type` union — Referrer policy for the request
    - 'random' | 'no-referer' | 'same-origin'
    - 'google' | 'bing' | 'facebook' | 'twitter' | 'instagram'
  - `render` union — Whether to render JavaScript content using a browser
    - boolean
    - 'auto'
  - `request_timeout` number — Request timeout in milliseconds
  - `session` object
    - `id` string
    - `prefetch_userbrowser` boolean
    - `renew_on_blocked` boolean
    - `retry` boolean
    - `timeout` number
  - `skill` union
    - string — Skills or capabilities required for the request
    - string[] — Skills or capabilities required for the request
  - `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)
  - `tag` string — User-defined tag for request identification
  - `url` string, required — Target URL to scrape
  - `callback_url` string — URL to call back when async operation completes
  - `storage_compress` boolean — Whether to compress stored data
  - `storage_object_name` string — Custom name for the stored object
  - `storage_type` string — Type of storage to use for results
  - `storage_url` string — URL for storage location

## Response `200`

Task created successfully

- ExtractAsyncResponse — Response when an async extract task is created successfully.
  - `status` 'success', required — Status indicating the async task was created successfully.
  - `task` object, required — The created async task details.
    - `_query` unknown, required
    - `account_name` string — Account name that owns the task.
    - `api_type` 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs'
    - `batch_id` string, nullable — Batch ID if this task is part of a batch.
    - `created_at` string, required — Timestamp when the task was created.
    - `download_url` string, uri, nullable — URL for downloading the task results.
    - `error` string, nullable — Error message if the task failed.
    - `error_type` string, nullable — Classification of the error type.
    - `id` string, required — Unique task identifier.
    - `input` unknown, required
    - `modified_at` string — Timestamp when the task was last modified.
    - `output_url` string, nullable — Storage location of the output data.
    - `queue` string — Queue name the task was submitted to.
    - `state` 'pending' | 'queued' | 'in_progress' | 'success' | 'error', required — Current state of the task.
    - `status_code` number — HTTP status code from the task execution.
    - `status_url` string, uri, required — URL for checking the task status.

---

[API](https://skmtc.net/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.net/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/9bfe220b7a29/schema)
