{"contractVersion":"parcelops.connector.v1","name":"datagov-catalog","displayName":"Data.gov Catalog Discovery","description":"Bounded metadata-only search across the federal Data.gov catalog.","tags":["data-gov","federal-open-data","dataset-discovery","metadata","united-states","bring-your-own-key"],"authentication":{"type":"api_key","required":true},"provenance":{"sourceName":"Data.gov Catalog API v4 search","sourceUrl":"https://api.gsa.gov/technology/datagov/v4/search","apiBaseUrl":"https://api.gsa.gov/technology/datagov/v4","documentationUrl":"https://open.gsa.gov/api/datadotgov/"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"modified","notes":"Catalog freshness follows publisher metadata synchronization."}},"coverage":{"geographic":{"status":"declared","value":["United States federal catalog and participating non-federal publishers"]},"temporal":{"status":"not_declared"}},"methods":{"total":2,"items":[{"name":"searchCatalog","description":"Search Data.gov catalog metadata by a bounded phrase.","requiredParams":["q"],"inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":2,"maxLength":300},"limit":{"type":"integer","minimum":1,"maximum":20}},"required":["q"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"modified","notes":"Catalog freshness follows publisher metadata synchronization."},"scope":"connector"},"entities":{"status":"declared","value":["dataset-catalog-record"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Search results are catalog metadata, not the underlying datasets.","Distribution and landing-page URLs are never dereferenced by this connector.","Per-dataset Access & Use Information controls; non-federal records may have different terms.","The live v4 route is absent from GSA’s current published OpenAPI, so only verified q + limit first-page search is exposed.","The opaque next cursor is returned for evidence but replay is not exposed until GSA documents or verifies its contract."]},{"name":"getServiceInfo","description":"Return verified inputs, auth, discovery-only scope, rate evidence, and unverified capabilities.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"modified","notes":"Catalog freshness follows publisher metadata synchronization."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Search results are catalog metadata, not the underlying datasets.","Distribution and landing-page URLs are never dereferenced by this connector.","Per-dataset Access & Use Information controls; non-federal records may have different terms.","The live v4 route is absent from GSA’s current published OpenAPI, so only verified q + limit first-page search is exposed."]}]},"caveats":["Search results are catalog metadata, not the underlying datasets.","Distribution and landing-page URLs are never dereferenced by this connector.","Per-dataset Access & Use Information controls; non-federal records may have different terms.","The live v4 route is absent from GSA’s current published OpenAPI, so only verified q + limit first-page search is exposed."]}