- Category: marketing
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 20
- Triggers: 0
- Slug:
KEYWORD - Version: 20261101_00
Tools
Add Keywords
Add Keywords
Slug:
KEYWORD_ADD_KEYWORDSAdds keywords to a Keyword.com project or group for search ranking tracking across supported Google regions and devices. Adding an already tracked keyword updates the settings supplied for it.Input Parameters
List of keyword objects to add. Each object contains keyword details like the phrase, URL, region, language, device type, and tags. You can add multiple keywords in a single request.
The name or identifier of the project/group to add keywords to. Must match an existing project in your Keyword.com account.
Output
Archive Project
Archive Project
Slug:
KEYWORD_ARCHIVE_PROJECTArchive a Keyword.com project without deleting it. The project remains archived until it is restored or deleted; the account’s only active top-level project cannot be archived.Input Parameters
The name of the project to archive. This is the project identifier used in the API path.
Output
Create Project or Group
Create Project or Group
Slug:
KEYWORD_CREATE_PROJECTTool to create a new project or group in Keyword.com account. Use when you need to create a new project for organizing keywords or create a group within an existing project. For groups, the category must follow the naming convention with [sub] delimiter (e.g., ProjectName[sub]GroupName).Input Parameters
Project name or group name. For creating a project, use the project name (e.g., ‘MyProject’). For creating a group within a project, use the format ‘ProjectName[sub]GroupName’ (e.g., ‘MyProject[sub]MyGroup’). The [sub] delimiter is required for group creation.
Optional 3-letter currency code for reporting (e.g., ‘USD’, ‘GBP’, ‘EUR’). If not provided, the account’s default currency will be used.
Output
Delete Keyword
Delete Keyword
Slug:
KEYWORD_DELETE_KEYWORDTool to delete a single keyword from a project or group. Use when you need to permanently remove a keyword. Warning: This action cannot be undone and all historic ranking data will be lost.Input Parameters
The unique identifier of the keyword to delete. Warning: This action cannot be undone and all historic ranking data will be lost.
Output
Bulk delete keywords
Bulk delete keywords
Slug:
KEYWORD_DELETE_KEYWORDS_BULKBulk delete keywords from a single Keyword.com project by providing the project ID and keyword IDs. Use this operation to remove multiple tracked keywords in one request.Input Parameters
Array of keyword IDs to delete from the project. Each ID must belong to the specified project.
Output
Delete Project
Delete Project
Slug:
KEYWORD_DELETE_PROJECTDelete a single Keyword.com project or group, including its keywords and historical data. For a group, use its full name with the [sub] convention. The account’s only active top-level project cannot be deleted.Input Parameters
The name of the project or group to delete. This action cannot be undone and will permanently remove the project.
Output
Get Current User
Get Current User
Get Keyword
Get Keyword
Get Project Details
Get Project Details
Get Project Metrics
Get Project Metrics
Slug:
KEYWORD_GET_PROJECT_METRICSRetrieve keyword ranking movement metrics for a Keyword.com project or group for a daily, weekly, or monthly timeframe. The results summarize ranking ranges and counts of keywords that improved, declined, or stayed unchanged.Input Parameters
Timeframe for metrics calculation. Determines the period for ranking changes.
Output
Get Keyword Ranking History
Get Keyword Ranking History
Slug:
KEYWORD_GET_RANKING_HISTORYRetrieve Google ranking history for specified keywords for up to 180 days. The results provide daily ranking positions grouped by keyword ID and domain, useful for analyzing ranking trends over time.Input Parameters
Array of keyword IDs to retrieve ranking history for. Each ID should be a valid keyword ID from your Keyword.com account.
Number of days of ranking history to retrieve. Maximum value is 180 days. If not specified, returns the default number of days.
Output
Get Top Pages
Get Top Pages
Slug:
KEYWORD_GET_TOP_PAGESTool to retrieve Top Pages data for a project showing ranking URLs with keyword counts, average rank, search volume, and cost per click metrics. Use when you need to analyze which pages are ranking for the most keywords in a project.Input Parameters
The name or identifier of the project/group to retrieve top pages for. This is typically the domain name (e.g., ‘composio.dev’).
Output
List Active Projects
List Active Projects
List Alerts
List Alerts
Slug:
KEYWORD_LIST_ALERTSRequests Keyword.com account alerts with pagination, sorting, view-type filtering, and an option for the most recent alert per keyword. Alert details and pagination metadata may be missing from the returned result.Input Parameters
When true, retrieves only the most recent alerts. Useful for getting latest notifications without pagination.
Number of results per page (e.g., 100). Controls how many alerts are returned in a single request.
Filter alerts by view type (e.g., ‘All alerts’). Narrows results to specific alert categories or statuses.
Field to sort results by (e.g., ‘created_at’, ‘updated_at’). Determines the ordering of alerts in the response.
Sort direction for results. Use ‘asc’ for ascending order (oldest first) or ‘desc’ for descending order (newest first).
Output
List Keywords
List Keywords
List Project Regions
List Project Regions
Refresh Keywords
Refresh Keywords
Slug:
KEYWORD_REFRESH_KEYWORDSRequest an on-demand keyword ranking refresh for one or more projects or groups, optionally including subgroups. Refreshes consume the plan’s daily on-demand quota; requests exceeding the remaining quota are rejected without queuing keywords.Input Parameters
List of project IDs that need to be refreshed. You must provide at least one project ID.
Set to true to refresh all keywords in the project and its sub-groups. If false, only refreshes keywords in the specified projects.
Output
Restore Archived Project
Restore Archived Project
Slug:
KEYWORD_RESTORE_PROJECTRestore an archived Keyword.com project or group to resume keyword tracking. Once restored, its keywords update during the next scheduled automatic cycle.Input Parameters
The name of the project or group to restore from archive. Once restored, keywords will automatically update during the next scheduled cycle.