Extend FindAll run | Scout

curl -X POST https://core.usescout.sh/v1/findall/runs/findall_id/extend \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "limit": 20
}'

{
  "findall_id": "fa-37e97d4654d14fa6ad2fb342",
  "status": null,
  "query": "S-1 stage AI infrastructure companies",
  "entities": [
    {
      "name": "CoreWeave",
      "website": "https://coreweave.com",
      "headquarters": "Livingston, New Jersey",
      "source": "https://en.wikipedia.org/wiki/CoreWeave"
    },
    {
      "name": "Lambda",
      "website": "https://lambdalabs.com",
      "headquarters": "San Francisco, California",
      "source": "https://lambdalabs.com/about"
    }
  ],
  "count": 2,
  "credits": 7,
  "fields": [
    "name",
    "website",
    "headquarters"
  ],
  "createdAt": "2025-01-20T14:10:02+00:00",
  "completedAt": "2025-01-20T14:11:39+00:00"
}

Continue a completed run - find more distinct entities and append them. Returns the run re-queued; poll or stream it as usual.

curl -X POST https://core.usescout.sh/v1/findall/runs/findall_id/extend \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "limit": 20
}'

{
  "findall_id": "fa-37e97d4654d14fa6ad2fb342",
  "status": null,
  "query": "S-1 stage AI infrastructure companies",
  "entities": [
    {
      "name": "CoreWeave",
      "website": "https://coreweave.com",
      "headquarters": "Livingston, New Jersey",
      "source": "https://en.wikipedia.org/wiki/CoreWeave"
    },
    {
      "name": "Lambda",
      "website": "https://lambdalabs.com",
      "headquarters": "San Francisco, California",
      "source": "https://lambdalabs.com/about"
    }
  ],
  "count": 2,
  "credits": 7,
  "fields": [
    "name",
    "website",
    "headquarters"
  ],
  "createdAt": "2025-01-20T14:10:02+00:00",
  "completedAt": "2025-01-20T14:11:39+00:00"
}

Continue a completed run - find more distinct entities and append them. Returns the run re-queued; poll or stream it as usual.

Authentication

AuthorizationBearer

Your API key, sent as a Bearer token.

Path parameters

findall_idstringRequired

Request

This endpoint expects an object.

limitintegerOptional1-100Defaults to 20

How many more entities to find.

Response

Successful Response

findall_idstring

Opaque run identifier.

statusany

String for back-compat (queued/running/completed/failed/cancelled) OR the rich Parallel-style status object when the run has completed.

querystring

The enumeration query.

entitieslist of maps from strings to any

Entities found so far (flat rows; back-compat).

countinteger

Number of entities found.

creditsinteger

Cost accumulated by the run.

fieldslist of strings or null

The requested entity fields, if any.

output_schemamap from strings to any or null

The JSON Schema for entity objects, if any.

candidateslist of maps from strings to any or null

Rich candidates once the run has completed.

metadatamap from strings to any or null

Run metadata: {title, input}.

findall_schemamap from strings to any or null

Schema spec: objective, conditions, generator.

errorstring or null

Failure reason when status is failed.

createdAtstring or null

ISO-8601 created.

completedAtstring or null

ISO-8601 finished.

Errors

422

Unprocessable Entity Error

$	curl -X POST https://core.usescout.sh/v1/findall/runs/findall_id/extend \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"limit": 20
>	}'

1	{
2	"findall_id": "fa-37e97d4654d14fa6ad2fb342",
3	"status": null,
4	"query": "S-1 stage AI infrastructure companies",
5	"entities": [
6	{
7	"name": "CoreWeave",
8	"website": "https://coreweave.com",
9	"headquarters": "Livingston, New Jersey",
10	"source": "https://en.wikipedia.org/wiki/CoreWeave"
11	},
12	{
13	"name": "Lambda",
14	"website": "https://lambdalabs.com",
15	"headquarters": "San Francisco, California",
16	"source": "https://lambdalabs.com/about"
17	}
18	],
19	"count": 2,
20	"credits": 7,
21	"fields": [
22	"name",
23	"website",
24	"headquarters"
25	],
26	"createdAt": "2025-01-20T14:10:02+00:00",
27	"completedAt": "2025-01-20T14:11:39+00:00"
28	}