GuideDoc Documentary Database

Use this when someone seeks documentary films by title, director, topic or keyword. Search GuideDoc's public film database, including reference films that cannot currently be streamed. Do not use for fiction, private GuideDoc records or streaming availability outside GuideDoc. Args: query: Documentary title, director, topic or keyword; for example "Senna" or "climate change".

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "searchArguments"
}

{
  "type": "object",
  "properties": {
    "results": {
      "items": {
        "$ref": "#/$defs/SearchResult"
      },
      "title": "Results",
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "$defs": {
    "SearchResult": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "year": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Year"
        },
        "directors": {
          "items": {
            "type": "string"
          },
          "title": "Directors",
          "type": "array"
        },
        "description": {
          "title": "Description",
          "type": "string"
        },
        "available_on_guidedoc": {
          "title": "Available On Guidedoc",
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "title",
        "url",
        "directors",
        "description",
        "available_on_guidedoc"
      ],
      "title": "SearchResult",
      "type": "object"
    }
  },
  "title": "SearchOutput"
}

Use this after search to read the public film page and cite its canonical GuideDoc URL. It gives a documentary's verified page details and GuideDoc streaming status; it does not provide private records or availability on other services. Args: id: Exact GuideDoc film URL returned as `id` by search.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "fetchArguments"
}

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "title": {
      "title": "Title",
      "type": "string"
    },
    "text": {
      "title": "Text",
      "type": "string"
    },
    "url": {
      "title": "Url",
      "type": "string"
    },
    "metadata": {
      "additionalProperties": true,
      "title": "Metadata",
      "type": "object"
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url",
    "metadata"
  ],
  "title": "FetchOutput"
}