{ "openapi": "3.0.1", "info": { "title": "USAspending Awards Search: Federal Contracts and IDVs", "description": "Search US federal contracts and contract vehicles (IDVs) by keyword, recipient, agency, date, amount, state and NAICS code. Get flat rows with recipient, amount, agency, dates, NAICS and PSC codes. Public data, $4.00 per 1,000 awards.", "version": "1.0", "x-build-id": "bj1fdc91nKVf7youh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/conserving_celerytop~usaspending-awards-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-conserving_celerytop-usaspending-awards-api", "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/conserving_celerytop~usaspending-awards-api/runs": { "post": { "operationId": "runs-sync-conserving_celerytop-usaspending-awards-api", "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/conserving_celerytop~usaspending-awards-api/run-sync": { "post": { "operationId": "run-sync-conserving_celerytop-usaspending-awards-api", "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": { "awardCategory": { "title": "Award category", "enum": [ "contracts", "contract_idvs" ], "type": "string", "description": "Choose the kind of award to search. One run searches one category. Only contracts and IDVs are covered; assistance awards are excluded.", "default": "contracts" }, "keywords": { "title": "Keywords", "type": "array", "description": "Add words or phrases to find in award descriptions, one per entry. Awards that match any entry are returned. Each entry needs 3 or more characters.", "items": { "type": "string" } }, "recipients": { "title": "Recipients", "type": "array", "description": "Add recipient names or UEI codes, one per entry, for example LOCKHEED MARTIN or SZPJL5ZRCLF4. Awards to any entry are returned.", "items": { "type": "string" } }, "awardingAgency": { "title": "Awarding agency", "maxLength": 150, "type": "string", "description": "Enter a federal agency name or abbreviation, for example Department of Defense or DOD." }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Enter the first day of the period as YYYY-MM-DD, for example 2025-10-01. The earliest date is 2007-10-01." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Enter the last day of the period as YYYY-MM-DD, for example 2026-09-30." }, "maxItems": { "title": "Maximum awards", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Set how many awards to return, from 1 to 10,000. Each saved award is one charged result.", "default": 100 }, "dateType": { "title": "Date type", "enum": [ "new_awards_only", "action_date", "last_modified_date" ], "type": "string", "description": "Choose which date the start and end dates apply to. The signing date returns awards first signed in the period.", "default": "new_awards_only" }, "minAmount": { "title": "Minimum amount (USD)", "minimum": 0, "type": "number", "description": "Enter the lowest award amount in US dollars, for example 1000000." }, "maxAmount": { "title": "Maximum amount (USD)", "minimum": 0, "type": "number", "description": "Enter the highest award amount in US dollars, for example 5000000." }, "performanceStates": { "title": "Place of performance states", "type": "array", "description": "Add two-letter state or territory codes where the work happens, for example VA or TX.", "items": { "type": "string" } }, "recipientStates": { "title": "Recipient states", "type": "array", "description": "Add two-letter state or territory codes of the recipient address, for example CA or NY.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Add industry codes of 2 to 6 digits, for example 541512.", "items": { "type": "string" } }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "Return only items that this monitor has not delivered before. The first run returns everything and becomes the baseline. Use it with a daily schedule.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Names the memory of this monitor. Use one name per saved task, so two tasks never share their memory.", "default": "default" }, "sortBy": { "title": "Sort by", "enum": [ "amount", "startDate", "lastModified", "recipientName" ], "type": "string", "description": "Choose the column that orders the rows.", "default": "amount" }, "sortOrder": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Choose the direction of the sort.", "default": "desc" } } }, "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 } } } } } } } } } }