{ "openapi": "3.0.1", "info": { "title": "LinkedIn & ATS Scraper — Zero-Cookie Jobs & Decision Emails", "description": "Extract B2B hiring signals from LinkedIn Guest Jobs & direct ATS feeds (Greenhouse, Lever, Personio) across 9 countries without cookies. Includes City-Split 1,000-result bypass, root-domain resolution, Impressum crawling & verified named-contact emails.", "version": "1.0", "x-build-id": "jToyJIYuL5ro3hp2L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aperture~linkedin-ats-b2b-buying-signal-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aperture-linkedin-ats-b2b-buying-signal-scraper", "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/aperture~linkedin-ats-b2b-buying-signal-scraper/runs": { "post": { "operationId": "runs-sync-aperture-linkedin-ats-b2b-buying-signal-scraper", "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/aperture~linkedin-ats-b2b-buying-signal-scraper/run-sync": { "post": { "operationId": "run-sync-aperture-linkedin-ats-b2b-buying-signal-scraper", "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": { "keywords": { "title": "Job Title & Intent Keywords", "type": "array", "description": "Target job titles or B2B intent search terms (e.g., ['Account Executive', 'VP Sales', 'Head of Engineering', 'Data Engineer']).", "items": { "type": "string" }, "default": [ "Account Executive", "VP Sales", "Head of Engineering" ] }, "countries": { "title": "Target Countries (DE, UK, FR, US, NL, AT, BE, AU, NZ)", "type": "array", "description": "Select target ISO country codes for job posting searches across LinkedIn Guest and ATS boards.", "items": { "type": "string" }, "default": [ "DE", "UK", "FR", "US", "NL", "AT", "BE", "AU", "NZ" ] }, "location": { "title": "Target Location / City (Optional)", "type": "string", "description": "Specific city, metropolitan area, or regional location filter (e.g., 'Berlin', 'London', 'Paris', 'San Francisco').", "default": "" }, "postedWithinDays": { "title": "Posted Within Days (Recency Filter)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only retrieve jobs posted or updated within the last N days (1 = last 24h, 7 = past week, 30 = past month).", "default": 30 }, "maxItems": { "title": "Max Buying Signals (Max Items)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of normalized buying-signal records to output (default: 20). Free-tier Apify runs are capped at 25 items per run; paid Apify plans support unlimited runs.", "default": 20 }, "atsBoardTokens": { "title": "Direct ATS Board Tokens (Greenhouse, Lever, Personio)", "type": "array", "description": "Optional board tokens/subdomains for direct company ATS scraping (e.g., ['celonis', 'figma'] for Greenhouse, ['mistral'] for Lever, ['wandelbots'] for Personio).", "items": { "type": "string" }, "default": [] }, "signalSources": { "title": "Signal Data Sources", "type": "array", "description": "Select hiring signal data sources: 'linkedin_guest' (Zero-Cookie LinkedIn Guest Jobs API), 'greenhouse' (direct Greenhouse board feeds), 'lever' (direct Lever job site feeds), and 'personio' (direct Personio XML feeds).", "items": { "type": "string" }, "default": [ "linkedin_guest", "greenhouse", "lever", "personio" ] }, "workplaceType": { "title": "Workplace Type Filter", "enum": [ "any", "remote", "hybrid", "onsite" ], "type": "string", "description": "Filter jobs by workplace arrangement: 'any' (all postings), 'remote' (remote only), 'hybrid' (hybrid only), or 'onsite' (on-site only).", "default": "any" }, "seniorityFilter": { "title": "Seniority Filter (Optional)", "type": "array", "description": "Filter postings by seniority band: 'entry', 'mid', 'senior', 'manager', 'director', 'vp', 'cxo'. Leave empty to include all seniority levels.", "items": { "type": "string" }, "default": [] }, "splitByCity": { "title": "Split by Major Cities (1,000-Result Cap Bypass)", "type": "boolean", "description": "When enabled, expands each target country into separate queries across top tier-1 metro hubs (e.g., DE into Berlin, Munich, Hamburg, Frankfurt, Cologne) to bypass LinkedIn's 1,000-result search limit.", "default": false }, "scraperMode": { "title": "Scraper & Enrichment Mode (PPE Tier)", "enum": [ "basic", "enriched_with_email" ], "type": "string", "description": "Choose 'basic' ($0.002/signal) to extract job details and resolve corporate root domains without website email crawling. Choose 'enriched_with_email' ($0.008 strictly when a verified named contact email is discovered; generic role emails like info@/contact@/jobs@ are included free as 'role_fallback' and billed at $0.002).", "default": "enriched_with_email" }, "strictBuyerMatchOnly": { "title": "Strict Buyer Match Only (Verified Corporate Decision-Makers Only)", "type": "boolean", "description": "When enabled (true), emits ONLY signals where a non-HR department/role decision-maker (role_matched or department_matched) with a verified named email (ok), non-empty verbatim title, and live corporate contact_source_url was discovered on the company's own website. Filters out recruiter contacts, statutory Impressum legal officers, generic info@ inboxes, and unmatched rows.", "default": false }, "icpScoringPreset": { "title": "Client ICP Scoring Preset (1-Click Workspace Vertical)", "enum": [ "b2b_saas_cyber_tech", "industrial_manufacturing_chem", "financial_insurance_professional", "public_sector_govtech", "biotech_clinical_pharma", "custom" ], "type": "string", "description": "Select the target client industry preset to automatically calibrate 0–100 account ICP scoring without hand-writing JSON. Pure account & signal fit (0% contact provenance penalty) so contact_confidence and $0.008/$0.002 PPE billing remain strictly orthogonal.", "default": "b2b_saas_cyber_tech" }, "icpTargetSeniority": { "title": "Target Role Seniority Priority", "enum": [ "director_vp_first", "manager_territory_first", "technical_specialist_first" ], "type": "string", "description": "Choose which hiring or signal role seniority tier receives the maximum +25 pt seniority weight for this client workspace.", "default": "director_vp_first" }, "icpBoostKeywords": { "title": "Client ICP Boost Keywords (+18 pts on match)", "type": "array", "description": "Type any industry, product, or niche keywords that matter to this client workspace (e.g. 'cybersecurity', 'chemicals', 'industrial insurance'). Matching accounts automatically receive an +18 pt ICP boost.", "items": { "type": "string" }, "default": [] }, "icpRecencyPriority": { "title": "Signal Recency Weighting", "enum": [ "fresh_first", "balanced", "evergreen" ], "type": "string", "description": "Control how strongly fresh signals (posted <=3 days ago) are prioritized over older signals in the 0–100 account ICP score.", "default": "fresh_first" }, "icpWeights": { "title": "Custom Account ICP Weights (Per-Client Workspace Scoring)", "type": "object", "description": "Optional configurable 0–100 account ICP scoring weights (signalTypes, roleSeniority, geos, industryKeywords regex-to-points map, and recency brackets). Pure account & signal fit (0% contact provenance penalty) so you can customize account scoring per client workspace without affecting contact_confidence or $0.008/$0.002 PPE billing.", "default": { "signalTypes": { "multi_signal": 45, "contract_award": 35, "clinical_trial": 35, "funding": 35, "jobs": 30, "executive_change": 25 }, "roleSeniority": { "director_vp_global": 25, "manager_kam_territory": 18, "specialist_ic": 10 }, "geos": { "DE": 15, "AT": 12, "CH": 15, "UK": 15, "FR": 15, "NL": 14, "BE": 14, "AU": 14, "NZ": 12, "US": 15 }, "industryKeywords": { "cybersecurity|security|software|cloud|it|saas": 18, "chemicals|industrial|automation|manufacturing|entry systems": 12, "insurance|versicherung|finanz|logistics": 8, "testing|instruments|actuators|sensors": 6 }, "recency": { "days_0_3": 15, "days_4_7": 11, "days_8_14": 6, "days_15_plus": 0 } } }, "blacklistDomains": { "title": "Blacklist Domains & Employers", "type": "array", "description": "Company root domains or employer names to skip at $0 before enrichment and PPE charging.", "items": { "type": "string" }, "default": [] }, "excludeCompanyKeywords": { "title": "Unbilled Pre-Fetch Exclude Company Keywords ($0 Filter)", "type": "array", "description": "Case-insensitive keywords matched against employer names BEFORE domain resolution, website crawling, or PPE charging. Matching records are dropped at $0.00.", "items": { "type": "string" }, "default": [] }, "excludeLocations": { "title": "Unbilled Pre-Fetch Exclude Locations ($0 Filter)", "type": "array", "description": "Case-insensitive city, state, or country substrings dropped BEFORE domain resolution, website crawling, or PPE charging ($0.00 cost).", "items": { "type": "string" }, "default": [] }, "excludeStaffingAgencies": { "title": "Exclude Staffing & Recruiting Agencies ($0 Cost Shield)", "type": "boolean", "description": "When enabled (default), drops postings from third-party staffing agencies and job boards (Hays, PageGroup, Michael Page, Randstad, Adecco, etc.) before domain resolution or PPE billing.", "default": true }, "onlyNewSignals": { "title": "Cross-Run Delta Mode (Only New Job Signals)", "type": "boolean", "description": "When enabled, persists seen job posting IDs in a named Apify Key-Value Store (monitorScopeName) and skips previously emitted signals at $0.", "default": false }, "monitorScopeName": { "title": "Delta Mode Key-Value Store Name", "type": "string", "description": "Named Apify Key-Value Store used to persist seen signal keys across scheduled runs when onlyNewSignals is enabled.", "default": "buying-signal-dedup-store" }, "customEmailVerifierApiKey": { "title": "Custom Email Verifier API Key (Optional BYOK)", "type": "string", "description": "Optional MillionVerifier / ZeroBounce / Reacher compatible API key for real-time SMTP mailbox verification during enriched_with_email runs." }, "proxyConfiguration": { "title": "Proxy Configuration (Optional — Zero Proxy Required by Default)", "type": "object", "description": "LinkedIn Guest Jobs and direct ATS feeds operate over pure HTTP/2 with zero proxy overhead by default. Optional proxy settings are used only when crawling rate-limited corporate websites during enriched_with_email mode.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }