# Create a batch | Parsium Docs Source: https://docs.parseium.com/api/operations/createbatch/ # Create a batch POST /v1/batches Submit either parser URLs or prebuilt API inputs. The two shapes are mutually exclusive. Inputs are deduplicated and credits are reserved atomically. More than 100 jobs requires a database sink. ## Authorizations Section titled “Authorizations ” - **[apiKeyHeader](/api/#apikeyheader)** - **[apiKeyQuery](/api/#apikeyquery)** ## Parameters Section titled “ Parameters ” ### Header Parameters Section titled “Header Parameters ” Idempotency-Key string <= 128 characters Deduplicates retries for 24 hours. Maximum 128 characters. ## Request Body required Section titled “Request Body required ” Select media type application/json One of: - [object](#tab-panel-14) - [object](#tab-panel-15) object parser_id required string urls required Array >= 1 items <= 10000 items scrape_config Fetch override. Credit price depends on browser and proxy settings. object useBrowser boolean waitSeconds number waitForBrowser string proxy `default`, `highquality`, `hardcore`, `premium`, or `premium:`. string sink Return data or write rows to an owned database. object mode required string default: return Allowed values: return database database string /^[a-z0-9-]{1,32}$/ table string /^[a-z0-9_]{1,48}$/ key Upsert key columns; defaults to `_url` for parser jobs. Array object api required string inputs required Array >= 1 items <= 10000 items object key additional properties any sink Return data or write rows to an owned database. object mode required string default: return Allowed values: return database database string /^[a-z0-9-]{1,32}$/ table string /^[a-z0-9_]{1,48}$/ key Upsert key columns; defaults to `_url` for parser jobs. Array ## Responses Section titled “ Responses ” ### 202 Section titled “202 ” Batch accepted. Select media type application/json object batch_id string total integer duplicates_removed integer credits_reserved integer sink Return data or write rows to an owned database. object mode required string default: return Allowed values: return database database string /^[a-z0-9-]{1,32}$/ table string /^[a-z0-9_]{1,48}$/ key Upsert key columns; defaults to `_url` for parser jobs. Array replayed boolean ### 400 Section titled “400 ” Malformed request. Select media type application/json object error required string ##### Example ``` invalid request ``` field Field that failed validation. string detail string hint string ### 401 Section titled “401 ” Missing or invalid API key. Select media type application/json object error required string ##### Example ``` invalid request ``` field Field that failed validation. string detail string hint string ### 402 Section titled “402 ” Insufficient unreserved credits. Select media type application/json object error required string ##### Example ``` insufficient credits ``` required required integer available required integer ### 404 Section titled “404 ” Resource missing or not owned by this account. Select media type application/json object error required string ##### Example ``` invalid request ``` field Field that failed validation. string detail string hint string ### 422 Section titled “422 ” Validation failed. Select media type application/json object error required string ##### Example ``` invalid request ``` field Field that failed validation. string detail string hint string ### 429 Section titled “429 ” Request, concurrency, or plan limit exceeded. Select media type application/json One of: - [object](#tab-panel-16) - [object](#tab-panel-17) object error required string ##### Example ``` invalid request ``` field Field that failed validation. string detail string hint string object error required string ##### Example ``` pending limit ``` pending required integer limit required integer accepted required integer 0 #### Headers Section titled “Headers ” Retry-After integer Seconds to wait when supplied.