GET
/
v1
/
batches
/
{batchId}
/
items

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

batch_id
string
required

The ID of the batch to retrieve the list of URLs and retrieve_id for.

Query Parameters

status
enum<string>

Status of the URLs to retrieve (completed or failed).

Available options:
completed,
failed
cursor
integer

Optional integer representing the index to start fetching content from. Useful to paginate until all URLs are fetched.

Start with 0, then provide response['cursor'] value of the last request.

limit
integer

Optional integer to limit the number of results returned. Recommended 10-50 results at a time. Paginated using cursor.

Maximum 10MB of content can be fetched in a single request.

formats
enum<string>[]

Deprecated: Use /retrieve endpoint with retrieve_id.

Array of formats to fetch (e.g., ["html", "markdown"]).

Available options:
html,
markdown,
json

Response

200 - application/json
batch_id
string

Batch ID

cursor
integer

To be passed in the query in next request to get the next items.

items
object[]
items_count
integer
object
string

The kind of object. "batch" for this endpoint.

status
string

in_progress or completed