{ "openapi": "3.0.1", "info": { "title": "TenderFeed: US Federal Contract Awards (USAspending.gov API)", "description": "Track US federal contract awards and winners from USAspending.gov: NAICS, PSC, agency, set-aside, competitor, amount. Offers, options value, recompete dates. No API key. MCP-ready.", "version": "1.3", "x-build-id": "dMRO2ebeC4dF9Tezg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenderfeed~usaspending-contract-awards/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenderfeed-usaspending-contract-awards", "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/tenderfeed~usaspending-contract-awards/runs": { "post": { "operationId": "runs-sync-tenderfeed-usaspending-contract-awards", "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/tenderfeed~usaspending-contract-awards/run-sync": { "post": { "operationId": "run-sync-tenderfeed-usaspending-contract-awards", "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": "Keywords", "type": "array", "description": "Words or phrases searched in the award description (USAspending keyword search, min. 3 characters). Leave empty for all awards.", "items": { "type": "string" } }, "keywordMode": { "title": "Keyword match", "enum": [ "any", "all" ], "type": "string", "description": "ANY keyword (server-side) or ALL keywords.", "default": "any" }, "awardTypes": { "title": "Award types", "type": "array", "description": "Contracts = money actually awarded. IDVs = vehicles under which agencies later place orders.", "items": { "type": "string", "enum": [ "contracts", "idvs" ], "enumTitles": [ "Contracts (definitive contracts, purchase orders, delivery/task orders, BPA calls)", "IDVs (IDIQs, GWACs, Federal Supply Schedules, BPAs, BOAs)" ] }, "default": [ "contracts" ] }, "dateType": { "title": "Date filter applies to", "enum": [ "new_awards_only", "action_date", "date_signed", "last_modified_date" ], "type": "string", "description": "How the date window below is applied.", "default": "new_awards_only" }, "dateFrom": { "title": "From date", "type": "string", "description": "YYYY-MM-DD or relative (e.g. \"30 days\"). Default: last 7 days. Earliest supported: 2007-10-01." }, "dateTo": { "title": "To date", "type": "string", "description": "YYYY-MM-DD. Default: today." }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "2-6 digit NAICS codes or prefixes, e.g. 5415 (computer systems design), 236 (building construction), 541330.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC (product/service) codes", "type": "array", "description": "4-character PSC codes (e.g. DA01) or prefixes (e.g. D = IT services, R4 = professional support). Prefixes are matched on the results.", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies (top tier)", "type": "array", "description": "Exact top-tier names, e.g. Department of Veterans Affairs, Department of Homeland Security, General Services Administration, Department of Defense.", "items": { "type": "string" } }, "awardingSubAgencies": { "title": "Awarding sub-agencies", "type": "array", "description": "Exact sub-tier names, e.g. Department of the Army, National Aeronautics and Space Administration, Federal Acquisition Service.", "items": { "type": "string" } }, "recipients": { "title": "Recipient (winner) name or UEI", "type": "array", "description": "Track a competitor or partner: company names or UEIs, e.g. Booz Allen Hamilton.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance (US states)", "type": "array", "description": "2-letter state codes, e.g. VA, MD, TX.", "items": { "type": "string" } }, "setAsideTypes": { "title": "Set-aside types", "type": "array", "description": "Only awards made under these set-asides.", "items": { "type": "string", "enum": [ "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "VSA", "VSS", "ISBEE", "BI", "IEE" ], "enumTitles": [ "Small business (total)", "Small business (partial)", "8(a) competed", "8(a) sole source", "HUBZone", "HUBZone sole source", "Service-disabled veteran-owned (SDVOSB)", "SDVOSB sole source", "Women-owned small business (WOSB)", "WOSB sole source", "Economically disadvantaged WOSB", "EDWOSB sole source", "Veteran set-aside", "Veteran sole source", "Indian small business economic enterprise", "Buy Indian", "Indian economic enterprise" ] } }, "extentCompeted": { "title": "Extent competed", "type": "array", "description": "Filter by how the award was competed (e.g. find sole-source awards).", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "CDO", "NDO" ], "enumTitles": [ "Full and open competition", "Not available for competition", "Not competed", "Full and open after exclusion of sources", "Follow on to competed action", "Competed under SAP", "Not competed under SAP", "Competitive delivery order", "Non-competitive delivery order" ] } }, "minAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Obligated amount filter." }, "maxAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Obligated amount upper bound." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "largest", "recentlyModified" ], "type": "string", "description": "Order in which awards are fetched (matters when Max results is set).", "default": "newest" }, "fetchDetails": { "title": "Fetch full award details", "type": "boolean", "description": "Adds set-aside, number of offers, extent competed, solicitation ID, pricing type, value incl. all options, potential end date (recompete timing), awarding office, parent company and business categories. One extra API call per award.", "default": true }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of awards to save. 0 = no limit.", "default": 100 }, "onlyNew": { "title": "Only new awards (monitoring mode)", "type": "boolean", "description": "Remember what earlier runs delivered and return (and charge for) only awards you have not received yet. Ideal for scheduled daily award alerts.", "default": false }, "monitoringId": { "title": "Monitoring ID", "type": "string", "description": "Name of the watch-list memory used by 'Only new'. Use a different ID per saved search/schedule." }, "includeRawData": { "title": "Include raw USAspending data", "type": "boolean", "description": "Adds the original search row under `raw`.", "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 } } } } } } } } } }