{ "openapi": "3.0.1", "info": { "title": "Gov Contract Opportunities: SAM.gov + EU TED + USAspending", "description": "US federal (SAM.gov), EU (TED) tenders and USAspending awards in one feed. Keyword, NAICS, CPV, set-aside, agency, value and deadline filters; only-new alerts with webhook. No API key.", "version": "0.1", "x-build-id": "NcN3NIrc3dV6rV768" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chaptersoft~gov-contract-opportunities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chaptersoft-gov-contract-opportunities", "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/chaptersoft~gov-contract-opportunities/runs": { "post": { "operationId": "runs-sync-chaptersoft-gov-contract-opportunities", "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/chaptersoft~gov-contract-opportunities/run-sync": { "post": { "operationId": "run-sync-chaptersoft-gov-contract-opportunities", "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": { "sources": { "title": "Sources", "type": "array", "description": "Where to search. SAM.gov = U.S. federal opportunities (bids, RFQs, sources sought, awards). TED = EU/EEA public tenders (all 27 EU countries + more). USAspending = newly signed U.S. federal contract awards (competitive intel).", "items": { "type": "string", "enum": [ "sam", "ted", "usaspending" ], "enumTitles": [ "SAM.gov (U.S. federal opportunities)", "TED (EU tenders)", "USAspending.gov (U.S. contract awards)" ] }, "default": [ "sam", "ted" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Words or phrases to find (any of them by default). Matched as whole words/phrases against title and description; plural forms match; end with * for a prefix (\"cyber*\"). Standard FAR/DFARS clause text and CMMC boilerplate are ignored so 'cybersecurity' doesn't match every DLA part buy. Leave empty to get everything matching the other filters.", "items": { "type": "string" } }, "keywordMode": { "title": "Keyword logic", "enum": [ "any", "all" ], "type": "string", "description": "Match notices containing any or all of the keywords.", "default": "any" }, "keywordScope": { "title": "Where keywords must appear", "enum": [ "titleAndDescription", "title" ], "type": "string", "description": "Title only gives fewer, highly relevant results.", "default": "titleAndDescription" }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop notices whose title or description contains any of these.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Leave empty for all types. Tip: [\"solicitation\",\"sources-sought\",\"presolicitation\"] = only things you can still bid on.", "items": { "type": "string", "enum": [ "presolicitation", "solicitation", "sources-sought", "special-notice", "award", "justification", "intent-to-bundle", "surplus-sale", "modification", "other" ], "enumTitles": [ "Presolicitation / prior information", "Solicitation / contract notice (open bids)", "Sources sought / RFI", "Special notice", "Award", "Justification / VEAT", "Intent to bundle", "Surplus sale", "Modification / corrigendum", "Other" ] } }, "naicsCodes": { "title": "NAICS codes (U.S.)", "type": "array", "description": "SAM.gov/USAspending NAICS codes or prefixes (\"5415\" = all computer systems design).", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes (U.S.)", "type": "array", "description": "Product/service codes or prefixes, e.g. \"D3\" (IT services) or \"R425\".", "items": { "type": "string" } }, "setAsides": { "title": "Set-asides (SAM.gov)", "type": "array", "description": "Small-business set-aside codes or names: SBA (Total Small Business), SBP (Partial), 8A, 8AN (8(a) sole source), HZC (HUBZone), HZS, SDVOSBC (Service-Disabled Veteran-Owned), SDVOSBS, WOSB, WOSBSS, EDWOSB, EDWOSBSS, VSA, VSS, ISBEE, IEE.", "items": { "type": "string" } }, "states": { "title": "Place of performance states (U.S.)", "type": "array", "description": "2-letter state codes, e.g. TX, VA, DC.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes (EU)", "type": "array", "description": "TED CPV codes or prefixes, e.g. \"72000000\" (IT services) or \"722\" (software programming/consultancy). Trailing zeros are treated as a prefix.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries (EU)", "type": "array", "description": "ISO country codes for TED buyers, e.g. DE, FR, IE, NL (or DEU, FRA).", "items": { "type": "string" } }, "language": { "title": "Preferred language for TED text", "type": "string", "description": "3-letter code (eng, fra, deu, spa…). Falls back to English, then the original language.", "default": "eng" }, "agencies": { "title": "Agencies / buyers", "type": "array", "description": "Only notices from these buyers (all significant words must appear, any order): \"Veterans Affairs\", \"Air Force\", \"Bundeswehr\".", "items": { "type": "string" } }, "minValueUsd": { "title": "Minimum value (USD)", "minimum": 0, "type": "integer", "description": "Estimated or awarded value, converted to USD with the daily ECB rate." }, "maxValueUsd": { "title": "Maximum value (USD)", "minimum": 0, "type": "integer", "description": "Upper value limit in USD." }, "includeWithoutValue": { "title": "Keep notices without a published value", "type": "boolean", "description": "Most SAM.gov solicitations publish no value. Turn off to only get notices with a value inside your range.", "default": true }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Look back this many days. With since-last-run on, a missed schedule is caught up automatically (up to 90 days).", "default": 7 }, "postedFrom": { "title": "Posted from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Exact start date (overrides 'Posted within')." }, "postedTo": { "title": "Posted to", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Exact end date (default today)." }, "awardsLookbackDays": { "title": "USAspending look-back (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Federal award data is reported with a lag (DoD up to 90 days), so awards use a longer window. Since-last-run makes sure you never pay twice.", "default": 30 }, "openOnly": { "title": "Only open opportunities", "type": "boolean", "description": "Skip opportunities whose response deadline has passed or that were cancelled (awards are always kept).", "default": true }, "deadlineFrom": { "title": "Deadline on/after", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only opportunities due on or after this date." }, "deadlineTo": { "title": "Deadline on/before", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only opportunities due on or before this date." }, "sinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Remembers what you already received (per search) so scheduled runs only deliver — and charge for — new notices. Changed notices (new deadline, amendment, award) come as free 'update' rows.", "default": true }, "includeUpdates": { "title": "Send free update rows", "type": "boolean", "description": "When a notice you already received changes (deadline moved, amended, cancelled), add a free row explaining what changed.", "default": true }, "firstRunMode": { "title": "First run", "enum": [ "emitAll", "baseline" ], "type": "string", "description": "Baseline marks everything existing as seen for free, so a new schedule starts with only fresh notices.", "default": "emitAll" }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Optional name for this monitor's memory (letters, digits, -_.). Default: derived from your filters. Use different names to run independent monitors." }, "notifyWebhookUrl": { "title": "Webhook alert URL", "type": "string", "description": "Optional https URL (Slack/Discord incoming webhook, Teams, Zapier, Make or your API). Receives a message only when there are new notices or updates." }, "maxResults": { "title": "Max new notices per run", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Newest first. You only pay for rows saved; also respects your max cost per run.", "default": 200 }, "fetchDetails": { "title": "Fetch full SAM.gov details", "type": "boolean", "description": "Full description, NAICS, set-aside, contacts, place of performance, award info. Recommended (and needed for exact keyword matching).", "default": true }, "includeAttachments": { "title": "List SAM.gov attachments", "type": "boolean", "description": "Attachment names, sizes and public download links (free).", "default": true }, "downloadAttachments": { "title": "Download attachments", "type": "boolean", "description": "Save public SAM.gov files to the run's key-value store (charged per file). Controlled/export-restricted files are listed but never downloaded.", "default": false }, "maxAttachmentSizeMb": { "title": "Max attachment size (MB)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Larger files are listed but not downloaded.", "default": 25 }, "descriptionMaxChars": { "title": "Description length", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Truncate descriptions to this many characters (0 = omit).", "default": 5000 }, "includeNoMatchRows": { "title": "Explain empty results", "type": "boolean", "description": "Add a free row per source when nothing new matched, with the main filter reasons.", "default": true }, "noticeIds": { "title": "Look up specific notices", "type": "array", "description": "Instead of searching, fetch these: SAM.gov notice IDs or solicitation numbers, TED publication numbers (e.g. 747022-2026).", "items": { "type": "string" } }, "samApiKey": { "title": "SAM.gov API key (optional)", "type": "string", "description": "Not needed. Only used as a fallback if SAM.gov's public search is unavailable. Free key from sam.gov → Account Details." } } }, "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 } } } } } } } } } }