Getting Started
Enterprise
- Onboarding
- Enterprise API Reference
- Legacy API Reference (v2/v3)
Execute a search on a saved search
Search opportunities using a saved search query
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'
{
"results": [
{
"id": "<string>",
"aiEstimatedValueMax": 123,
"aiEstimatedValueMin": 123,
"aiLineItems": {
"products": [
{
"vendor": "<string>",
"product": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
],
"services": [
{
"vendor": "<string>",
"service": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
]
},
"aiPeriodOfPerformance": "<string>",
"aiRawCompetingProducts": [
"<string>"
],
"aiRawCompetingVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiRawProducts": [
"<string>"
],
"aiRawVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiSummary": "<string>",
"aiTitle": "<string>",
"attachments": [
{
"checksum": "<string>",
"filename": "<string>",
"url": "<string>"
}
],
"buyer": {
"id": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"name": "<string>"
},
"contractVehicle": "<string>",
"displayName": "<string>",
"externalIdentifier": "<string>",
"identifier": "<string>",
"lastSummarizedAt": "<string>",
"uniqueKey": "<string>",
"url": "<string>",
"modifiedAt": "<string>",
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}
Request
ID of the saved search to execute
Number of results per page (max: 100)
Page number for pagination
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 for results (‘asc’ or ‘desc’, default: falls back to saved search sort direction)
Start date for filtering results (ISO 8601 format, default: 1 day ago)
End date for filtering results (ISO 8601 format, default: current date)
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
Array of opportunity objects matching the search criteria
Unique identifier for the opportunity
Maximum estimated value of the opportunity in USD
Minimum estimated value of the opportunity in USD
Structured breakdown of products and services mentioned in the opportunity
Description of the performance period for the opportunity
Array of competing product names identified in the opportunity
Array of primary product names mentioned in the opportunity
AI-generated summary of the opportunity
AI-generated descriptive title
Contract vehicle being used for the opportunity
Human-readable identifier for the opportunity
External reference number for the opportunity
Internal reference number
ISO 8601 timestamp of when the opportunity was last processed by AI
Unique identifier key for the opportunity
Web URL for viewing the opportunity
ISO 8601 timestamp of the last modification
Object containing highlighted text snippets from fields that matched the saved search criteria
Array of text snippets from the field containing highlighted matches. The field name will be the name of the field that contained matches (e.g., ‘title’, ‘description’, etc.)
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'
{
"results": [
{
"id": "<string>",
"aiEstimatedValueMax": 123,
"aiEstimatedValueMin": 123,
"aiLineItems": {
"products": [
{
"vendor": "<string>",
"product": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
],
"services": [
{
"vendor": "<string>",
"service": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
]
},
"aiPeriodOfPerformance": "<string>",
"aiRawCompetingProducts": [
"<string>"
],
"aiRawCompetingVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiRawProducts": [
"<string>"
],
"aiRawVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiSummary": "<string>",
"aiTitle": "<string>",
"attachments": [
{
"checksum": "<string>",
"filename": "<string>",
"url": "<string>"
}
],
"buyer": {
"id": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"name": "<string>"
},
"contractVehicle": "<string>",
"displayName": "<string>",
"externalIdentifier": "<string>",
"identifier": "<string>",
"lastSummarizedAt": "<string>",
"uniqueKey": "<string>",
"url": "<string>",
"modifiedAt": "<string>",
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}