keywords_data_google_ads_search_volume
Retrieve Google Ads search volume data for keywords to analyze market demand and optimize PPC campaigns based on actual user search behavior.
Instructions
Get search volume data for keywords from Google Ads
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location_name | No | full name of the location optional field in format "Country" example: United Kingdom | |
| language_code | No | Language two-letter ISO code (e.g., 'en'). optional field | |
| keywords | Yes | Array of keywords to get search volume for |
Implementation Reference
- The async handle method executes the core tool logic: makes a POST request to the DataForSEO Google Ads search volume API endpoint with location, language, and keywords, then validates and formats the response or handles errors.
async handle(params: any): Promise<any> { try { const response = await this.dataForSEOClient.makeRequest('/v3/keywords_data/google_ads/search_volume/live', 'POST', [{ location_name: params.location_name, language_code: params.language_code, keywords: params.keywords, }]); return this.validateAndFormatResponse(response); } catch (error) { return this.formatErrorResponse(error); } } - Defines the Zod schema for input parameters: location_name (optional string), language_code (optional string), and keywords (array of strings).
getParams(): z.ZodRawShape { return { location_name: z.string().nullable().default(null).describe(`full name of the location optional field in format "Country" example: United Kingdom`), language_code: z.string().nullable().default(null).describe(`Language two-letter ISO code (e.g., 'en'). optional field`), keywords: z.array(z.string()).describe("Array of keywords to get search volume for"), }; } - In the KeywordsDataApiModule's getTools method, instantiates GoogleAdsSearchVolumeTool and registers it in the tools record using its getName() as key, along with description, params, and a wrapper around its handle method.
getTools(): Record<string, ToolDefinition> { const tools = [ new GoogleAdsSearchVolumeTool(this.dataForSEOClient), new DataForSeoTrendsDemographyTool(this.dataForSEOClient), new DataForSeoTrendsSubregionInterestsTool(this.dataForSEOClient), new DataForSeoTrendsExploreTool(this.dataForSEOClient), new GoogleTrendsCategoriesTool(this.dataForSEOClient), new GoogleTrendsExploreTool(this.dataForSEOClient), // Add more tools here ]; return tools.reduce((acc, tool) => ({ ...acc, [tool.getName()]: { description: tool.getDescription(), params: tool.getParams(), handler: (params: any) => tool.handle(params), }, }), {}); }