{ "openapi": "3.0.1", "info": { "title": "B2B SaaS Pricing Page & Tier Matrix Extractor", "description": "Extract B2B SaaS pricing pages, plan tier matrices, monthly vs. annual billing discounts, usage quotas, enterprise SSO feature gates, and SHA-256 price change diffs โ€” no login cookies or API keys required, $0.00 start fee, $1.80/1k records.", "version": "1.0", "x-build-id": "8TTVg74l3io4B0h2M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/voxatools~b2b-saas-pricing-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-voxatools-b2b-saas-pricing-tracker", "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/voxatools~b2b-saas-pricing-tracker/runs": { "post": { "operationId": "runs-sync-voxatools-b2b-saas-pricing-tracker", "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/voxatools~b2b-saas-pricing-tracker/run-sync": { "post": { "operationId": "run-sync-voxatools-b2b-saas-pricing-tracker", "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": { "targets": { "title": "1. Target B2B SaaS Pricing URLs or Company Domains", "type": "array", "description": "List of B2B SaaS pricing page URLs (e.g., 'https://github.com/pricing', 'https://linear.app/pricing') or bare company domains (e.g., 'slack.com', 'notion.so', 'zapier.com'). Automatically discovers canonical '/pricing' or '/plans' paths when bare domains are supplied.", "items": { "type": "string" }, "default": [ "https://github.com/pricing", "https://linear.app/pricing" ] }, "resultType": { "title": "2. Output Mode (Granular Plan Tiers vs. Consolidated Vendor Battlecards)", "enum": [ "tiers", "vendors" ], "type": "string", "description": "Select 'tiers' (default โ€” $1.80/1k records) to output one structured row per SaaS pricing tier (Free, Pro, Team, Enterprise). Select 'vendors' ($3.20/1k companies) to aggregate all tiers of each SaaS vendor into a single executive competitive battlecard row.", "default": "tiers" }, "companySummaryMode": { "title": "3. ๐Ÿข Enable Consolidated Vendor Battlecard Mode (Alias for resultType = 'vendors')", "type": "boolean", "description": "When enabled (true), consolidates all extracted pricing tiers for each SaaS company into a unified Vendor Monetization & Sales Battlecard profile ($3.20/1k vendors all-inclusive), summarizing entry seat price, annual discount spread, and Enterprise SSO gating.", "default": false }, "includeFeatureMatrix": { "title": "4. ๐Ÿ” Deep Feature-Gate Matrix, Usage Quotas & Enterprise SSO Tax Breakdown (+$1.40 / 1,000 records)", "type": "boolean", "description": "Note: Plan names, monthly/annual prices, annual discount %, billing unit, and Monetization Transparency Score (0-100) are ALREADY included in the base $1.80/1k price! Enable 'includeFeatureMatrix' when you also need detailed featureGates arrays, usageQuotas limits, and granular Enterprise SSO/SCIM/Audit-Log gate signals (charged ONLY on records where non-empty feature gates or quotas are verified).", "default": false }, "onlyChangedOrNew": { "title": "5. ๐Ÿ”„ Stateful SHA-256 Price Change Radar (Only Output New or Modified Pricing Tiers)", "type": "boolean", "description": "When enabled on scheduled daily or weekly runs, compares live canonical SHA-256 tier fingerprints against your persistent Key-Value Store history and ONLY outputs and bills for newly added tiers or tiers where price, discount, or feature gates changed ($0.00 cost when 0 tiers changed).", "default": false }, "monitorStoreName": { "title": "6. Named Key-Value Store for Stateful Pricing History", "type": "string", "description": "Name of the persistent Apify Key-Value Store used by 'onlyChangedOrNew' to store and compare SHA-256 tier hashes across scheduled runs (defaults to 'STATE-SAAS-PRICING-HISTORY').", "default": "STATE-SAAS-PRICING-HISTORY" }, "deduplicateTargets": { "title": "7. ๐Ÿงน Deduplicate Canonical SaaS Domains & Duplicate URLs (0ms Pre-Fetch Dedup)", "type": "boolean", "description": "When enabled (default true), normalizes and merges duplicate target URLs or bare domains pointing to the same SaaS vendor (e.g., 'github.com' and 'https://github.com/pricing') before fetching, tracking 'cloneCount' and 'campaignScaleCount' so you never pay twice for duplicate targets.", "default": true }, "targetCurrency": { "title": "8. Target Currency Filter / Normalization Preference", "enum": [ "AUTO", "USD", "EUR", "GBP", "CAD", "AUD" ], "type": "string", "description": "Select 'AUTO' (default) to preserve the native currency disclosed on each SaaS pricing page (USD, EUR, GBP, etc.), or select a specific ISO currency code ('USD', 'EUR', 'GBP', 'CAD', 'AUD') to filter or tag matching currency records.", "default": "AUTO" }, "billingModelFilter": { "title": "9. Billing Model Filter (Per-Seat vs. Usage-Based vs. Flat-Rate vs. Enterprise Custom)", "enum": [ "ALL", "per_seat", "flat_rate", "usage_based", "hybrid", "enterprise_custom", "free" ], "type": "string", "description": "Filter extracted SaaS pricing tiers by their monetization billing model: 'ALL' (default), 'per_seat' (/user/month), 'flat_rate' (/month base), 'usage_based' (pay-as-you-go / credits), 'hybrid' (base + usage), 'enterprise_custom' (Contact Sales), or 'free' ($0 free tier).", "default": "ALL" }, "onlyTransparentPricing": { "title": "10. ๐Ÿ† Only Output Tiers with Publicly Disclosed Numeric Prices (Exclude Opaque 'Contact Sales' Walls)", "type": "boolean", "description": "When enabled, filters out opaque 'Contact Sales' / unlisted custom tiers where both monthlyPrice and annualPricePerMonth are hidden, returning only tiers with transparent self-serve pricing.", "default": false }, "minTransparencyScore": { "title": "11. Minimum Monetization Transparency Score (0 to 100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Filter results to only include SaaS pricing tiers or vendors achieving at least this Monetization Transparency & Value Score (0-100). Set to 75 to isolate Grade-A transparent pricing leaders.", "default": 0 }, "archivePricingSnapshot": { "title": "12. ๐Ÿ›ก๏ธ Archive Permanent SHA-256 HTML & JSON Pricing Snapshot Certificate (+$0.90 / 1,000 snapshots)", "type": "boolean", "description": "When enabled, saves a self-contained, tamper-evident HTML & JSON pricing battlecard snapshot with UTC timestamp and SHA-256 cryptographic digest into your Apify Key-Value Store ('snapshotArchiveUrl').", "default": false }, "generateBattlecardSummary": { "title": "13. ๐Ÿ“‹ Generate Executive RevOps & Sales Battlecard Benchmark Summary (OUTPUT_SUMMARY)", "type": "boolean", "description": "When enabled (default true), computes true mathematical averages across all extracted SaaS vendors (average entry price, average annual discount %, free-tier ratio, Enterprise SSO tax rate) and saves 'OUTPUT_SUMMARY' and 'COMPETITOR_AD_SUMMARY.json' to the Key-Value Store.", "default": true }, "customTierSelector": { "title": "14. Custom CSS Tier Card Selector Override (Optional)", "type": "string", "description": "Optional CSS selector hint (e.g., '.pricing-card, [data-testid=\"plan-card\"]') for bespoke or non-standard SaaS pricing pages. Leave empty (\"\") to use automatic SSR JSON & semantic DOM tier detection.", "default": "" }, "maxResults": { "title": "15. Maximum Records to Output", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of SaaS pricing tier records (or consolidated vendor profiles) to output in this run (1 to 5,000 records).", "default": 50 }, "maxTotalChargeUsd": { "title": "16. Maximum Total Run Budget Cap in USD (Hard Cost Guardrail)", "minimum": 0.01, "maximum": 1000, "type": "number", "description": "Hard spending ceiling in USD for this Actor run (defaults to $10.00). The Actor monitors cumulative PPE charges in real time and stops gracefully before exceeding your budget cap.", "default": 10 }, "proxyConfiguration": { "title": "17. Proxy Configuration (Zero-Proxy Default + Automatic Fallback on HTTP 429)", "type": "object", "description": "Optional Apify Proxy settings. Public SaaS pricing pages work via direct zero-browser HTTP with $0.00 proxy cost by default; enable Apify Proxy only if targeting WAF-throttled domains at high concurrency.", "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 } } } } } } } } } }