{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/serpkite-com/json-schema/serpkite-com-research-request-schema.json",
  "title": "ResearchRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/serpkite-com-research-api-openapi.yml#/components/schemas/ResearchRequest",
  "type": "object",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000,
      "description": "The research task in plain words (`q` is accepted as an alias)"
    },
    "effort": {
      "type": "string",
      "enum": [
        "lite",
        "standard",
        "deep"
      ],
      "default": "standard",
      "description": "lite = 30, standard = 75, deep = 200 credits"
    },
    "output_schema": {
      "type": "object",
      "additionalProperties": true,
      "description": "A JSON Schema (at most 16 KB); the report is also returned as a JSON value in `result.output`"
    },
    "country": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Receives the signed `research.completed` event. Defaults to the account webhook"
    }
  }
}