generated: '2026-10-02'
method: derived
generator: derive-data-model.py
source:
- openapi/adscrawl-openapi.yaml
notation: has_one = property $ref; has_many = array of $ref; belongs_to = <entity>_id field
summary:
  entities: 20
  entities_in_spec: 20
  relationships: 14
entities:
- name: BrowserSettings
  fields: 11
  description: Reusable browser options. proxy and countryCode cannot be supplied together. Browser tasks and temporary
    CDP sessions use a managed proxy when selection is omitted. Cloud browser API-key starts have s
- name: CdpSession
  fields: 3
- name: CloudBrowser
  fields: 11
- name: CloudLaunchRequest
  fields: 5
- name: CloudLifecycleResult
  fields: 7
- name: CloudRuntime
  fields: 6
- name: CloudStartRequest
  fields: 5
  description: API-key callers must provide proxy; session callers must provide apiKeyId. These requirements depend
    on authentication.
- name: Cookie
  fields: 12
  description: Preset browser cookie. Use native JSON booleans. Legacy browser-task inputs also accept compatibility
    forms for some flags. Launch defaults an omitted value to an empty string. Expiry aliases are Unix
- name: Error
  fields: 4
- name: ExtractionField
  fields: 10
- name: ExtractionTemplate
  fields: 11
- name: Fingerprint
  fields: 13
  description: Browser fingerprint modes. Defaults and supported combinations depend on the workflow; the server
    maintains a coherent identity and seed.
- name: Geolocation
  fields: 2
- name: HtmlRequest
  fields: 0
- name: Proxy
  fields: 6
  description: Use server OR protocol/host/port. server must be an http:// or socks5:// URL with an explicit port,
    without embedded credentials, query, fragment, or non-root path. Port range is 1-65535. Provide both
- name: ScreenshotRequest
  fields: 0
- name: SpaRequest
  fields: 0
- name: TaskOptions
  fields: 0
- name: Viewport
  fields: 2
- name: WaitFor
  fields: 3
relationships:
- from: BrowserSettings
  to: Viewport
  type: has_one
  via: viewport
- from: BrowserSettings
  to: Geolocation
  type: has_one
  via: geolocation
- from: BrowserSettings
  to: Proxy
  type: has_one
  via: proxy
- from: BrowserSettings
  to: Fingerprint
  type: has_one
  via: fingerprint
- from: BrowserSettings
  to: Cookie
  type: has_many
  via: cookies
- from: SpaRequest
  to: WaitFor
  type: has_one
  via: waitFor
- from: CloudLaunchRequest
  to: Proxy
  type: has_one
  via: proxy
- from: CloudLaunchRequest
  to: Cookie
  type: has_many
  via: cookies
- from: CloudLaunchRequest
  to: Fingerprint
  type: has_one
  via: fingerprint
- from: CloudStartRequest
  to: Proxy
  type: has_one
  via: proxy
- from: CloudStartRequest
  to: Cookie
  type: has_many
  via: cookies
- from: CloudStartRequest
  to: Fingerprint
  type: has_one
  via: fingerprint
- from: CloudBrowser
  to: CloudRuntime
  type: has_one
  via: runtime
- from: CloudLifecycleResult
  to: CloudRuntime
  type: has_one
  via: runtime