{ "openapi": "3.0.1", "info": { "title": "Company Buying Signals: Hiring, SEC Filings & News", "description": "Find why a company is worth contacting now: hiring spikes, SEC filings and news, ranked with dates and source URLs. Use this when a sales agent needs cited reasons to reach out. From $0.03.", "version": "0.0", "x-build-id": "EBsdJy9gRBizmbGjB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s3nafps~company-why-now-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s3nafps-company-why-now-signals", "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/s3nafps~company-why-now-signals/runs": { "post": { "operationId": "runs-sync-s3nafps-company-why-now-signals", "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/s3nafps~company-why-now-signals/run-sync": { "post": { "operationId": "run-sync-s3nafps-company-why-now-signals", "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": { "mode": { "title": "Mode (which tool to run)", "enum": [ "why_now_pack", "hiring", "filings", "news" ], "type": "string", "description": "Pick one. why_now_pack ($0.10): hiring + filings + news and a ranked top-3 'why reach out now' list with evidence, date, source, confidence (best default for outreach/sales agents). hiring ($0.03): open roles by department/location, new roles since a date, senior and first-in-function hires. filings ($0.03): SEC 8-K, 10-K/10-Q, S-1, Form D with item codes in plain English. news ($0.03): GDELT news classified into funding, layoffs, leadership change, M&A, product launch, expansion, legal. A mode is charged only when it returns at least one signal; signals that depend on an uncertain company match (confidence below 0.6) are labelled low_confidence and never charged.", "default": "why_now_pack" }, "domain": { "title": "Company domain", "type": "string", "description": "The company's website domain, e.g. stripe.com or https://www.stripe.com. This is the primary key: the Actor reads the homepage title, og:site_name and JSON-LD Organization to resolve the company name, then matches it against SEC company_tickers.json." }, "companyName": { "title": "Company name (optional)", "type": "string", "description": "Optional legal or trade name. Improves entity resolution when the website does not state it clearly. If it conflicts with the name found on the site, the match is flagged and may fall below 0.6 confidence (then filings/news signals are labelled low_confidence and not charged)." }, "ticker": { "title": "Stock ticker (optional)", "type": "string", "description": "Optional US-listed ticker, e.g. AAPL. An exact ticker match in SEC company_tickers.json is strong evidence for the entity and enables SEC filings." }, "companies": { "title": "Companies (bulk)", "maxItems": 25, "type": "array", "description": "Optional list for scheduled monitoring: strings (domains) or objects like {\"domain\": \"stripe.com\", \"companyName\": \"Stripe\", \"ticker\": \"\"}. One dataset item per company, each charged separately when it has signals. At most 25." }, "since": { "title": "Since (date)", "type": "string", "description": "Return only signals newer than this date (YYYY-MM-DD or ISO 8601), for scheduled monitoring: pass the date of your last run. If empty, the windows are 30 days for hiring and news and 90 days for SEC filings. News lookback is limited to about 90 days by the source; the date is clamped to 365 days." }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 25, "type": "integer", "description": "Safety cap on how many companies from the list are processed (max 25).", "default": 10 }, "maxNewsArticles": { "title": "Max news articles fetched", "minimum": 10, "maximum": 250, "type": "integer", "description": "How many GDELT articles to request per company before classification and de-duplication (max 250).", "default": 100 }, "maxFilings": { "title": "Max filings returned", "minimum": 5, "maximum": 100, "type": "integer", "description": "Maximum SEC filings returned per company (max 100).", "default": 30 }, "maxJobs": { "title": "Max jobs analysed", "minimum": 50, "maximum": 3000, "type": "integer", "description": "Maximum job postings read from a company's job board (max 3000).", "default": 1000 }, "maxConcurrency": { "title": "Concurrent companies", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many companies are processed in parallel (max 5). SEC requests are throttled separately.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 3, "maximum": 30, "type": "integer", "description": "Timeout for each network request; every request is retried with backoff (max 30).", "default": 12 } } }, "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 } } } } } } } } } }