GovGazette Search API

The Search API from GovGazette — 1 operation(s) for search.

GitHub OpenAPI

Operations 1

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/govgazette-com:govgazette-com-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

govgazette-com-search-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: GovGazette Search API
  version: 0.1.0
servers:
- url: https://govgazette.com
tags:
- name: Search
paths:
  /api/v1/search:
    get:
      operationId: get_api_v1_search
      parameters:
      - in: query
        name: collection
        required: true
        schema:
          type: string
      - in: query
        name: q
        schema:
          maxLength: 512
          type: string
      - in: query
        name: limit
        schema:
          default: 25
          maximum: 50
          minimum: 1
          type: integer
      - in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $defs:
                  AwardAvailability:
                    properties:
                      artifact_http_status:
                        format: uint16
                        maximum: 65535
                        minimum: 0
                        type:
                        - integer
                        - 'null'
                      check_interval_seconds:
                        format: uint64
                        minimum: 0
                        type: integer
                      checked_at:
                        type:
                        - string
                        - 'null'
                      inventory_http_status:
                        format: uint16
                        maximum: 65535
                        minimum: 0
                        type:
                        - integer
                        - 'null'
                      latest_release_date:
                        type:
                        - string
                        - 'null'
                      latest_release_url:
                        type:
                        - string
                        - 'null'
                      max_check_age_seconds:
                        format: int64
                        type: integer
                      state:
                        type: string
                    required:
                    - state
                    - check_interval_seconds
                    - max_check_age_seconds
                    type: object
                  AwardCoverage:
                    properties:
                      dataset:
                        type: string
                      freshness:
                        $ref: '#/components/schemas/AwardFreshness'
                      source_date:
                        type: string
                      source_url:
                        type: string
                    required:
                    - dataset
                    - source_date
                    - source_url
                    - freshness
                    type: object
                  AwardFreshness:
                    properties:
                      age_state:
                        type: string
                      age_warning_after_days:
                        format: int64
                        type: integer
                      effective_source_date:
                        type:
                        - string
                        - 'null'
                      source_age_days:
                        format: int64
                        type:
                        - integer
                        - 'null'
                      upstream:
                        $ref: '#/components/schemas/AwardAvailability'
                      warning:
                        type:
                        - string
                        - 'null'
                    required:
                    - age_state
                    - age_warning_after_days
                    - upstream
                    type: object
                  ExclusionCoverage:
                    properties:
                      freshness:
                        $ref: '#/components/schemas/SourceFreshness'
                        description: Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy.
                      observed_at:
                        description: Observation time does not replace the official source timestamp.
                        type:
                        - string
                        - 'null'
                      scope:
                        type:
                        - string
                        - 'null'
                      sha256:
                        type:
                        - string
                        - 'null'
                      source_date:
                        type:
                        - string
                        - 'null'
                      source_url:
                        type:
                        - string
                        - 'null'
                      status:
                        description: Present as unavailable when no SAM coverage exists in this generation.
                        type:
                        - string
                        - 'null'
                    required:
                    - freshness
                    type: object
                  FreshnessState:
                    enum:
                    - fresh
                    - stale
                    - unknown
                    - unavailable
                    type: string
                  JsonObject:
                    description: Source-specific JSON map. The envelope is stable; map keys vary by official source.
                    type: object
                  RecordSummary:
                    properties:
                      data:
                        $ref: '#/components/schemas/JsonObject'
                        description: Source-specific fields, including provenance and official identifiers.
                      id:
                        description: Stable identifier for a record in this generation.
                        type: string
                      summary:
                        description: Short searchable text, when returned by this operation.
                        type:
                        - string
                        - 'null'
                      title:
                        description: Human-readable record title.
                        type: string
                      url:
                        description: Public canonical path for the record.
                        type: string
                    required:
                    - id
                    - title
                    - url
                    - data
                    type: object
                  SourceFreshness:
                    properties:
                      attention_required:
                        type: boolean
                      evaluated_at:
                        description: UTC time when age was evaluated; source and observation dates are unchanged.
                        type: string
                      max_age_seconds:
                        description: Explicit warning threshold for this daily snapshot. Not a scheduler promise.
                        format: int64
                        type: integer
                      source_age_seconds:
                        description: Age of the official source timestamp, never the import or enrichment timestamp.
                        format: int64
                        type:
                        - integer
                        - 'null'
                      state:
                        $ref: '#/components/schemas/FreshnessState'
                      warn_age_seconds:
                        description: Early-warning boundary, separate from the stale-source boundary.
                        format: int64
                        type: integer
                      warning:
                        description: User-facing warning, or null when within the warning threshold.
                        type:
                        - string
                        - 'null'
                    required:
                    - state
                    - evaluated_at
                    - max_age_seconds
                    - warn_age_seconds
                    - attention_required
                    type: object
                $schema: https://json-schema.org/draft/2020-12/schema
                properties:
                  award_coverage:
                    description: Dated award coverage and official release availability, when applicable.
                    items:
                      $ref: '#/components/schemas/AwardCoverage'
                    type:
                    - array
                    - 'null'
                  collection:
                    description: Collection searched, such as opportunities or awards.
                    type: string
                  coverage:
                    anyOf:
                    - $ref: '#/components/schemas/ExclusionCoverage'
                    - type: 'null'
                    description: Exclusion-specific source age and freshness warnings, when applicable.
                  coverage_url:
                    description: Public source-date endpoint, when this collection supplies it.
                    type:
                    - string
                    - 'null'
                  generation:
                    description: UUID of the snapshot used for every result on this page.
                    type: string
                  items:
                    description: Matching public records.
                    items:
                      $ref: '#/components/schemas/RecordSummary'
                    type: array
                  next_cursor:
                    description: Opaque cursor for the next page, or null at the end.
                    type:
                    - string
                    - 'null'
                required:
                - generation
                - collection
                - items
                type: object
          description: Public source-backed result
        '400':
          description: Invalid request
        '408':
          description: Five-second request deadline exceeded
      summary: Search public records
      x-openai-isConsequential: false
      tags:
      - Search
components:
  schemas:
    ExclusionCoverage:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    AwardCoverage:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    AwardFreshness:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    JsonObject:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    SourceFreshness:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    AwardAvailability:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    FreshnessState:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    RecordSummary:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true