{
  "openapi": "3.0.1",
  "info": {
    "title": "Federal Contract Awards: Who Won and for How Much",
    "description": "See who just won US federal contracts, for how much, and from which agency. Filter by keyword, NAICS or PSC code, state, agency, set-aside or company name. Official USAspending.gov data, no API key. Use it for pricing research, teaming partners and competitor tracking.",
    "version": "0.1",
    "x-build-id": "MMKnxtbAbFteXjxG8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datapenguin~federal-contract-awards/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datapenguin-federal-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/datapenguin~federal-contract-awards/runs": {
      "post": {
        "operationId": "runs-sync-datapenguin-federal-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/datapenguin~federal-contract-awards/run-sync": {
      "post": {
        "operationId": "run-sync-datapenguin-federal-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 to look for in the award description and other award text, for example \"janitorial\" or \"roofing\". An award matches if it contains any of them. Leave empty for any.",
            "items": {
              "type": "string"
            }
          },
          "naicsCodes": {
            "title": "NAICS codes",
            "type": "array",
            "description": "Industry codes. Use a full six-digit code like 561720, or the first digits to cover a group: 5617 matches every code starting with 5617, and 23 matches all construction. Leave empty for any.",
            "items": {
              "type": "string"
            }
          },
          "pscCodes": {
            "title": "Product and service codes (PSC)",
            "type": "array",
            "description": "Exact four-character federal product and service codes, such as S201 for custodial services. Leave empty for any.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Two-letter codes for the state where the work is done, such as TX or VA. Leave empty for any state.",
            "items": {
              "type": "string"
            }
          },
          "agencies": {
            "title": "Awarding agencies",
            "type": "array",
            "description": "Only awards made by these departments or agencies. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "Department of Defense",
                "Department of Veterans Affairs",
                "Department of Health and Human Services",
                "Department of Homeland Security",
                "General Services Administration",
                "Department of Energy",
                "National Aeronautics and Space Administration",
                "Department of Justice",
                "Department of Agriculture",
                "Department of the Interior",
                "Department of State",
                "Department of Transportation",
                "Department of the Treasury",
                "Department of Commerce",
                "Department of Labor",
                "Department of Education",
                "Department of Housing and Urban Development",
                "Environmental Protection Agency",
                "Small Business Administration",
                "Social Security Administration",
                "Agency for International Development",
                "Nuclear Regulatory Commission",
                "Office of Personnel Management"
              ]
            }
          },
          "setAsides": {
            "title": "Set-aside programs",
            "type": "array",
            "description": "Only awards that were reserved for these programs, for example small business or service-disabled veteran-owned. Leave empty for any.",
            "items": {
              "type": "string",
              "enum": [
                "SBA",
                "SBP",
                "8A",
                "8AN",
                "HZC",
                "HZS",
                "SDVOSBC",
                "SDVOSBS",
                "WOSB",
                "WOSBSS",
                "EDWOSB",
                "EDWOSBSS",
                "VSA",
                "VSS"
              ],
              "enumTitles": [
                "Total small business set-aside (SBA)",
                "Partial small business set-aside (SBP)",
                "8(a) set-aside (8A)",
                "8(a) sole source (8AN)",
                "HUBZone set-aside (HZC)",
                "HUBZone sole source (HZS)",
                "Service-disabled veteran-owned set-aside (SDVOSBC)",
                "Service-disabled veteran-owned sole source (SDVOSBS)",
                "Women-owned small business set-aside (WOSB)",
                "Women-owned small business sole source (WOSBSS)",
                "Economically disadvantaged women-owned set-aside (EDWOSB)",
                "Economically disadvantaged women-owned sole source (EDWOSBSS)",
                "Veteran-owned small business set-aside (VA) (VSA)",
                "Veteran-owned small business sole source (VA) (VSS)"
              ]
            }
          },
          "recipientName": {
            "title": "Winning company name",
            "type": "string",
            "description": "Part of a company name to see only that company's awards, for example \"booz allen\". Leave empty for any company."
          },
          "awardedWithinDays": {
            "title": "Awarded within the last (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "How far back to look. Most awards show up within a few days of signing. Defense awards are published about 90 days late, so use 120 or more for them.",
            "default": 30
          },
          "minAmount": {
            "title": "Minimum award amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only awards worth at least this much, for example 100000. Leave at 0 for any amount.",
            "default": 0
          },
          "newAwardsOnly": {
            "title": "New awards only",
            "type": "boolean",
            "description": "Only contracts first signed in this window. Turn off to also include changes to older contracts, such as option years and extensions.",
            "default": true
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "date",
              "amount"
            ],
            "type": "string",
            "description": "Order of the results.",
            "default": "date"
          },
          "onlyNew": {
            "title": "Only awards I have not seen yet",
            "type": "boolean",
            "description": "Remembers what earlier runs with the same filters returned and skips it. Use this with a daily or weekly schedule.",
            "default": false
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "The most awards to return. You are charged per award, so this also caps what a run can cost.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}