Google search keywords
pinmeto_get_google_keywordsFetch Google search keywords for all locations or a single store within a selected month range. Choose JSON or Markdown output, with warnings for incomplete Google data.
Instructions
Fetch Google keywords for all locations, or a single location if storeId provided.
Data Lag Warning:
Google data has ~10 day lag. Current month data may be incomplete.
Check structuredContent.warning and warningCode for data completeness.
Error Handling:
Rate limit (429): errorCode="RATE_LIMITED", message includes retry timing
Not found (404): errorCode="NOT_FOUND" if storeId doesn't exist
All errors: check structuredContent.errorCode and .retryable for programmatic handling
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"from": "<from>",
"to": "<to>"
},
"name": "pinmeto_get_google_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | End month (YYYY-MM) | |
| from | Yes | Start month (YYYY-MM) | |
| storeId | No | Optional store ID to fetch a single location | |
| response_format | No | Response format: "json" (default, token-efficient) or "markdown" (human-readable with tables) | json |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of keywords with impression data (absent on error) | |
| error | No | Error message if the request failed | |
| errorCode | No | Error code for programmatic handling | |
| retryable | No | Whether the operation can be retried |