For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
  • Overview
    • API reference
  • Search
    • POSTSearch
    • GETSearch Run List
    • GETSearch Run Get
    • GETSearch Run Events
    • POSTSearch Run Cancel
  • Extract
    • GETExtract a URL
    • POSTExtract
  • Monitors
    • GETList monitors
    • POSTCreate monitor
    • GETRetrieve monitor
    • DELDelete monitor
    • PATCHUpdate monitor
    • GETList monitor events
    • POSTMonitor Pause
    • POSTMonitor Resume
    • POSTRun monitor
  • Tasks
    • POSTTask
    • POSTCreate task run
    • GETRetrieve task run
    • GETStream task run events
    • GETTask List
    • GETTask Get
    • GETTask Events
    • POSTTask Cancel
  • Chat
    • POSTChat completion
  • Find All
    • POSTFindAll
    • GETFindall Run List
    • POSTCreate FindAll run
    • GETRetrieve FindAll run
    • GETStream FindAll run events
    • POSTCancel FindAll run
    • POSTExtend FindAll run
    • POSTEnrich FindAll run
LogoLogo
Search

Search Run List

||View as Markdown|
GET
https://core.usescout.sh/v1/searches
GET
/v1/searches
$curl -G https://core.usescout.sh/v1/searches \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d limit=10 \
> -d offset=0
1{
2 "searches": [
3 {
4 "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
5 "query": "latest AI research papers",
6 "status": "completed",
7 "createdAt": "2024-06-10T15:45:00Z",
8 "completedAt": "2024-06-10T15:50:00Z",
9 "resultCount": 125
10 },
11 {
12 "id": "b2c3d4e5-f678-9012-ab34-cd56ef789012",
13 "query": "climate change news",
14 "status": "completed",
15 "createdAt": "2024-06-09T10:20:00Z",
16 "completedAt": "2024-06-09T10:25:00Z",
17 "resultCount": 98
18 }
19 ],
20 "total": 42,
21 "limit": 10,
22 "offset": 0
23}

Paginated list of deep-search runs, newest first.

Was this page helpful?
Previous

Search

Next

Search Run Get

Built with

Authentication

AuthorizationBearer
Your API key, sent as a Bearer token.

Query parameters

limitintegerOptionalDefaults to 5
offsetintegerOptionalDefaults to 0

Response

Successful Response

Errors

422
Unprocessable Entity Error