Create and stream a web/media search job

POST/v1/web-search/stream

Requires X-API-Key or Authorization: Bearer with a provisioned API key.

Create a persisted web-search job and immediately stream typed server-sent events until completion. Use the X-Job-Id response header to reconnect at GET /v1/web-search/jobs/{job_id}/stream with Last-Event-ID.

Request body

Field	Type	Required	Description
`adverseTerms`	array<string>	No	Optional adverse-media terms to search alongside the subject. The service also uses a built-in adverse/legal/regulatory term pack.
`dateRange`	`WebSearchDateRange` or null	No	—
`maxResults`	integer	No	Maxresults Default: `50`
`platformFilters`	array<`WebPlatform`>	No	Platformfilters Default: `["web", "news"]`
`seedUrls`	array<string>	No	Seedurls
`socialAccounts`	array<`WebSearchSocialAccount`>	No	Socialaccounts
`subject`	`WebSearchSubject`	Yes	—

Request examples

Person web/media search

Search public web/media with built-in adverse discovery for a person subject.

{
  "adverseTerms": [
    "fraud",
    "theft",
    "crime"
  ],
  "subject": {
    "name": "John Smith",
    "type": "person"
  }
}

Responses

`200`

Successful Response

`422`

Validation Error

Field	Type	Required	Description
`detail`	array<`ValidationError`>	No	Detail

OpenAPI

Download the full OpenAPI contract from /openapi.yaml.