# Keyword AI integration on Definable

> Keyword.com is a digital marketing platform that provides search engine ranking tracking and SEO analytics

## What this connects

Keyword.com is a digital marketing platform that provides search engine ranking tracking and SEO analytics

Vendor: https://app.keyword.com

## Tools available

**20** tools available. First 12:

- `KEYWORD_ADD_KEYWORDS` — Add Keywords — Tool to add keywords to a Keyword.com project for search ranking tracking. Use when you need to monitor how specific URLs rank for target keywords across different Google regions and devices.
- `KEYWORD_ARCHIVE_PROJECT` — Archive Project — Tool to archive a project in Keyword.com. Sets the project status to Archived. Use when you need to archive a project without permanently deleting it. The project will remain archived until restored or permanently deleted.
- `KEYWORD_CREATE_PROJECT` — Create Project or Group — Tool 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).
- `KEYWORD_DELETE_KEYWORD` — Delete Keyword — Tool 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.
- `KEYWORD_DELETE_KEYWORDS_BULK` — Bulk delete keywords — Tool to bulk delete multiple keywords from a single project by providing keyword IDs. Use when you need to remove multiple keywords at once from a project.
- `KEYWORD_DELETE_PROJECT` — Delete Project — Tool to delete a single project or group from Keyword.com. Use when you need to permanently remove a project. This action cannot be undone.
- `KEYWORD_GET_CURRENT_USER` — Get Current User — Tool to retrieve the current authenticated user's account information. Returns user profile details including ID, name, email, onboarding status, and optionally subscription information.
- `KEYWORD_GET_KEYWORD` — Get Keyword — Tool to retrieve all keyword settings and ranking metrics for a single keyword. Use when you need to get detailed information about a keyword's performance and configuration. Can optionally retrieve data for a specific date.
- `KEYWORD_GET_PROJECT` — Get Project Details — Tool to retrieve a single project's summary from Keyword.com. Returns groups, tags, keyword counts, and the PROJECT AUTH KEY required for detailed data collection. Use when you need project details or the auth key for further API operations.
- `KEYWORD_GET_PROJECT_METRICS` — Get Project Metrics — Retrieve keyword movement metrics for a project, group, or tag. Returns ranking changes (daily, weekly, or monthly) including number of keywords that improved, declined, or remained unchanged, along with detailed movement data for individual keywords.
- `KEYWORD_GET_RANKING_HISTORY` — Get Keyword Ranking History — Tool to retrieve Google ranking history for specified keywords for up to 180 days. Use when you need to analyze historical ranking trends or track keyword performance over time. Returns daily ranking positions grouped by keyword ID and domain.
- `KEYWORD_GET_SOV_HISTORY` — Get Share of Voice History — Retrieve Share of Voice data over time for a specific project. Use when you need historical SOV metrics. Supports ranges of 7, 30, 90, 180, and 365 days with varying data point intervals.

## Auth

Auth schemes: `API_KEY`.

## How agents use Keyword

Inside a Definable workflow, Keyword is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Keyword** — the Researcher (GPT-5.5) pulls context from Keyword (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Keyword** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Keyword (create record, post message, draft email).
- **Designer / Engineer → Distributor → Keyword** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Keyword (attach file, open PR comment, post status).

The Verifier checks every Keyword call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- marketing — https://definable.ai/apps/category/marketing/

## Related

- HTML page: https://definable.ai/apps/keyword/
- Same category (marketing): https://definable.ai/apps/category/marketing/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt