> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapio.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create an async job > Submit any surface operation (fetch, crawl, interact, search, map) as an async job. ## OpenAPI ````yaml post /v1/jobs openapi: 3.1.0 info: title: Scrapio version: 1.0.0 description: >- Turn any URL into structured data. Fetch raw HTML, crawl sites, extract structured content, interact with dynamic pages, and search the web through one API. contact: name: Scrapio Support url: https://scrapio.dev license: name: Proprietary servers: - url: https://api.scrapio.dev description: Production security: - bearerAuth: [] tags: - name: System - name: Fetch - name: Crawl - name: Map - name: Interact - name: Search - name: Google - name: Fast Search - name: Jobs - name: YouTube - name: Amazon - name: Walmart - name: Booking - name: Agoda - name: Airbnb - name: ChatGPT - name: Perplexity - name: Gemini - name: Bing - name: Reddit - name: TikTok - name: Apple App Store - name: Target - name: Monitors paths: /v1/jobs: post: tags: - Jobs summary: Create an async job description: >- Submit any surface operation (fetch, crawl, interact, search, map) as an async job. Returns a `job_id` immediately; poll `GET /v1/jobs/{id}` for status and retrieve the output from `GET /v1/jobs/{id}/result` once complete. Send an `Idempotency-Key` header to safely retry submission. Results are retained for 24 hours. operationId: createJob requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateJobRequest' examples: fetch: summary: Async fetch job value: kind: fetch input: url: https://example.com render_js: true output: - markdown crawl: summary: Async crawl job value: kind: crawl input: seeds: - https://docs.example.com/ max_pages: 20 output: - markdown responses: '202': description: Job accepted and queued for execution. content: application/json: schema: $ref: '#/components/schemas/AsyncJobAcceptedResponse' '400': description: Invalid job request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Idempotency key reused with a different request body. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL label: cURL source: |- curl -X POST https://api.scrapio.dev/v1/jobs \ -H "Authorization: Bearer $SCRAPIO_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: my-job-001" \ -d '{"kind":"fetch","input":{"url":"https://example.com","output":["markdown"]}}' - lang: Python label: Python source: |- import os, requests resp = requests.post( "https://api.scrapio.dev/v1/jobs", headers={"Authorization": f"Bearer {os.environ['SCRAPIO_API_KEY']}", "Idempotency-Key": "my-job-001"}, json={"kind": "fetch", "input": {"url": "https://example.com", "output": ["markdown"]}}, ) print(resp.json()["job_id"]) - lang: JavaScript label: Node.js source: |- const resp = await fetch("https://api.scrapio.dev/v1/jobs", { method: "POST", headers: { Authorization: `Bearer ${process.env.SCRAPIO_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "my-job-001" }, body: JSON.stringify({ kind: "fetch", input: { url: "https://example.com", output: ["markdown"] } }), }); const { job_id } = await resp.json(); components: schemas: CreateJobRequest: anyOf: - type: object properties: kind: type: string description: Wraps a /fetch request enum: - fetch input: type: object properties: url: type: string format: uri description: Target page URL to fetch render_js: description: Whether to render JavaScript before capturing output type: boolean device: type: string enum: - desktop - mobile - tablet description: Device profile to emulate session: type: object properties: id: type: string minLength: 1 description: Session id to reuse required: - id additionalProperties: false description: Reuse an existing browser session by id output: description: Which output formats to return (default ["html"]) minItems: 1 type: array items: type: string enum: - html - markdown - json - screenshot description: Which output formats to return extract: description: Structured extraction config, requires `json` output anyOf: - type: object properties: mode: type: string description: Extract whole page, no config enum: - page required: - mode additionalProperties: false - type: object properties: mode: type: string description: Extract fields via CSS selectors enum: - selectors fields: type: object propertyNames: type: string additionalProperties: type: object properties: selector: type: string minLength: 1 description: CSS selector to match type: type: string enum: - text - html - attr description: What to extract from the matched element attribute: description: Attribute name, required when type is 'attr' type: string minLength: 1 required: - selector - type additionalProperties: false description: Named fields to extract required: - mode - fields additionalProperties: false - type: object properties: mode: type: string description: Extract using a field-name/description schema enum: - schema schema: type: object propertyNames: type: string additionalProperties: type: string description: Field name to description map engine: type: string enum: - llm - heuristic description: Extraction engine to use required: - mode - schema additionalProperties: false - type: object properties: mode: type: string description: Extract via free-text instruction enum: - instruction instruction: type: string minLength: 1 description: Free-text extraction instruction engine: type: string enum: - llm - heuristic description: Extraction engine to use required: - mode - instruction additionalProperties: false wait_for: type: object properties: network_idle: description: Wait for network idle before capturing type: boolean additionalProperties: false description: Condition to wait on before capturing timeout_ms: description: Max time to wait for the fetch, in ms type: integer exclusiveMinimum: 0 maximum: 300000 use_proxy: description: >- Skip the cheap direct/stealth tiers and go straight to the strongest (proxy) access tier. Requires a paid plan. Useful when you already know the target needs it, to avoid wasted attempts and reduce the chance of timing out mid-escalation. type: boolean required: - url additionalProperties: false webhook: type: object properties: url: type: string format: uri description: Callback URL to notify when the job completes required: - url additionalProperties: false description: Optional webhook callback for job completion required: - kind - input additionalProperties: false - type: object properties: kind: type: string description: Wraps an /interact request enum: - interact input: type: object properties: url: type: string format: uri description: Target page URL to open device: type: string enum: - desktop - mobile - tablet description: Device profile to emulate session: type: object properties: id: type: string minLength: 1 description: Session id to reuse required: - id additionalProperties: false description: Reuse an existing browser session by id actions: minItems: 1 type: array items: anyOf: - type: object properties: type: type: string description: Navigate to a URL enum: - goto url: type: string format: uri required: - type additionalProperties: false - type: object properties: type: type: string description: Click a matched element enum: - click selector: type: string minLength: 1 required: - type - selector additionalProperties: false - type: object properties: type: type: string description: Type text into a matched element enum: - type selector: type: string minLength: 1 value: type: string required: - type - selector - value additionalProperties: false - type: object properties: type: type: string description: Select an option in a matched