{ "openapi": "3.0.1", "info": { "title": "US Federal Contracts & Grants — USAspending.gov", "description": "New US federal contracts, IDVs and grants to companies and organizations from the official USAspending.gov API. Filter by keyword, NAICS, PSC, agency, state, date and amount; get only new awards on each run. Clean flat rows with links. Pay per award.", "version": "0.1", "x-build-id": "RmCG8CpnzAUeQFghJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nefes-tools~us-federal-awards/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nefes-tools-us-federal-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/nefes-tools~us-federal-awards/runs": { "post": { "operationId": "runs-sync-nefes-tools-us-federal-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/nefes-tools~us-federal-awards/run-sync": { "post": { "operationId": "run-sync-nefes-tools-us-federal-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": { "awardTypes": { "title": "Award types", "type": "array", "description": "Contracts = definitive contracts, purchase orders, delivery/task orders and BPA calls. IDVs = indefinite delivery vehicles (IDIQs, GWACs, Federal Supply Schedules, BPAs) that later receive orders. Grants = block, formula and project grants and cooperative agreements to organizations.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants" ], "enumTitles": [ "Contracts", "IDVs (IDIQ, GWAC, schedules, BPAs)", "Grants (to organizations)" ] }, "default": [ "contracts" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Full-text search in the award description, recipient and codes (any word matches, min. 3 characters). Leave empty for all awards.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Industry codes, 2–6 digits. Shorter codes include all sub-industries: \"5415\" = all computer systems design services. Contracts and IDVs only.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product and Service Codes, 1–4 characters. Shorter codes include the whole group: \"D\" = all IT services, \"DA\" = IT applications, \"R4\" = professional support. Contracts and IDVs only.", "items": { "type": "string" } }, "assistanceListings": { "title": "Assistance listings (grants)", "type": "array", "description": "Grant program numbers (formerly CFDA), e.g. \"93.855\" (NIH allergy and infectious diseases research) or \"20.205\" (highway planning and construction). Grants only.", "items": { "type": "string" } }, "agencies": { "title": "Agencies", "type": "array", "description": "Federal agencies by full name or abbreviation: \"Department of Defense\", \"DOD\", \"NASA\", \"VA\", \"DHS\", and sub-agencies such as \"FEMA\" or \"Department of the Army\". Unknown names are reported in the log.", "items": { "type": "string" } }, "agencyRole": { "title": "Agency role", "enum": [ "awarding", "funding" ], "type": "string", "description": "Match the agency that awarded the contract (usual) or the one that paid for it.", "default": "awarding" }, "states": { "title": "US states", "type": "array", "description": "2-letter state or territory codes (VA, TX, CA, DC, PR…). Leave empty for all.", "items": { "type": "string" } }, "stateMatch": { "title": "State means", "enum": [ "performance", "recipient" ], "type": "string", "description": "Filter states by where the work is performed or by where the recipient company is located.", "default": "performance" }, "recipients": { "title": "Recipient companies", "type": "array", "description": "Only awards to these companies: name (part of it) or UEI, e.g. \"Lockheed Martin\", \"Booz Allen\". Useful for competitor tracking.", "items": { "type": "string" } }, "dateType": { "title": "Which date to filter on", "enum": [ "new", "activity", "modified" ], "type": "string", "description": "New awards = awards whose first (base) action falls in the date range (best for leads and alerts). Any activity = awards with any action in the range, including modifications of older awards. Last modified = records updated in the range.", "default": "new" }, "daysBack": { "title": "Last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "How far back to look. Ignored when \"Date from\" is set. Agencies report contracts within days, grants often later, so for daily alerts keep 7–14 days together with \"Only new since the last run\".", "default": 7 }, "dateFrom": { "title": "Date from", "type": "string", "description": "Optional start date (YYYY-MM-DD). Overrides \"Last N days\". Earliest possible: 2007-10-01." }, "dateTo": { "title": "Date to", "type": "string", "description": "Optional end date (YYYY-MM-DD), inclusive. Default: today." }, "minAmount": { "title": "Minimum amount (USD)", "minimum": 0, "type": "integer", "description": "Only awards worth at least this much (obligated amount for contracts and grants; for IDVs usually the obligated amount of the base award, often 0)." }, "maxAmount": { "title": "Maximum amount (USD)", "minimum": 0, "type": "integer", "description": "Only awards worth at most this much." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "largest" ], "type": "string", "description": "Newest first or largest first. With a limit, this decides which awards you get.", "default": "newest" }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "Remember delivered awards and return only new ones next time (per combination of filters). Ideal for a daily schedule: you pay only for awards you have not seen.", "default": false }, "maxResults": { "title": "Max awards", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many awards (each award is one charged result).", "default": 100 } } }, "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 } } } } } } } } } }