{
  "openapi": "3.0.1",
  "info": {
    "title": "Scout — Lead Enrichment + OSINT",
    "description": "Email finder + lead enrichment + OSINT from public sources. Pass any fragment — name, email, or domain — get a verified dossier: 700+ identity sites, SMTP-validated emails, document mining, sanctions screen, domain→team discovery. $0.05 person, $0.15 domain. No API keys",
    "version": "0.1",
    "x-build-id": "isbpxPZT7zuk04qEZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logical_vivacity~scout/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logical_vivacity-scout",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/logical_vivacity~scout/runs": {
      "post": {
        "operationId": "runs-sync-logical_vivacity-scout",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/logical_vivacity~scout/run-sync": {
      "post": {
        "operationId": "run-sync-logical_vivacity-scout",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "full_name": {
            "title": "Full name",
            "type": "string",
            "description": "Person's full name. Single most useful anchor on its own - try it with no other fields."
          },
          "email": {
            "title": "Email",
            "type": "string",
            "description": "Email address. Auto-validated, breach-checked, MX + SMTP verified."
          },
          "phone": {
            "title": "Phone",
            "type": "string",
            "description": "Phone number in any format - auto-normalized to E.164."
          },
          "first_name": {
            "title": "First name",
            "type": "string",
            "description": "Optional split - supply if you only have the parts."
          },
          "last_name": {
            "title": "Last name",
            "type": "string",
            "description": "Optional split - supply if you only have the parts."
          },
          "company_name": {
            "title": "Company name",
            "type": "string",
            "description": "Employer name. Combined with `full_name` enables the email-finder waterfall."
          },
          "title": {
            "title": "Job title",
            "type": "string",
            "description": "The person's title or role."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, state, country - used for disambiguation against same-name profiles."
          },
          "linkedin_url": {
            "title": "LinkedIn URL",
            "type": "string",
            "description": "Person's LinkedIn profile URL. Auto-canonicalised to https://<host>/in/<slug>."
          },
          "github_username": {
            "title": "GitHub username",
            "type": "string",
            "description": "GitHub handle (with or without leading @). Auto-lowercased."
          },
          "twitter_handle": {
            "title": "Twitter / X handle",
            "type": "string",
            "description": "X (Twitter) handle. Auto-stripped of leading @."
          },
          "domain": {
            "title": "Domain",
            "type": "string",
            "description": "Company website domain. Scout enriches the domain (WHOIS, DNS, hosting, tech stack, cert transparency) AND scrapes the team page to spawn employee Person entities - turning a single domain input into a fully populated team graph."
          },
          "name": {
            "title": "Organization name",
            "type": "string",
            "description": "Company / organization name. Combine with `domain` for richest output."
          },
          "kind": {
            "title": "Entity kind (advanced)",
            "enum": [
              "",
              "person",
              "organization",
              "domain",
              "email",
              "phone"
            ],
            "type": "string",
            "description": "Override the auto-inferred kind. Leave blank to let Scout decide based on which fields you filled.",
            "default": ""
          },
          "notes": {
            "title": "Notes",
            "type": "string",
            "description": "Free-form context that gets attached to the entity (visible in output)."
          },
          "entities": {
            "title": "Bulk input - entities array",
            "type": "array",
            "description": "Bulk mode: an array of entity objects, each with the same vocabulary as the typed fields above. Useful when you want to enrich multiple leads in one run. Leave empty if you're using the typed single-entity fields above.\n\nExample entry shapes:\n  { \"kind\": \"person\", \"full_name\": \"Jane Doe\", \"email\": \"jane@acme.com\" }\n  { \"kind\": \"domain\", \"domain\": \"example.com\" }\n  { \"kind\": \"organization\", \"name\": \"Acme Inc\", \"domain\": \"acme.com\" }",
            "default": []
          },
          "processors": {
            "title": "Active enrichment systems",
            "uniqueItems": true,
            "type": "array",
            "description": "Subset of enrichment systems to run. Default empty = run everything. Narrow this to control runtime / cost. Identity, parsing, routing, inference, scoring, and dedup always run regardless.",
            "items": {
              "type": "string",
              "enum": [
                "gravatar",
                "breach_check",
                "email_pattern",
                "email_finder",
                "keybase_profile",
                "pgp_keyserver",
                "email_smtp_verify",
                "wikipedia",
                "bluesky_profile",
                "mastodon_profile",
                "reddit_user",
                "stackoverflow_user",
                "devto_user",
                "medium_user",
                "hackernews_mentions",
                "username_pivot",
                "personal_domain_check",
                "personal_domain_dive",
                "dork_search",
                "file_extract",
                "filename_parse",
                "resume_sections",
                "ocr_fallback",
                "doc_mentions",
                "doc_entities",
                "booking_link",
                "newsletter",
                "github_profile",
                "github_activity",
                "github_email_commits",
                "github_repo_dive",
                "connection_graph",
                "package_ownership",
                "handle_disambiguator",
                "linkedin_person",
                "socid_enrich",
                "exif_avatar",
                "identifier_harvest",
                "sanctions_check",
                "adverse_news",
                "whois_dns",
                "hosting",
                "mx_provider",
                "homepage",
                "cdn_detect",
                "subdomain_enum",
                "cert_transparency",
                "status_page",
                "api_docs",
                "wayback",
                "github_org",
                "linkedin_company",
                "crunchbase_company",
                "glassdoor_company",
                "builtwith_company",
                "ats_hiring",
                "product_hunt",
                "oss_repo_detect",
                "org_people"
              ]
            },
            "default": []
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy is strongly recommended - several upstream sources rate-limit single IPs and serve harder anti-bot challenges to cloud egress.",
            "default": {
              "useApifyProxy": true
            }
          },
          "headless": {
            "title": "Headless browser",
            "type": "boolean",
            "description": "Run Chromium headless. Stealth + Google Referer + randomised viewport are always applied. Disable only for local debugging.",
            "default": true
          },
          "verbose": {
            "title": "Verbose output",
            "type": "boolean",
            "description": "Include per-source provenance + run telemetry in the output, and detailed pipeline logs in the run log. Default off - output stays clean and compact.",
            "default": false
          },
          "perLeadTimeoutSeconds": {
            "title": "Per-entity timeout (seconds)",
            "minimum": 30,
            "maximum": 900,
            "type": "integer",
            "description": "Total runtime ceiling per top-level entity. Spawned related entities (employer, owned domain, team members) share the same budget. Increase for org→team workflows; decrease for tight cost control.",
            "default": 180
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}