USGS ScienceBase

Methods (6)

• searchItems

  read

  Keyword search across the USGS ScienceBase catalog

  Input schema

  {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "examples": [
          "oil and gas assessment"
        ]
      },
      "max": {
        "type": "number",
        "examples": [
          20
        ]
      },
      "offset": {
        "type": "number"
      },
      "fields": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  q required; max defaults 20 and caps 100; supports offset and fields.

• getItem

  read

  Full catalog item record (contacts, spatial, dates, files/distribution links)

  Input schema

  {
    "type": "object",
    "properties": {
      "itemId": {
        "type": "string",
        "examples": [
          "4f4e4a2ce4b07f02db6abb36"
        ]
      }
    },
    "additionalProperties": false
  }

  Args: itemId.

• listChildItems

  read

  Child items of a parent collection

  Input schema

  {
    "type": "object",
    "properties": {
      "parentId": {
        "type": "string",
        "examples": [
          "4f4e4a2ce4b07f02db6abb36"
        ]
      },
      "max": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  Args: parentId, max?.

• searchItemsBySpatial

  read

  Spatial search by WKT polygon (USGS ScienceBase).

  Input schema

  {
    "type": "object",
    "properties": {
      "q": {
        "type": "string"
      },
      "wkt": {
        "type": "string",
        "examples": [
          "POLYGON((-104 40,-103 40,-103 41,-104 41,-104 40))"
        ]
      },
      "max": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  Args: wkt (BARE WKT — not wrapped in Intersects()), q?, max?.

• searchItemsByCategory

  read

  Filter the catalog by browse category

  Input schema

  {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "examples": [
          "geothermal"
        ]
      },
      "browseCategory": {
        "type": "string",
        "examples": [
          "Data"
        ]
      },
      "max": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  Args: browseCategory (Data|Map|Project|Publication|…), q?, max?.

• getServiceInfo

  read

  Static API overview — format=json requirement, pagination, bare-WKT spatial query

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }