# Ansible Galaxy

> Find and track Ansible content on Ansible Galaxy: search collections, namespaces and roles, read a collection's versions, dependencies, modules and module documentation, and start a workflow when a collection publishes a new version. No account or API key required.

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/ansible-galaxy

## Actions

### Get a collection

Get a collection at its latest version or any other: description, downloads, dependencies, the ansible-core versions it works with, how many modules, plugins and roles it holds, its links and its download address and checksum.

**Inputs**

- Collection (`collection`, text, required): The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.

**Outputs**

- `authors` (list): Its authors, as they list themselves.
- `collection` (text): The collection as namespace.name, e.g. community.general.
- `content_counts` (list): How many modules, roles and plugins of each kind this version holds.
- `dependencies` (list): The collections this version needs.
- `deprecated` (true/false): Whether its publisher has deprecated the collection.
- `description` (text): What it does, in its authors' words.
- `documentation` (text): Its documentation site.
- `download_count` (number): How many times it has been downloaded, all versions together.
- `download_url` (text): Where to download this version's archive.
- `filename` (text): The archive's file name, e.g. community-general-13.5.0.tar.gz.
- `first_published_at` (text): When the collection first appeared on Galaxy.
- `homepage` (text): Its home page.
- `install_command` (text): The command that installs this version (the latest, unless a version was picked).
- `is_latest` (true/false): Whether the version described is the latest.
- `issues` (text): Where to report problems with it.
- `last_updated_at` (text): When the collection last changed, usually its latest release.
- `latest_version` (text): The collection's latest version.
- `license` (text): Its licences (SPDX ids), comma separated.
- `module_count` (number): How many modules this version holds.
- `name` (text): Its name within the namespace, e.g. general.
- `namespace` (text): The namespace that publishes it, e.g. community.
- `plugin_count` (number): How many plugins (lookup, filter, callback and the rest) it holds.
- `published_at` (text): When this version was published.
- `repository` (text): Its source code repository.
- `requires_ansible` (text): The ansible-core versions this version works with, e.g. >=2.18.0.
- `role_count` (number): How many roles it holds.
- `sha256` (text): The archive's SHA-256 checksum.
- `size_bytes` (number): The archive's size in bytes.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `tags` (list): Its tags, e.g. aws or cloud.
- `url` (text): This version's page on galaxy.ansible.com.
- `version` (text): The version described.

**Example output**

```json
{
  "authors": [
    "Ansible (https://github.com/ansible)"
  ],
  "collection": "amazon.aws",
  "content_counts": [
    {
      "content_type": "module",
      "count": 141,
      "label": "Modules"
    },
    {
      "content_type": "lookup",
      "count": 5,
      "label": "Lookup plugins"
    }
  ],
  "dependencies": [],
  "deprecated": false,
  "description": "A variety of Ansible content to help automate the management of AWS services.",
  "documentation": "https://ansible-collections.github.io/amazon.aws/branch/main/collections/amazon/aws/index.html",
  "download_count": 95040745,
  "download_url": "https://galaxy.ansible.com/api/v3/plugin/ansible/content/published/collections/artifacts/amazon-aws-12.0.0.tar.gz",
  "filename": "amazon-aws-12.0.0.tar.gz",
  "first_published_at": "2023-05-08T20:50:47Z",
  "homepage": "https://github.com/ansible-collections/amazon.aws",
  "install_command": "ansible-galaxy collection install amazon.aws",
  "is_latest": true,
  "issues": "https://github.com/ansible-collections/amazon.aws/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc",
  "last_updated_at": "2026-10-13T20:50:17Z",
  "latest_version": "12.0.0",
  "license": null,
  "module_count": 141,
  "name": "aws",
  "namespace": "amazon",
  "plugin_count": 12,
  "published_at": "2026-10-13T20:50:17Z",
  "repository": "https://github.com/ansible-collections/amazon.aws",
  "requires_ansible": ">=2.18.0",
  "role_count": 0,
  "sha256": "521982d74fa6a5268887fc1b9aff5477b89fb8889a1428a05737ff5615f26685",
  "size_bytes": 1511297,
  "summary": "amazon.aws 12.0.0 (the latest version): 141 modules, 12 plugins and 0 roles, downloaded 95,040,745 times in all.",
  "tags": [
    "amazon",
    "aws",
    "cloud"
  ],
  "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/",
  "version": "12.0.0"
}
```

### Get a module's documentation

Read the documentation of a module or plugin in a collection: what it does, its options (type, default, choices, whether required), requirements, notes, examples and the values it returns.

**Inputs**

- Collection (`collection`, text, required): The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
- Module or plugin (`plugin`, text, required): Its name, like s3_bucket, or its full name, like amazon.aws.s3_bucket. List a collection's content lists them.
- Type (`content_type`, text): A module unless you pick a kind of plugin. One of: `module`, `become` (Become plugin), `cache` (Cache plugin), `callback` (Callback plugin), `cliconf` (Cliconf plugin), `connection` (Connection plugin), `filter` (Filter plugin), `httpapi` (HttpApi plugin), `inventory` (Inventory plugin), `lookup` (Lookup plugin), and 6 more. Default: `module`.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.

**Outputs**

- `authors` (list): Who wrote it.
- `collection` (text): The collection as namespace.name, e.g. community.general.
- `content_type` (text): Galaxy's name for its kind, e.g. module or lookup.
- `content_type_label` (text): Its kind in words, e.g. Lookup plugin.
- `deprecation` (text): Why it is deprecated, when it goes and what to use instead. Empty when it is not deprecated.
- `description` (text): What it does, in full.
- `examples` (text): Its examples, as playbook YAML.
- `full_name` (text): Its full name, e.g. amazon.aws.s3_bucket.
- `name` (text): The module's or plugin's short name, e.g. s3_bucket.
- `notes` (list): Its notes and caveats.
- `option_count` (number): How many options it takes.
- `options` (list): The options it takes, by name.
- `required_options` (list): The names of the options it requires.
- `requirements` (list): What the machine running it needs, e.g. python >= 3.6.
- `return_values` (list): The values it returns.
- `short_description` (text): What it does, in one line.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `url` (text): Its documentation page on galaxy.ansible.com.
- `version` (text): The collection version read.
- `version_added` (text): The collection version that added it.

**Example output**

```json
{
  "authors": [
    "Gerben Geijteman (@hyperized)"
  ],
  "collection": "amazon.aws",
  "content_type": "module",
  "content_type_label": "Module",
  "deprecation": null,
  "description": "Lists S3 buckets and details about those buckets.\n\nPrior to release 5.0.0 this module was called community.aws.aws_s3_bucket_info. The usage did not change.",
  "examples": "# Lists all S3 buckets\n- amazon.aws.s3_bucket_info:\n  register: result",
  "full_name": "amazon.aws.s3_bucket_info",
  "name": "s3_bucket_info",
  "notes": [
    "Caution: For modules, environment variables and configuration files are read from the Ansible 'host' context and not the 'controller' context."
  ],
  "option_count": 14,
  "options": [
    {
      "aliases": [
        "aws_access_key_id",
        "aws_access_key"
      ],
      "choices": [],
      "default": null,
      "description": "AWS access key ID.\n\nThe AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY environment variables may also be used in decreasing order of preference.",
      "elements": null,
      "name": "access_key",
      "required": false,
      "suboptions": [],
      "type": "str",
      "version_added": null
    },
    {
      "aliases": [],
      "choices": [],
      "default": null,
      "description": "A dictionary to modify the botocore configuration.",
      "elements": null,
      "name": "aws_config",
      "required": false,
      "suboptions": [],
      "type": "dict",
      "version_added": null
    }
  ],
  "required_options": [],
  "requirements": [
    "python >= 3.6",
    "boto3 >= 1.38.23",
    "botocore >= 1.38.23"
  ],
  "return_values": [
    {
      "description": "A list of S3 buckets.",
      "name": "buckets",
      "returned": "always",
      "sample": null,
      "type": "complex"
    }
  ],
  "short_description": "Lists S3 buckets in AWS",
  "summary": "amazon.aws.s3_bucket_info (module, amazon.aws 12.0.0): Lists S3 buckets in AWS. 14 options (none required).",
  "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket_info/",
  "version": "12.0.0",
  "version_added": "1.0.0"
}
```

### Get a namespace

Get a namespace and the collections it publishes, with each one's latest version and downloads, plus its company, description and links.

**Inputs**

- Namespace (`namespace`, text, required): The namespace's name, like community or amazon, or the address of its page on galaxy.ansible.com.

**Outputs**

- `avatar_url` (text): Its logo.
- `collection_count` (number): How many collections it publishes.
- `collections` (list): The collections it publishes, by name (up to 100).
- `company` (text): The company or person behind it.
- `description` (text): What it says about itself.
- `links` (list): The links it lists.
- `name` (text): The namespace's name, e.g. community.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total_downloads` (number): Downloads of the listed collections, together.
- `url` (text): Its page on galaxy.ansible.com.

**Example output**

```json
{
  "avatar_url": "https://galaxy.ansible.com/api/pulp/api/v3/content/ansible/namespaces/0191278f-3a63-771c-9793-0313c4951790/avatar/",
  "collection_count": 2,
  "collections": [
    {
      "collection": "companieshouse.general",
      "deprecated": false,
      "download_count": 4395,
      "last_updated_at": "2026-07-03T09:40:28Z",
      "latest_version": "1.2.4",
      "name": "general",
      "url": "https://galaxy.ansible.com/ui/repo/published/companieshouse/general/"
    },
    {
      "collection": "companieshouse.security",
      "deprecated": false,
      "download_count": 4316,
      "last_updated_at": "2026-10-23T10:03:11Z",
      "latest_version": "1.0.22",
      "name": "security",
      "url": "https://galaxy.ansible.com/ui/repo/published/companieshouse/security/"
    }
  ],
  "company": "Companies House",
  "description": "Companies House is an executive agency, sponsored by the Department for Business and Trade.",
  "links": [
    {
      "name": "main",
      "url": "https://www.gov.uk/government/organisations/companies-house"
    }
  ],
  "name": "companieshouse",
  "summary": "The companieshouse namespace (Companies House) publishes 2 collections, downloaded 8,711 times in all.",
  "total_downloads": 8711,
  "url": "https://galaxy.ansible.com/ui/namespaces/companieshouse/"
}
```

### Get a role

Get a standalone role: what it does, its latest version, downloads, tags, the roles it depends on, and the GitHub repository and commit it was last imported from.

**Inputs**

- Role (`role`, text, required): The role as namespace.name, like geerlingguy.docker, the address of its page on galaxy.ansible.com, or Galaxy's number for it. Search roles finds all three.

**Outputs**

- `commit` (text): The commit Galaxy last imported.
- `commit_message` (text): That commit's message.
- `created_at` (text): When it was added to Galaxy.
- `dependencies` (list): The roles it needs, as namespace.name.
- `description` (text): What it does, in its author's words.
- `download_count` (number): How many times it has been downloaded.
- `github_branch` (text): The branch Galaxy imports.
- `github_repo` (text): The GitHub repository it comes from.
- `github_user` (text): The GitHub account it comes from.
- `id` (number): Galaxy's number for the role.
- `imported_at` (text): When Galaxy last imported it.
- `install_command` (text): The command that installs it, e.g. ansible-galaxy role install geerlingguy.docker.
- `latest_version` (text): Its latest version.
- `name` (text): Its name, e.g. docker.
- `namespace` (text): Who publishes it, e.g. geerlingguy.
- `repository_url` (text): The GitHub repository it is built from.
- `role` (text): The role as namespace.name, e.g. geerlingguy.docker.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `tags` (list): Its tags, e.g. docker or web.
- `updated_at` (text): When Galaxy last updated it.
- `url` (text): Its page on galaxy.ansible.com.

**Example output**

```json
{
  "commit": "1d3968dbf0df48515ffda0f6561cbd25206f502a",
  "commit_message": "Merge pull request #534 from hollow/no-nightly\n\nRemove broken nightly repo",
  "created_at": "2023-05-08T20:49:45Z",
  "dependencies": [],
  "description": "Docker for Linux.",
  "download_count": 30319806,
  "github_branch": "master",
  "github_repo": "ansible-role-docker",
  "github_user": "geerlingguy",
  "id": 10923,
  "imported_at": "2026-01-15T16:31:55Z",
  "install_command": "ansible-galaxy role install geerlingguy.docker",
  "latest_version": "8.0.0",
  "name": "docker",
  "namespace": "geerlingguy",
  "repository_url": "https://github.com/geerlingguy/ansible-role-docker",
  "role": "geerlingguy.docker",
  "summary": "geerlingguy.docker 8.0.0: Docker for Linux. Downloaded 30,319,806 times.",
  "tags": [
    "web",
    "system",
    "containers",
    "docker",
    "orchestration",
    "compose"
  ],
  "updated_at": "2026-01-15T16:31:56Z",
  "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker/"
}
```

### List a collection's content

List the modules, roles and plugins in a collection version, each with what it does in one line, optionally only one kind or names containing a word.

**Inputs**

- Collection (`collection`, text, required): The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.
- Type (`content_type`, text): Only modules, only roles, or one kind of plugin. Everything by default. One of: `all` (Everything), `module`, `role`, `playbook`, `action` (Action plugin), `become` (Become plugin), `cache` (Cache plugin), `callback` (Callback plugin), `cliconf` (Cliconf plugin), `connection` (Connection plugin), and 15 more. Default: `all`.
- Name contains (`name_contains`, text): Only items whose name contains this, like s3 or user.

**Outputs**

- `collection` (text): The collection as namespace.name, e.g. community.general.
- `content_counts` (list): How many of each kind the version holds.
- `count` (number): How many match.
- `items` (list): The matching modules, roles and plugins.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many items the version holds in all.
- `version` (text): The version read.

**Example output**

```json
{
  "collection": "amazon.aws",
  "content_counts": [
    {
      "content_type": "module",
      "count": 141,
      "label": "Modules"
    },
    {
      "content_type": "lookup",
      "count": 5,
      "label": "Lookup plugins"
    }
  ],
  "count": 2,
  "items": [
    {
      "content_type": "module",
      "content_type_label": "Module",
      "description": "Manage S3 buckets in AWS, DigitalOcean, Ceph, Walrus, FakeS3 and StorageGRID",
      "full_name": "amazon.aws.s3_bucket",
      "name": "s3_bucket",
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket/"
    },
    {
      "content_type": "module",
      "content_type_label": "Module",
      "description": "Lists S3 buckets in AWS",
      "full_name": "amazon.aws.s3_bucket_info",
      "name": "s3_bucket_info",
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket_info/"
    }
  ],
  "summary": "amazon.aws 12.0.0 holds 213 items; 2 modules with \"s3_bucket\" in the name.",
  "total": 213,
  "version": "12.0.0"
}
```

### List a collection's versions

List the versions a collection has published, highest or newest first, with when each came out, the ansible-core versions it works with and the command that installs it.

**Inputs**

- Collection (`collection`, text, required): The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
- Order (`sort`, text): Highest version number first by default; most recently published first puts fixes to older lines (a 12.6.6 after 13.4.0) in the order they came out. One of: `version` (Highest version first), `published` (Most recently published first), `oldest` (Oldest first). Default: `version`.
- Number of versions (`limit`, number): How many versions to return on each page, 1 to 100. 20 by default. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results, from 1: use next_page from the last one. At least 1. Default: `1`.

**Outputs**

- `collection` (text): The collection as namespace.name, e.g. community.general.
- `count` (number): How many are on this page.
- `latest_version` (text): The collection's latest version.
- `name` (text): Its name within the namespace, e.g. general.
- `namespace` (text): The namespace that publishes it, e.g. community.
- `next_page` (number): The Page value for the next page. Empty on the last page.
- `page` (number): Which page this is, from 1.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.
- `versions` (list): The versions on this page.

**Example output**

```json
{
  "collection": "community.general",
  "count": 2,
  "latest_version": "13.5.0",
  "name": "general",
  "namespace": "community",
  "next_page": 2,
  "page": 1,
  "summary": "community.general has 243 versions; showing 1 to 2, highest version first. Latest: 13.5.0.",
  "total": 243,
  "versions": [
    {
      "install_command": "ansible-galaxy collection install community.general:==13.5.0",
      "is_latest": true,
      "published_at": "2026-10-05T17:30:02Z",
      "requires_ansible": ">=2.18.0",
      "url": "https://galaxy.ansible.com/ui/repo/published/community/general/?version=13.5.0",
      "version": "13.5.0"
    },
    {
      "install_command": "ansible-galaxy collection install community.general:==13.4.0",
      "is_latest": false,
      "published_at": "2026-09-07T20:10:28Z",
      "requires_ansible": ">=2.18.0",
      "url": "https://galaxy.ansible.com/ui/repo/published/community/general/?version=13.4.0",
      "version": "13.4.0"
    }
  ]
}
```

### List a role's versions

List the versions a standalone role has released, newest first, with when each was tagged and where to download it.

**Inputs**

- Role (`role`, text, required): The role as namespace.name, like geerlingguy.docker, the address of its page on galaxy.ansible.com, or Galaxy's number for it. Search roles finds all three.
- Number of versions (`limit`, number): How many versions to return, newest first, 1 to 500. 20 by default. From 1 to 500. Default: `20`.

**Outputs**

- `count` (number): How many are listed.
- `id` (number): Galaxy's number for the role.
- `latest_version` (text): Its latest version.
- `role` (text): The role as namespace.name.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many versions it has in all.
- `versions` (list): The versions, newest first.

**Example output**

```json
{
  "count": 2,
  "id": 10923,
  "latest_version": "8.0.0",
  "role": "geerlingguy.docker",
  "summary": "geerlingguy.docker has 81 versions; showing the newest 2. Latest: 8.0.0.",
  "total": 81,
  "versions": [
    {
      "added_at": "2026-01-15T16:31:55Z",
      "download_url": "https://github.com/geerlingguy/ansible-role-docker/archive/8.0.0.tar.gz",
      "is_latest": true,
      "released_at": "2026-01-15T16:31:08Z",
      "version": "8.0.0"
    },
    {
      "added_at": "2025-12-01T21:52:20Z",
      "download_url": "https://github.com/geerlingguy/ansible-role-docker/archive/7.9.0.tar.gz",
      "is_latest": false,
      "released_at": "2025-11-28T05:17:17Z",
      "version": "7.9.0"
    }
  ]
}
```

### Search collections

Find Ansible collections on Galaxy by words, namespace and tags, or the ones that depend on a collection, each with its latest version, description, tags, dependencies and the ansible-core versions it works with.

**Inputs**

- Search for (`keywords`, text): Words to look for in collections' names, descriptions, tags and contents, e.g. postgresql or windows firewall.
- Namespace (`namespace`, text): Only collections from this namespace, like community or cisco.
- Tags (`tags`, text): Only collections with every one of these tags, like cloud or networking. Separate several with commas.
- Depends on (`depends_on`, text): Only collections that need this one, as namespace.name, like amazon.aws: who builds on it.
- Deprecated collections (`deprecated`, text): Leave out the collections their publishers have deprecated, or not. One of: `hide` (Leave deprecated collections out), `include` (Include deprecated collections), `only` (Only deprecated collections). Default: `hide`.
- Order (`sort`, text): Best match first by default (newest first when nothing is searched for). One of: `relevance` (Best match first), `updated` (Most recently updated first), `name` (By name, A to Z), `namespace` (By namespace, A to Z). Default: `relevance`.
- Number of collections (`limit`, number): How many collections to return on each page, 1 to 100. 20 by default. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results, from 1: use next_page from the last one. At least 1. Default: `1`.

**Outputs**

- `collections` (list): The collections on this page.
- `count` (number): How many are on this page.
- `next_page` (number): The Page value for the next page. Empty on the last page.
- `page` (number): Which page this is, from 1.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.

**Example output**

```json
{
  "collections": [
    {
      "collection": "amazon.aws",
      "dependencies": [],
      "deprecated": false,
      "description": "A variety of Ansible content to help automate the management of AWS services.",
      "install_command": "ansible-galaxy collection install amazon.aws",
      "name": "aws",
      "namespace": "amazon",
      "published_at": "2026-10-13T20:50:17Z",
      "publisher": null,
      "requires_ansible": ">=2.18.0",
      "tags": [
        "amazon",
        "aws",
        "cloud"
      ],
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/",
      "version": "12.0.0"
    },
    {
      "collection": "amazon.cloud",
      "dependencies": [
        {
          "collection": "amazon.aws",
          "version_range": ">=6.0.0"
        },
        {
          "collection": "community.aws",
          "version_range": ">=5.3.0"
        }
      ],
      "deprecated": false,
      "description": null,
      "install_command": "ansible-galaxy collection install amazon.cloud",
      "name": "cloud",
      "namespace": "amazon",
      "published_at": "2023-07-02T22:14:25Z",
      "publisher": null,
      "requires_ansible": ">=2.12.0",
      "tags": [
        "amazon",
        "cloud",
        "aws"
      ],
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/cloud/",
      "version": "0.4.0"
    }
  ],
  "count": 2,
  "next_page": null,
  "page": 1,
  "summary": "Found 2 collections matching \"aws\" in amazon; showing 1 to 2, best match first.",
  "total": 2
}
```

### Search namespaces

Find the namespaces that publish collections on Galaxy, by name or company, with each one's company, description and logo.

**Inputs**

- Search for (`keywords`, text): Words to look for in namespaces' names and companies, e.g. cisco.
- Order (`sort`, text): By name, A to Z, by default. One of: `name` (By name, A to Z), `company` (By company, A to Z), `newest` (Newest first). Default: `name`.
- Number of namespaces (`limit`, number): How many namespaces to return on each page, 1 to 100. 20 by default. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results, from 1: use next_page from the last one. At least 1. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `namespaces` (list): The namespaces on this page.
- `next_page` (number): The Page value for the next page. Empty on the last page.
- `page` (number): Which page this is, from 1.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "namespaces": [
    {
      "avatar_url": null,
      "company": null,
      "description": null,
      "name": "amazon",
      "url": "https://galaxy.ansible.com/ui/namespaces/amazon/"
    },
    {
      "avatar_url": "https://galaxy.ansible.com/api/pulp/api/v3/content/ansible/namespaces/018d19ff-4d5e-7226-bcbb-d0e672d3ec76/avatar/",
      "company": "Amazon Web Services, Inc.",
      "description": "David Duncan",
      "name": "davdunc",
      "url": "https://galaxy.ansible.com/ui/namespaces/davdunc/"
    }
  ],
  "next_page": 2,
  "page": 1,
  "summary": "Found 3 namespaces matching \"amazon\"; showing 1 to 2, by name, A to Z.",
  "total": 3
}
```

### Search roles

Find standalone Ansible roles on Galaxy by a word, author or tag, most downloaded first, with each one's latest version, downloads and GitHub repository.

**Inputs**

- Search for (`keywords`, text): A word to look for in roles' names, authors and descriptions, e.g. nginx.
- Namespace (`namespace`, text): Only roles by this author, like geerlingguy.
- Tag (`tag`, text): Only roles with this tag, like web or database.
- Order (`sort`, text): Most downloaded first by default. One of: `downloads` (Most downloaded first), `updated` (Most recently updated first), `newest` (Newest first), `name` (By name, A to Z). Default: `downloads`.
- Number of roles (`limit`, number): How many roles to return on each page, 1 to 100. 20 by default. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results, from 1: use next_page from the last one. At least 1. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `next_page` (number): The Page value for the next page. Empty on the last page.
- `page` (number): Which page this is, from 1.
- `roles` (list): The roles on this page.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "next_page": null,
  "page": 1,
  "roles": [
    {
      "created_at": "2023-05-08T20:49:45Z",
      "description": "Docker for Linux.",
      "download_count": 30319806,
      "id": 10923,
      "install_command": "ansible-galaxy role install geerlingguy.docker",
      "latest_version": "8.0.0",
      "name": "docker",
      "namespace": "geerlingguy",
      "repository_url": "https://github.com/geerlingguy/ansible-role-docker",
      "role": "geerlingguy.docker",
      "tags": [
        "web",
        "system",
        "containers",
        "docker",
        "orchestration",
        "compose"
      ],
      "updated_at": "2026-01-15T16:31:56Z",
      "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker/"
    },
    {
      "created_at": "2023-05-08T20:49:45Z",
      "description": "Docker setup for Rasbperry Pi and ARM-based devices.",
      "download_count": 376509,
      "id": 10924,
      "install_command": "ansible-galaxy role install geerlingguy.docker_arm",
      "latest_version": "5.0.0",
      "name": "docker_arm",
      "namespace": "geerlingguy",
      "repository_url": "https://github.com/geerlingguy/ansible-role-docker_arm",
      "role": "geerlingguy.docker_arm",
      "tags": [
        "arm",
        "containers",
        "docker",
        "pi",
        "raspberry",
        "system"
      ],
      "updated_at": "2023-10-29T18:45:22Z",
      "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker_arm/"
    }
  ],
  "summary": "Found 2 roles matching \"docker\" by geerlingguy; showing 1 to 2, most downloaded first.",
  "total": 2
}
```
