---
title: "list_keywords. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/list_keywords
description: "List and search keywords with filtering, sorting, and pagination options. Read tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# list_keywords

List and search keywords with filtering, sorting, and pagination options.

Read [search](https://metadata.io/developers/tools/#cat-search)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `name` | object |   | Optional keyword name(s) to search for. Can be a single string or array of strings. Supports partial matching. Omit to list all keywords. |
| `archived` | boolean |   | Filter by archived status. Set to false to show active keywords (default), true to include archived keywords. |
| `page` | integer |   | Page number for pagination (0-based indexing). Default is 0 for the first page. |
| `size` | integer |   | Number of items per page (default: 25, recommended: 25-100). |
| `sort` | string |   | Sort criteria in format: field,direction. Options: id (creation order), avgMonthlySearches, lowerPageBid, higherPageBid, name, modifiedDate. Direction: desc (descending) or asc (ascending). Default: id,desc (newest first).one of: `id,desc`, `id,asc`, `avgMonthlySearches,desc`, `avgMonthlySearches,asc`, `lowerPageBid,desc`, `lowerPageBid,asc`, `higherPageBid,desc`, `higherPageBid,asc`, `name,desc`, `name,asc`, `modifiedDate,desc`, `modifiedDate,asc` |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other search tools:

- [add_keywords_to_negative_lists](https://metadata.io/developers/tools/add_keywords_to_negative_lists) Writes
- [add_negative_keyword_lists_to_live_campaigns](https://metadata.io/developers/tools/add_negative_keyword_lists_to_live_campaigns) Writes
- [create_keywords](https://metadata.io/developers/tools/create_keywords) Writes
- [create_negative_keywords_list](https://metadata.io/developers/tools/create_negative_keywords_list) Writes
- [delete_negative_keyword_lists](https://metadata.io/developers/tools/delete_negative_keyword_lists) Destructive
- [duplicate_negative_keywords_list](https://metadata.io/developers/tools/duplicate_negative_keywords_list) Writes
- [experiments_keywords_stats](https://metadata.io/developers/tools/experiments_keywords_stats) Read
- [get_negative_keywords_list_details](https://metadata.io/developers/tools/get_negative_keywords_list_details) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)