GET v1/browser/requests

For more information on browser requests, see here.

The following endpoint allows you to query for multiple browser requests, either by status or a list of particular ids, submitting a request with neither of these will return all requests for your account.

Get multiple browser requests

This endpoint retrieves browser requests in bulk by id or status.

get

/v1/browser/requests

Authorizations

Query parameters

idsstring

The unique identifiers of the browser requests to retrieve.

Example: {"value":"brq_V2P6PqrZpycFtbc7mtXE4tsNbeg2N6,brq_V2P6X38RDRMRyYcNJ82qPSH5eFfQRD"}

statusstring

The statuses of the browser requests to filter by. Valid values: pending, running, completed, failed

Example: {"value":"completed,running"}

pageSizeinteger · int32

Items to return per page (default: 30).

Example: {"value":20}

pageinteger · int32

Page number of the pagination (default: 1).

Example: {"value":1}

idsstring

The unique identifiers of the browser requests to retrieve.

statusstring

The statuses of the browser requests to filter by.

pageSizeinteger · int32

Items to return per page (default: 30).

pageinteger · int32

Page number of the pagination.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.gaffa.dev/v1/browser/requests' \
  --header 'X-API-Key: YOUR_API_KEY'

200

400

200

{"data":{"total_pages":1,"total_records":2,"results":[{"id":"brq_V2PUfFA8AQPAQ5VEsewpxdGUSZkgKP","url":"https://demo.gaffa.dev/simulate/table?loadTime=3&rowCount=20","proxy_location":null,"state":"completed","credit_usage":4,"error":null,"actual_url":null,"http_status_code":200,"from_cache":false,"started_at":"2024-11-22T16:31:13.128103+00:00","completed_at":"2024-11-22T16:31:47.020851+00:00","page_load_time":"00:00:03.4705813","actions":[{"id":"act_V2PUfETiTdXwzEgAW2NPURnATW7we9","type":"wait","query":"wait?selector=.loadingSelector&timeout=20000&continue_on_fail=True","custom_id":null,"timestamp":"2024-11-22T16:31:16.6080484+00:00","output":null,"error":null},{"id":"act_V2PUfBreQxHR2SNqGXuPzzWoiyRsrm","type":"print","query":"print?size=A4&margin=20&orientation=landscape&continue_on_fail=True","custom_id":null,"timestamp":"2024-11-22T16:31:40.5760333+00:00","output":"https://storage.gaffa.dev/brq/pdf/brq_V2PUfFA8AQPAQ5VEsewpxdGUSZkgKP/act_V2PUfBreQxHR2SNqGXuPzzWoiyRsrm.pdf","error":null}],"video":"https://storage.gaffa.dev/brq/video/brq_V2PUfFA8AQPAQ5VEsewpxdGUSZkgKP.mp4"},{"id":"brq_V2NmHY9FsvPQEGbfVBSeV6UCp2SXjC","url":"https://demo.gaffa.dev/simulate/article?loadTime=3&paragraphs=10&images=3","proxy_location":null,"state":"completed","credit_usage":1,"error":null,"actual_url":null,"http_status_code":200,"from_cache":false,"started_at":"2024-11-22T12:52:48.708264+00:00","completed_at":"2024-11-22T12:52:54.25994+00:00","page_load_time":"00:00:00.8094888","actions":[{"id":"act_V2NmHijnQa9iPDNcvhjS2GGFt5se8j","type":"wait","query":"wait?selector=article&timeout=20000&continue_on_fail=True","custom_id":null,"timestamp":"2024-11-22T12:52:49.5690537+00:00","output":null,"error":null},{"id":"act_V2NmHgs27VJKB49YavtK4CcyErdfvD","type":"generate_markdown","query":"generate_markdown?continue_on_fail=True","custom_id":null,"timestamp":"2024-11-22T12:52:52.8353136+00:00","output":"https://storage.gaffa.dev/brq/md/brq_V2NmHY9FsvPQEGbfVBSeV6UCp2SXjC/act_V2NmHgs27VJKB49YavtK4CcyErdfvD.md","error":null}],"video":null},{"id":"brq_V2HvS2cw4Z2wonqEAwbxoxjrkmRdEM","url":"https://demo.gaffa.dev/simulate/article","proxy_location":null,"state":"failed","credit_usage":0,"error":null,"actual_url":null,"http_status_code":null,"from_cache":false,"started_at":null,"completed_at":null,"page_load_time":null,"actions":null,"video":null}],"page":1,"page_size":30},"error":null,"httpCode":0}

A collection of browser requests that match the criteria