Run History

Method: POST

Endpoint: /api/v1/run/list

Send the request body with Content-Type: application/json.

Try it

POST/api/v1/run/listList runs

api-keyRequired

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

BodyRequiredapplication/json

FieldTypeRequiredDescription

page_indexintegeryes1-based page index.

page_sizeintegeryesPage size.

statusenum (6)—Optional status filter. `0` means all statuses.

scraper_slugstring—Optional scraper filter.

Request body (JSON)Reset to example

{ "page_index": 1, "page_size": 10, "status": 0, "scraper_slug": "01KPD6M5YVHWCNQCRK32BD02TP" }

Send Request Clear all

Request Example

{
    "page_index": 1,
    "page_size": 20,
    "status": 0,
    "scraper_slug": "YOUR_SCRAPER_SLUG"
}

Parameters

Parameter	Default	Type	Required	Description
page_index	1	Integer	Yes	Current page number
page_size	20	Integer	Yes	Items per page
status	0	Integer	No	Run status: 0 All, 1 Ready, 2 Running, 3 Succeeded, 4 Failed, 5 Aborted
scraper_slug	-	String	No	Unique Worker identifier

Response Example

{
    "code": 0,
    "message": "success",
    "data": {
        "count": 106,
        "list": [
            {
                "status": 3,
                "err_msg": "",
                "slug": "01KSFDS8XWTJME33C08XMCR6B9",
                "scraper_title": "News Collection 20260305",
                "scraper_slug": "01KPD6M5YVHWCNQCRK32BD02TP",
                "results": 4,
                "usage": "0.065",
                "started_at": 1773305309,
                "finished_at": 1773305316,
                "duration": 7,
                "origin": "api",
                "traffic": 23108,
                "version": "v1.0.5"
            }
        ]
    }
}

Response Fields

Parameter	Example	Type	Description
code	0	Integer	Global status code
message	success	String	Response message
data	-	Object	Response payload

data Fields

Parameter	Example	Type	Description
count	106	Integer	Total record count
list	-	Array	Run record list

list[] Fields

Parameter	Example	Type	Description
status	3	Integer	Run status: 1 Ready, 2 Running, 3 Succeeded, 4 Failed, 5 Aborted
err_msg	-	String	Error message
slug	01KSFDS8XWTJME33C08XMCR6B9	String	Unique run record identifier
scraper_title	News Collection 20260305	String	Worker title
scraper_slug	01KPD6M5YVHWCNQCRK32BD02TP	String	Unique Worker identifier
results	4	Integer	Number of collected results
usage	0.065	String	Device usage cost in USD
started_at	1773305309	Integer	Start timestamp
finished_at	1773305316	Integer	Finish timestamp
duration	7	Integer	Execution duration in seconds
origin	api	String	Run source: api or web
traffic	23108	Integer	Traffic usage in bytes
version	v1.0.5	String	Worker version

Error Response

{
    "code": 4000,
    "message": "Invalid request parameters",
    "data": null
}