{
  "openapi": "3.0.1",
  "info": {
    "title": "BidNet Direct Scraper | US Government Bids & RFPs",
    "description": "Scrape US government bids and RFPs from BidNet Direct. Search open or closed solicitations by keyword, state, category, agency type and publish date. Get title, state, buyer, dates, AI overview and public details. Monitor only new bids.",
    "version": "1.0",
    "x-build-id": "XYVhW0u6AdbFeUsCt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trev0n~bidnet-direct-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trev0n-bidnet-direct-scraper",
        "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/trev0n~bidnet-direct-scraper/runs": {
      "post": {
        "operationId": "runs-sync-trev0n-bidnet-direct-scraper",
        "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/trev0n~bidnet-direct-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-trev0n-bidnet-direct-scraper",
        "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": "One search per keyword, matched against the bid title and text (e.g. roofing, janitorial, software). Leave empty to list every bid that matches the filters below.",
            "items": {
              "type": "string"
            }
          },
          "status": {
            "title": "📂 Bid status",
            "enum": [
              "open",
              "closed"
            ],
            "type": "string",
            "description": "Open bids are still accepting responses. Closed bids are past solicitations and include the buyer name.",
            "default": "open"
          },
          "states": {
            "title": "🗺️ States",
            "type": "array",
            "description": "Only bids from these states or territories. Leave empty for the whole US.",
            "items": {
              "type": "string",
              "enum": [
                "AL",
                "AK",
                "AZ",
                "AR",
                "CA",
                "CO",
                "CT",
                "DE",
                "DC",
                "FL",
                "GA",
                "GU",
                "HI",
                "ID",
                "IL",
                "IN",
                "IA",
                "KS",
                "KY",
                "LA",
                "ME",
                "MD",
                "MA",
                "MI",
                "MN",
                "MS",
                "MO",
                "MT",
                "NE",
                "NV",
                "NH",
                "NJ",
                "NM",
                "NY",
                "NC",
                "ND",
                "NS",
                "OH",
                "OK",
                "OR",
                "PA",
                "PR",
                "RI",
                "SC",
                "SD",
                "TN",
                "TX",
                "VI",
                "UT",
                "VT",
                "VA",
                "WA",
                "WV",
                "WI",
                "WY"
              ],
              "enumTitles": [
                "Alabama",
                "Alaska",
                "Arizona",
                "Arkansas",
                "California",
                "Colorado",
                "Connecticut",
                "Delaware",
                "District of Columbia",
                "Florida",
                "Georgia",
                "Guam",
                "Hawaii",
                "Idaho",
                "Illinois",
                "Indiana",
                "Iowa",
                "Kansas",
                "Kentucky",
                "Louisiana",
                "Maine",
                "Maryland",
                "Massachusetts",
                "Michigan",
                "Minnesota",
                "Mississippi",
                "Missouri",
                "Montana",
                "Nebraska",
                "Nevada",
                "New Hampshire",
                "New Jersey",
                "New Mexico",
                "New York",
                "North Carolina",
                "North Dakota",
                "Not Stated",
                "Ohio",
                "Oklahoma",
                "Oregon",
                "Pennsylvania",
                "Puerto Rico",
                "Rhode Island",
                "South Carolina",
                "South Dakota",
                "Tennessee",
                "Texas",
                "US Virgin Islands",
                "Utah",
                "Vermont",
                "Virginia",
                "Washington",
                "West Virginia",
                "Wisconsin",
                "Wyoming"
              ]
            }
          },
          "categories": {
            "title": "🏷️ Categories",
            "type": "array",
            "description": "Only bids in these industry categories (NAICS sectors).",
            "items": {
              "type": "string",
              "enum": [
                "accommodation-food-services",
                "administrative-support-waste-management",
                "agriculture-forestry-fishing-hunting",
                "arts-entertainment-recreation",
                "construction",
                "educational-services",
                "finance-insurance",
                "health-care-social-assistance",
                "information",
                "management-of-companies",
                "manufacturing",
                "mining-oil-gas",
                "other-services",
                "professional-scientific-technical",
                "public-administration",
                "real-estate-rental-leasing",
                "retail-trade",
                "transportation-warehousing",
                "utilities",
                "wholesale-trade"
              ],
              "enumTitles": [
                "Accommodation and Food Services",
                "Administrative and Support and Waste Management and Remediation Services",
                "Agriculture, Forestry, Fishing and Hunting",
                "Arts, Entertainment, and Recreation",
                "Construction",
                "Educational Services",
                "Finance and Insurance",
                "Health Care and Social Assistance",
                "Information",
                "Management of Companies and Enterprises",
                "Manufacturing",
                "Mining, Quarrying, and Oil and Gas Extraction",
                "Other Services (except Public Administration)",
                "Professional, Scientific, and Technical Services",
                "Public Administration",
                "Real Estate and Rental and Leasing",
                "Retail Trade",
                "Transportation and Warehousing",
                "Utilities",
                "Wholesale Trade"
              ]
            }
          },
          "agencyType": {
            "title": "🏛️ Agency type",
            "enum": [
              "all",
              "state-local",
              "federal",
              "member"
            ],
            "type": "string",
            "description": "Only bids from this kind of buyer.",
            "default": "all"
          },
          "publishedWithin": {
            "title": "📅 Published within",
            "enum": [
              "any",
              "24h",
              "7d"
            ],
            "type": "string",
            "description": "Only bids published recently.",
            "default": "any"
          },
          "startUrls": {
            "title": "🔗 Start URLs (optional, replaces the search above)",
            "type": "array",
            "description": "Paste BidNet Direct search result pages (e.g. https://www.bidnetdirect.com/public/solicitations/open?keywords=roof) or individual bid pages. When set, the keyword and filter fields above are ignored.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "fetchDetails": {
            "title": "📄 Fetch bid details",
            "type": "boolean",
            "description": "Open every bid page for the AI overview, exact closing time with time zone and every public field (issuing organization, solicitation number and type, delivery point, description, contact, question deadline). Fields the site keeps for registered members are listed in lockedFields. One extra page per bid, so slower.",
            "default": false
          },
          "maxResults": {
            "title": "🔢 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of bids to return across all searches. 0 = no limit.",
            "default": 100
          },
          "maxPagesPerQuery": {
            "title": "📑 Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each search after this many result pages (25 bids per page). 0 = no limit.",
            "default": 0
          },
          "splitLargeSearches": {
            "title": "🧩 Split very large searches",
            "type": "boolean",
            "description": "The site shows at most 10,000 results per search. When a search is bigger, it is split automatically by state (and by category if needed) so you can get all of it.",
            "default": true
          },
          "compact": {
            "title": "🧹 Skip empty fields",
            "type": "boolean",
            "description": "Leave out fields without a value.",
            "default": false
          },
          "incremental": {
            "title": "🔔 Only new bids (monitoring)",
            "type": "boolean",
            "description": "Remember what this search returned last time and output only NEW bids (plus bids whose dates or details changed). Schedule it daily for a cheap new-bids feed. The first run returns everything and saves the baseline.",
            "default": false
          },
          "stateKey": {
            "title": "🗝️ Monitoring name",
            "type": "string",
            "description": "Optional. Name of the saved baseline. Leave empty to derive it from the search. Use a fixed name to keep the baseline when you tweak the search."
          },
          "emitUnchanged": {
            "title": "♻️ Also output unchanged bids",
            "type": "boolean",
            "description": "Monitoring only. Output bids seen before too, tagged UNCHANGED.",
            "default": false
          },
          "emitExpired": {
            "title": "⌛ Also output bids that disappeared",
            "type": "boolean",
            "description": "Monitoring only. Output bids that were in the last run but are gone now (closed, cancelled or moved), tagged EXPIRED.",
            "default": false
          },
          "maxConcurrency": {
            "title": "⚙️ Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Parallel requests.",
            "default": 2
          },
          "maxRequestsPerMinute": {
            "title": "⏱️ Max requests per minute",
            "minimum": 5,
            "maximum": 120,
            "type": "integer",
            "description": "Polite rate limit towards the site. BidNet Direct slows down visitors that request pages too fast, so keep this low for big runs.",
            "default": 30
          },
          "maxRequestRetries": {
            "title": "🔁 Max retries",
            "minimum": 0,
            "maximum": 15,
            "type": "integer",
            "description": "Retries per failed page.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy",
            "type": "object",
            "description": "The default Apify Proxy works for this site. If BidNet Direct refuses an IP address, the scraper switches to another one automatically.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}