{ "openapi": "3.0.1", "info": { "title": "Company Intent Scorer: Hiring, Funding & News Signals", "description": "Grade a list of companies A-D on real buying-readiness signals - hiring activity, funding events, and news momentum - with a plain-English reason behind every score for sales prioritization.", "version": "1.0", "x-build-id": "snh2nvfgk9s62uO6W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~company-intent-scorer-hiring-funding-and-news/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-company-intent-scorer-hiring-funding-and-news", "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/dataspryva~company-intent-scorer-hiring-funding-and-news/runs": { "post": { "operationId": "runs-sync-dataspryva-company-intent-scorer-hiring-funding-and-news", "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/dataspryva~company-intent-scorer-hiring-funding-and-news/run-sync": { "post": { "operationId": "run-sync-dataspryva-company-intent-scorer-hiring-funding-and-news", "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", "enum": [ "score", "monitor" ], "type": "string", "description": "Score every company, or compare this run with the previous run for the same monitor key.", "default": "score" }, "companiesText": { "title": "Companies (one per line)", "type": "string", "description": "Paste company names, one per line. Domains and careers URLs are accepted in the advanced list below." }, "companies": { "title": "Companies (advanced)", "type": "array", "description": "Advanced list. Each item can include companyName (or name), domain, careersUrl, ats, atsToken and disambiguator. Plain strings are also accepted. If provided, this overrides the text list.", "items": { "type": "object", "properties": { "companyName": { "type": "string", "title": "Company Name", "description": "The company's legal or brand name." }, "name": { "type": "string", "title": "Name (alias)", "description": "Alias for companyName." }, "domain": { "type": "string", "title": "Domain", "description": "Optional root domain, e.g. notion.so. Avoids domain lookup." }, "careersUrl": { "type": "string", "title": "Careers URL", "description": "Optional careers page or job-board URL, e.g. https://jobs.lever.co/acme." }, "ats": { "type": "string", "title": "ATS provider", "description": "Optional provider name when you already know it: greenhouse, ashby, lever, workable, smartrecruiters, recruitee, personio, breezy or workday." }, "atsToken": { "type": "string", "title": "ATS token", "description": "Optional board token for the provider, e.g. the token in jobs.ashbyhq.com/linear." }, "disambiguator": { "type": "string", "title": "Disambiguator", "description": "Optional word that must appear in news headlines, e.g. software for a common-word company name." } } } }, "signals": { "title": "Signals", "uniqueItems": true, "type": "array", "description": "Buying signals to check. Disabling a scored signal normalizes the remaining weights to 100.", "items": { "type": "string", "enum": [ "hiring", "funding", "news", "execChanges", "layoffs", "techStack" ], "enumTitles": [ "Hiring (ATS boards)", "Funding (SEC Form D + press)", "News momentum", "Executive changes", "Layoffs / risk", "Tech stack enrichment" ] }, "default": [ "hiring", "funding", "news", "execChanges", "layoffs", "techStack" ] }, "lookbackDays": { "title": "Lookback days", "minimum": 7, "maximum": 365, "type": "integer", "description": "Funding, news and executive-change window. News trend counts also cover 7, 30 and 90 days.", "default": 90 }, "minScore": { "title": "Minimum score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Drop scored companies below this intent score. Error records are always kept.", "default": 0 }, "targetTechnology": { "title": "Target technology", "type": "string", "description": "Optional technology to check on the company homepage, e.g. HubSpot or Marketo. The gap result does not change the intent score." }, "includeRawSignals": { "title": "Include raw evidence", "type": "boolean", "description": "In full output, add sample job titles and the top news headlines for auditing.", "default": false }, "outputFormat": { "title": "Output format", "enum": [ "compact", "full" ], "type": "string", "description": "compact returns ranking fields plus top signals. full adds the score breakdown and per-signal detail.", "default": "compact" }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on companies processed per run.", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many companies to process in parallel. Lower values are gentler on public sources.", "default": 3 }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "(mode=monitor) Name of the tracking history. Use the same key each run to compare against the previous snapshot." }, "emitUnchanged": { "title": "Emit unchanged companies", "type": "boolean", "description": "(mode=monitor) Include companies with no new or resolved signals and no score change.", "default": 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 } } } } } } } } } }