Search Request

Create a new Smart Search request. This endpoint starts a search job

Create Search

post

Initiates a new search operation. Validates API key, checks coin balance, and starts the search.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

typestring · enumRequiredExample: EMAILPossible values:

searchstringRequiredExample: [e-mail]

emailNotificationbooleanOptionalDefault: false

searchScopestring · enumOptionalDefault: FULLPossible values:

operatorstring · enumOptionalPossible values:

categoriesstring[]OptionalExample: ["crypto","jobs"]

Responses

200

Search created successfully

application/json

idintegerOptionalExample: 789

clientIdintegerOptionalExample: 123

typestringOptionalExample: EMAIL

searchstringOptionalExample: [e-mail]

notifyViaEmailbooleanOptionalExample: true

searchScopestringOptionalExample: REAL_TIME

statusstring · enumOptionalExample: PENDINGPossible values:

createdAtstring · date-timeOptionalExample: 2025-08-07T12:34:56.000Z

400

Bad request or insufficient coins

application/json

403

Invalid credentials

application/json

500

Search could not be started

application/json

post

/api/products/search

HTTPcURLJavaScriptPython

POST /api/products/search HTTP/1.1
Host: api.dos-op.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "type": "EMAIL",
  "search": "[e-mail]",
  "emailNotification": false,
  "searchScope": "FULL",
  "operator": "EXACT",
  "categories": [
    "crypto",
    "jobs"
  ]
}

{
  "id": 789,
  "clientId": 123,
  "type": "EMAIL",
  "search": "[e-mail]",
  "notifyViaEmail": true,
  "searchScope": "REAL_TIME",
  "status": "PENDING",
  "createdAt": "2025-08-07T12:34:56.000Z"
}