PostWebSearchLiveRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/crustdata-com/json-schema/crustdata-com-post-web-search-live-request-schema.json",
  "title": "PostWebSearchLiveRequest",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/crustdata-com-openapi-generated.yml#/components/schemas/PostWebSearchLiveRequest",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query text. Max 5,000 characters. Supports search operators like `site:` and `filetype:`."
    },
    "location": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code for region-specific results (e.g., \"US\", \"GB\", \"JP\")."
    },
    "sources": {
      "type": "array",
      "description": "Sources to query: `web`, `news`, `scholar-articles`, `scholar-articles-enriched`, `scholar-author`, `ai`, `social`. Omitting this field searches all sources."
    },
    "site": {
      "type": "string",
      "description": "Restrict results to a domain (e.g., \"linkedin.com/company\", \"github.com\"). Max 500 characters."
    },
    "start_date": {
      "type": "integer",
      "description": "Unix timestamp (seconds). Only results after this date."
    },
    "end_date": {
      "type": "integer",
      "description": "Unix timestamp (seconds). Only results before this date. Must be > `start_date`."
    },
    "human_mode": {
      "type": "boolean",
      "description": "Attempt a browser-like retrieval path when standard search access is blocked by bot protection."
    },
    "page": {
      "type": "integer",
      "description": "Number of result pages to aggregate into the response. Minimum `1`, maximum `15`. Values above `15` return `400`. When `page` is greater than `1`, `sources` must contain exactly one source."
    }
  },
  "required": [
    "query"
  ]
}