---
title: "Starts a new batch. You receive an `id` that you can use to track the progress of the batch as shown [here](/api-reference/batches/info). Note: Processing time is constant regardless of batch size"
method: POST
path: "/olostep/v1/batches"
tags: ["Olostep"]
---

# Starts a new batch. You receive an \`id\` that you can use to track the progress of the batch as shown \[here\](/api-reference/batches/info). Note: Processing time is constant regardless of batch size

`POST /olostep/v1/batches`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/olostep/v1/batches`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/olostep/v1/batches/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `items` object[], required: Array of items to be processed in the batch.
    - `custom_id` string
    - `url` string
  - `country` string: Country for the batch execution. Provide in ISO 3166-1 alpha-2 codes like US(USA), IN(India), etc
  - `parser` object: You can use this parameter to specify the parser to use. Parsers are useful to extract structured content from web pages. Olostep has a few parsers built in for most common web pages, and you can also create your own parsers.
    - `id` string
  - `links_on_page` object: Get all the links present on each page in the batch.
    - `absolute_links` boolean
    - `include_links` string[]
    - `exclude_links` string[]

## Response `200`

Successful response

## Other responses

- `402`: Payment Required (x402 / MPP / np)

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added required request body
- **2026-08-25** `806e279c8d50`: 2 info
  - api tag `Olostep` added
  - api tag `Olostep API` removed

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/olostep/v1/batches/post.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/fc2e1d26c8eb?raw)