Fetch monthly search volume, CPC, year-over-year change, peak month and full 12-month seasonality for a single keyword.

Args:

• lang: Market code (cs/sk/pl/hu/ro/gb/us).

• keyword: Keyword to analyze (2-80 chars).

• response_format: 'markdown' (default) or 'json'.

Returns a single record with: keyword, search_volume, cpc{value, currency_code}, yoy_change, peak_month, monthly_sv (12 months).

Use when you need volume/CPC/seasonality for ONE keyword. For multiple keywords, use marketing_miner_batch_search_volume.

Fetch volume, CPC, YoY change and 12-month seasonality for up to 1000 keywords in one POST request.

Args:

• lang: Market code (cs/sk/pl/hu/ro/gb/us).

• keywords: 1-1000 keywords (each 2-80 chars).

• response_format: 'markdown' (default) or 'json'.

Returns an array of records, one per keyword. Prefer this over calling marketing_miner_get_search_volume in a loop - it is one API credit per keyword and much faster.

Retrieve related keyword suggestions with optional full metrics (difficulty, SERP features, volume, CPC, seasonality).

Args:

• lang: Market code (cs/sk/pl/hu/ro/gb/us).

• keyword: Seed keyword (2-80 chars).

• suggestions_type (optional): 'questions' | 'new' | 'trending'. Omit for a general mix.

• with_keyword_data (default true): include search_volume, cpc, difficulty, serp_features, yoy_change, peak_month, monthly_sv.

• limit (default 50, max 1000): client-side window size.

• offset (default 0): client-side offset into API results for pagination.

• response_format: 'markdown' or 'json'.

Returns: keywords[limit], plus total_available, has_more, next_offset for pagination.

Use for topical research, content-cluster ideation, FAQ mining (suggestions_type='questions'), trend discovery (suggestions_type='trending').

Aggregate organic/paid traffic, keyword counts and result-type breakdown for a domain, subdomain, prefix, or exact URL.

Args:

• lang: Market code (cs/sk/pl/hu/ro/gb/us).

• type: 'domain' | 'subdomain' | 'prefix' | 'exact'.

• target: Target value (3-253 chars). Examples: 'seznam.cz', 'blog.seznam.cz', 'https://seznam.cz/email/'.

• scheme (optional, for type='exact' or 'prefix'): 'https' | 'http'.

• response_format: 'markdown' or 'json'.

Returns: stats[] per result_type (organic, paid, ai_overviews, local_pack, images, videos, ...), plus totals (estimated_traffic_sum, number_of_keywords_sum).

Use for competitor sizing, SEO audits, and SERP-feature distribution analysis.

Historical traffic time series (daily/weekly/monthly) for a target, with optional competitor comparison.

Args:

• lang: Market code.

• type: 'domain' | 'subdomain' | 'prefix' | 'exact'.

• target: 3-253 chars.

• scheme (optional): 'https' | 'http'.

• period (optional): 'daily' | 'weekly' | 'monthly'.

• competitors (optional, max 10): list of competitor domains/URLs.

• response_format: 'markdown' or 'json'.

Returns: stats_range[] (date, result_type, estimated_traffic) + optional competitors[] with their own stats_range. Use for trend analysis, year-over-year charts, and competitor benchmarking.