Raw schema
{
"type": "object",
"properties": {
"tradelines": {
"type": "array",
"items": {
"type": "string"
},
"description": "Trade ids or any alias from list_tradelines: e.g. lowvoltage, \"access control\", \"badge readers\", \"structured cabling\", roofing. Omit for all trades."
},
"q": {
"type": "string",
"description": "Keywords (full-text over title and description)."
},
"specialties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Your specialties, e.g. [\"access control\", \"surveillance cameras\", \"fire alarm\"]. Never filters: all matches stay; those naming a specialty in the title (2) or description (1) come first, each row lists specialty_matches."
},
"states": {
"type": "array",
"items": {
"type": "string"
},
"description": "Two-letter states, e.g. [\"CA\"]. Matched on the job location (place of performance, service area, buyer state, CalProcure=CA); each result carries a location object with its basis."
},
"city": {
"type": "string",
"maxLength": 80,
"description": "A city (needs states). Keeps only rows tied to it; each row says how in location_match: work_site (place of performance), named_in_title, service_area (needs county), mentioned_in_description (work site not confirmed) or buyer_only (only the buyer's name/office; not the work site)."
},
"county": {
"type": "string",
"maxLength": 80,
"description": "A county name without 'County' (needs states), e.g. \"Riverside\". Matches the record's service area or a county named in the title (service_area) or description (mentioned_in_description)."
},
"location_match": {
"type": "array",
"items": {
"type": "string",
"enum": [
"work_site",
"named_in_title",
"service_area",
"mentioned_in_description",
"buyer_only"
]
},
"description": "Keep only these location tiers (needs city or county). Default: all five."
},
"tradeline_match": {
"type": "string",
"enum": [
"validated",
"loose"
],
"description": "validated (default): a trade matches only with NAICS/PSC or text evidence for that trade; loose: tag only (noisier)."
},
"agencies": {
"type": "array",
"items": {
"type": "string"
},
"description": "Agency name fragments, e.g. [\"Sacramento\", \"SMUD\"]."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Restrict to sources: sam.gov, dibbs, calprocure, opengov, planetbids, publicpurchase, bonfire, instantmarkets."
},
"set_asides": {
"type": "array",
"items": {
"type": "string"
},
"description": "Set-aside programs from list_set_asides: small_business, 8a, hubzone, sdvosb, wosb, isbee, california_sb_dvbe, open, or any alias (\"8(a)\", \"HUBZone\", \"DVBE\"). Results carry set_aside_basis: designated (the source marked it) or mentioned (title language only). Not an eligibility determination."
},
"due_within_days": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Only opportunities closing within N days."
},
"open": {
"type": "boolean",
"description": "Default true: only opportunities that are still open. false also returns closed and past-deadline solicitations."
},
"sort": {
"type": "string",
"enum": [
"deadline",
"relevance"
]
},
"page": {
"type": "integer",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Results per page (default 25). 0 = counts and facets only. Trial max 25, paid max 100; above the plan max is a 400."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}