> ## Documentation Index > Fetch the complete documentation index at: https://docs.govly.com/llms.txt > Use this file to discover all available pages before exploring further. # Search signals > Search clustered procurement and market signals (news, hearings, laws, events, analysis, policy, regulatory actions, and public meetings) with the constrained public parameter set shared by MCP search_signals. query is a fuzzy, semantic search; contentTypes, categories, and dateRange are exact filters AND-combined with query. categories is a hard filter on curated slugs and only matches tagged clusters. meta.aggregations returns facet counts on the first page only. ## OpenAPI ````yaml /openapi/tools-v1.yaml post /api/tools/v1/signals/search openapi: 3.1.0 info: title: Govly Tools API (Alpha) version: 1.0.0-alpha description: > ALPHA / UNSTABLE: This API is still in active development. Endpoint behavior, request fields, response fields, error codes, and operation names may change before the Tools API is declared stable. REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Responses are JSON for typed clients; MCP tools may render action results into text-oriented formats separately. servers: - url: https://app.govly.com security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Opportunities description: Search, fetch, and inspect Govly opportunity records. - name: Awards description: Search and inspect awarded government contracts. - name: Contacts description: Search and inspect government points of contact. - name: Signals description: Search clustered procurement and market intelligence signals. - name: Workspaces description: Create, update, and inspect opportunity workspaces. - name: Workspace Members description: Add users and teams to workspaces. - name: Workspace Attachments description: List and upload workspace attachments. - name: Workspace Comments description: Post comments to workspaces. - name: Follows description: Follow opportunities and related workspace activity. - name: Saved Searches description: List saved opportunity searches and cached matches. - name: Documents description: >- Read document representations and request temporary original-file downloads. - name: Quote Submissions description: >- Inspect quote submission requirements, submit quotes, and poll submission status. - name: Inbox description: Read and triage the authenticated user's matched inbox items. paths: /api/tools/v1/signals/search: post: tags: - Signals summary: Search signals description: > Search clustered procurement and market signals (news, hearings, laws, events, analysis, policy, regulatory actions, and public meetings) with the constrained public parameter set shared by MCP search_signals. query is a fuzzy, semantic search; contentTypes, categories, and dateRange are exact filters AND-combined with query. categories is a hard filter on curated slugs and only matches tagged clusters. meta.aggregations returns facet counts on the first page only. operationId: search_signals requestBody: required: false content: application/json: schema: type: object additionalProperties: false properties: query: type: string maxLength: 500 description: Fuzzy + semantic search text over signal content. page: type: integer default: 1 description: 1-based page number. perPage: type: integer default: 10 description: Results per page. Default 10, maximum 50. contentTypes: type: array items: type: string enum: - news - hearing - law - event - analysis - policy - regulatory - meeting description: >- Exact filter — only clusters containing signals of these content types. categories: type: array items: type: string enum: - regulatory_policy - cybersecurity - defense - technology_digital - infrastructure - healthcare_services - business_compliance description: > Exact hard filter on curated category slugs. Narrows to tagged clusters; may miss differently-tagged signals. Use for explicit narrowing, not for topics that belong in query. dateRange: type: array items: type: - string - 'null' maxItems: 2 description: >- Filter by signal date as [start, end] in ISO 8601 format. Use null for an open-ended bound (e.g. [null, end]). Omit or pass an empty array for no date filter. responses: '200': description: Matching signal clusters content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/Signal' meta: $ref: '#/components/schemas/SignalSearchMeta' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' components: schemas: Signal: type: object description: > A procurement signal cluster — a group of related signals (news, events, meetings, ...) about the same topic. Empty and null fields are omitted. required: - id properties: id: type: string name: type: string executiveSummary: type: string firstPublishedAt: type: string format: date-time latestPublishedAt: type: string format: date-time contentTypes: type: array items: type: string description: Distinct content types of the signals in this cluster. signalCount: type: integer jurisdictions: type: array items: type: string industryTags: type: array items: type: string topicTags: type: array items: type: string categories: type: array items: type: string description: Curated category slugs computed from the cluster's tags. sourceNames: type: array items: type: string signalUrl: type: string description: URL of the signal's page in the Govly app. vendors: type: array items: type: object governmentEntities: type: array items: type: object contacts: type: array items: type: object eventStartDate: type: string description: Present only for clusters containing an event signal. bodyName: type: string description: >- Meeting body name; present only for clusters containing a meeting signal. SignalSearchMeta: type: object description: Page-based pagination metadata for signal search. required: - totalCount - page - perPage - totalPages properties: totalCount: type: integer description: Total matching clusters (capped at 10,000 by the search engine). page: type: integer perPage: type: integer totalPages: type: integer query: type: - string - 'null' aggregations: $ref: '#/components/schemas/SignalSearchAggregations' SignalSearchAggregations: type: object description: > Facet counts returned on the first page only, covering the filter dimensions (`categories`, `contentTypes`) plus `jurisdictions`, which is discovery-only and has no filter input. Each entry is an array of { value, count } objects. Facets are computed from the indexed snapshot and can lag the result fields (which reflect current data), so counts may differ from what is in `data`. properties: categories: type: array items: type: object contentTypes: type: array items: type: object jurisdictions: type: array items: type: object ErrorEnvelope: type: object required: - errors properties: errors: type: array items: type: object required: - status - code - title - detail properties: status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: API key headerApiKey: type: apiKey in: header name: X-API-KEY ````