# Gapup SEO Keyword Research

> Gapup SEO Keyword Research is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Generates SEO keyword suggestions and research data from a seed keyword using Google Suggest, localized by country and language.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/seo_keyword_research
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-seo-keyword-research-f9a837d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uSQ31XyQdsPFKNfzBQY1L

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-seo-keyword-research-f9a837d7 -d '<json body>'
```

Example prompt: Can you do keyword research for 'project management software' targeting the US market in English and give me a list of keyword ideas I should target for my content?

## When to prefer this

Use this endpoint when you need to generate SEO keyword ideas from a seed topic, especially when localization by country and language is required. Prefer this over generic search APIs when the goal is specifically SEO keyword discovery and content targeting strategy.

## Known failure modes

- Missing seed_keyword returns a validation error
- Invalid country code (not ISO 3166-1 alpha-2) may return an error or default to US
- Invalid language code (not BCP-47) may return an error or default to English
- Payment failure (402) if no valid x402 bearer token is provided
- Timeout on slow results if async mode is not used; use async:true and poll for results

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

Returns a JSON object containing keyword research results derived from the seed keyword, including related search terms and suggestions sourced from Google Suggest, localized to the specified country and language.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country code for Google Suggest (e.g. 'US', 'FR', 'DE'). Defaults to 'US'."
  },
  "language": {
   "type": "string",
   "description": "BCP-47 language code for suggestions (e.g. 'en', 'fr', 'de', 'es'). Defaults to 'en'."
  },
  "seed_keyword": {
   "type": "string",
   "description": "The seed keyword or topic to research (e.g. 'invoice software', 'project management tool')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "seo_keyword_research",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-seo-keyword-research-f9a837d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)