Skip to main content
GET
https://app.govly.com
/
api
/
enterprise
/
opportunities
/
saved_searches
/
{id}
/
search
Execute a search on a saved search
curl --request GET \
  --url https://app.govly.com/api/enterprise/opportunities/saved_searches/{id}/search \
  --header 'X-API-KEY: <api-key>'
{
  "results": [
    {
      "id": "<string>",
      "title": "<string>",
      "uniqueKey": "<string>",
      "externalIdentifier": "<string>",
      "url": "<string>",
      "apiUrl": "<string>",
      "externalUrl": "<string>",
      "postedAt": "<string>",
      "modifiedAt": "<string>",
      "respondBy": "<string>",
      "lastSummarizedAt": "<string>",
      "recordType": "<string>",
      "jurisdiction": "<string>",
      "isoCode": "<string>",
      "contractVehicle": "<string>",
      "aiTitle": "<string>",
      "aiSummary": "<string>",
      "aiShortSummary": "<string>",
      "aiEstimatedValueMin": 123,
      "aiEstimatedValueMax": 123,
      "aiPeriodOfPerformance": "<string>",
      "aiLineItems": {
        "products": [
          {
            "vendor": "<string>",
            "product": "<string>",
            "quantity": 123,
            "description": "<string>",
            "partNumber": "<string>"
          }
        ],
        "services": [
          {
            "vendor": "<string>",
            "service": "<string>",
            "quantity": 123,
            "description": "<string>",
            "partNumber": "<string>"
          }
        ]
      },
      "aiRawProducts": [
        "<string>"
      ],
      "aiRawVendors": [
        {
          "name": "<string>",
          "website": "<string>"
        }
      ],
      "aiRawCompetingProducts": [
        "<string>"
      ],
      "aiRawCompetingVendors": [
        {
          "name": "<string>",
          "website": "<string>"
        }
      ],
      "description": "<string>",
      "latestModificationReason": "<string>",
      "productCategoryTags": [
        "<string>"
      ],
      "majorEndItem": "<string>",
      "contactName": "<string>",
      "contactEmail": "<string>",
      "contactPhoneNumber": "<string>",
      "address": "<string>",
      "buyer": {
        "id": "<string>",
        "name": "<string>",
        "hierarchy": [
          "<string>"
        ],
        "hierarchyIds": [
          "<string>"
        ]
      },
      "attachments": [
        {
          "checksum": "<string>",
          "filename": "<string>",
          "url": "<string>"
        }
      ],
      "sources": [
        {
          "id": "<string>",
          "noticeType": "<string>",
          "recordType": "<string>",
          "digest": "<string>",
          "externalUrl": "<string>",
          "createdAt": "<string>",
          "postedAt": "<string>",
          "noBidAt": "<string>",
          "hasJustification": true,
          "hasEvent": true,
          "modificationReason": "<string>",
          "attachmentChecksums": [
            "<string>"
          ],
          "rawEmail": "<string>",
          "providerContext": {},
          "dataSourceContext": {
            "emailMessageChecksum": "<string>",
            "rawNoticeType": "<string>",
            "rawSetAside": "<string>"
          }
        }
      ],
      "highlights": {
        "[field_name]": [
          "<string>"
        ]
      }
    }
  ],
  "meta": {
    "currentPage": 123,
    "per": 123,
    "total": 123,
    "totalPages": 123
  }
}

Request

id
string
required
ID of the saved search to execute
per
integer
default:50
Number of results per page (max: 100)
page
integer
default:1
Page number for pagination
sort
string
Which date field to use for sorting. Must be one of: ‘relevance’, ‘posted_at’, ‘modified_at’ or ‘respond_by’. Default: falls back to saved search date range parameter
sort_direction
string
default:"desc"
Sort direction for results (‘asc’ or ‘desc’, default: falls back to saved search sort direction)
start_date
string
Start date for filtering results (ISO 8601 format, default: 1 day ago)
end_date
string
End date for filtering results (ISO 8601 format, default: current date)
date_range_param
string
Which date field to use for date range filtering. Must be one of: ‘posted_at’, ‘modified_at’, or ‘respond_by’. Default: falls back to saved search date range parameter

Response

results
array
Array of opportunity objects matching the search criteria
meta
object
Pagination metadata