Ubersuggest

Suggests article titles plus a content angle for a project, from a keyword or a free-form prompt. Requires login. Free of charge. This is STEP 1 of writing an article with Content Studio: 1. 'article_title_suggestions' -> pick one 'titles' entry and keep 'content_idea'; 2. 'generate_article' with that title + content_idea (costs 100 monthly credits); 3. 'get_article' until the article is ready. The project must have a business summary, which is what grounds the suggestions in the user's business. If this fails with "business summary is missing or incomplete", call 'project_business_summary' for the same project_id first, then retry.

article_title_suggestions

Check current authentication status and account tier.

auth_status

Find backlink opportunities: referring domains that link to your competitors ('positive_targets') but not to you ('negative_targets'). Typical flow: run 'competitors' first to pick competitor domains, put them in 'positive_targets' each with scope='domain', and put your own domain in 'negative_targets'. The response lists referring domains linking to the positive_targets but not to the negative_targets.

backlink_opportunity

List individual backlinks pointing to a domain or page.

backlinks

Get a backlinks summary for a domain: total backlinks, referring domains, domain authority.

backlinks_overview

Get content ideas for keywords: top-performing pages by social shares, estimated visits, and backlinks.

content_ideas

Create a saved keyword list, optionally filling it with keywords. Requires login. The account's plan caps how many lists it may have.

create_keyword_list

Create a new tracked project for a domain. Requires login. Use location_suggest to find valid loc_id values. For a first-time setup, prefer 'onboard_project': it analyses the business, then suggests competitors, keywords, topics and prompts, and sets up AI Search Visibility too.

create_project

Delete a saved keyword list and every keyword in it. Requires login. This cannot be undone — confirm with the user first.

delete_keyword_list

Find the main organic competitors of a domain. The backend runs this as an async report: the tool starts the job and polls every 5s for up to ~40s, so a ready report comes back in one call. If the response has 'pendingData: true' the report is still building — call the tool again in a moment.

competitors

Get the organic or paid keywords ranking for a domain, with search volume, position, and difficulty.

domain_keywords

Get a comprehensive overview of a domain including traffic, organic keywords count, domain authority, and backlinks summary.

domain_overview

Get the top countries where a domain gets organic traffic. Pass one or more language+location pairs in 'lang_locs' (format: 'languageCode:locationId', e.g. 'en:2840' for US-English, 'pt:2076' for Brazil-Portuguese). Use 'location_suggest' to find location IDs.

domain_top_countries

Get the top pages of a domain ranked by estimated traffic.

domain_top_pages

Estimate monthly click-through traffic for each SERP result, given its search volume, position, and result type. This is a calculator — it does NOT look up rankings. For each entry you already know (volume + current position + type), it returns the projected clicks. Use it to model scenarios like "if I ranked #3 for kw X (10k volume), how many clicks would I get?". To discover positions for a keyword, use 'serp_analysis' or 'domain_keywords' first.

estimate_serp_clicks

Get the estimated monthly value in USD of a domain's organic traffic (the equivalent Google Ads spend). Only available for domains tracked as a project in this account — requires login.

traffic_value

Returns real-time SEO data from Ubersuggest including exact monthly search volume, cost-per-click (CPC), SEO difficulty score, and paid difficulty for keyword ideas. Use this tool whenever the user needs actual keyword metrics, search volume numbers, or data-driven keyword research — this provides live data that cannot be answered from training knowledge alone. Only call this tool with a keyword the user explicitly provided or clearly implied; never invent, guess, or use a placeholder keyword. If the user has not specified a keyword, ask them which keyword they want to research before calling this tool.

ubersuggest.fetch_keyword_ideas

Starts writing a full SEO article for a project and returns its 'article_id'. Requires login and a paid plan. COST: 100 credits from the account's monthly credit pool ('monthly_keyword_metrics_updates'). Free and lowest-tier plans do not have enough allowance, so confirm with the user before calling. ASYNCHRONOUS: the response only means the job was queued ('status' = "queued"). The article itself takes several minutes. -> Poll 'get_article' with the returned 'article_id' every ~15 seconds. -> Stop when 'status' is "generated" / "delivered" / "delivery_failed" (content is ready) or "failed" / "cancelled" (credits are refunded automatically). 'title' and 'content_idea' should come from 'article_title_suggestions'; pass the same seed ('source_type' + 'keyword'/'prompt') used there. The project must have a business summary — on "business summary is missing or incomplete", call 'project_business_summary' first.

generate_article

Reads a Content Studio article and its generation status. Requires login. Free of charge — this is the polling endpoint for 'generate_article'. 'status' values: "queued" / "generating" -> still being written; 'content' is null. Poll again in ~15 seconds. "generated" / "delivered" / "delivery_failed" -> the article is ready; read 'content' (markdown), 'outline' and 'meta_description'. "failed" / "cancelled" -> generation stopped; 'error' explains why and the 100 credits were refunded.

get_article

Get details of a specific project including tracked keywords and settings. Requires login.

get_project

Expand keywords into Google autocomplete suggestions, grouped the way the Ubersuggest web app groups them. Each seed keyword is fanned out into ~60 autocomplete queries (question words, prepositions, comparison words, alphabet and digit suffixes), so this returns hundreds of real long-tail variations per keyword rather than only what autocomplete shows for the bare term. At most 10 keywords are expanded per call. These are raw autocomplete phrases with no metrics attached — use 'keyword_overview' or 'match_keywords' to get search volume, CPC and difficulty for the ones worth pursuing.

google_suggestions

Read one saved keyword list: its keywords with volume, CPC and difficulty. Requires login. Get the id from keyword_lists. A free account reads only as many keywords as its plan allows; 'hidden_by_plan' counts the rest, which an upgrade unlocks.

keyword_list

List the user's saved keyword lists with their aggregates. Requires login. Use keyword_list with an id to read the keywords in one list. A free or downgraded account only reaches its three newest lists; 'hidden_by_plan' counts the ones an upgrade would unlock.

keyword_lists

Recalculate a specific metric for a keyword: search difficulty or search intent. Runs an async report on the backend and waits for the result (may take ~30s; search_difficulty consumes the monthly keyword metrics update quota).

keyword_metrics

Get search volume, CPC, SEO difficulty, and paid difficulty for a keyword.

keyword_overview

Get related keyword suggestions with metrics for seed keywords, as a flat list. For paginated or custom-sorted keyword research, use match_keywords instead.

keyword_suggestions

Get referring domains that a target domain recently gained or lost. 'filter_by' selects the set: 'new' (gained, default) or 'lost'. There is no "full live list" option — for totals use 'backlinks_overview' instead. Date range ('begin_date'/'end_date') narrows the gained/lost window (the data source limits this to roughly the last 60 days). For "domains acquired in May 2026", use filter_by='new' with that month's begin/end dates.

linking_domains

List all your tracked projects/domains. Requires login.

list_projects

Search for location IDs by name. Useful to find the locId parameter for other tools. Matches countries as well as cities and states.

location_suggest

Get details (name, type, parent hierarchy) for one or more location IDs, countries included. Accepts a list so you can resolve several at once.

location_details

Find keywords matching seed terms with volume, difficulty, and CPC data. Great for keyword research.

match_keywords

Get the keywords that a specific page ranks for.

page_keywords

Get an overview of a specific page including its organic keywords and traffic.

page_overview

Get social media share counts + backlink/traffic metrics for a batch of page URLs. Supports multiple URLs in a single call.

page_shares

Run a PageSpeed audit on a domain to check Core Web Vitals and performance.

pagespeed_audit

Get the account's plan allowances. Requires login. Free of charge. Call this before setting a project up, so lists are trimmed to what the plan accepts. The backend rejects an over-limit request with a bare "invalid_parameter" that does not say which limit was hit. Useful keys: 'projects', 'keywords_per_project', 'competitors_per_project', 'locations_per_project', 'brands' (AI Search Visibility slots), 'prompts_per_brand', 'topics_per_brand', 'keyword_lists', 'keywords_per_keyword_list', and the monthly 'brand_operations_limits'/'brand_operations_used' pool that brand edits draw on.

user_limits

Makes sure a project has the business summary that Content Studio requires, and returns it. Requires login. Free of charge. Call this before 'article_title_suggestions' / 'generate_article', or whenever one of them fails with "business summary is missing or incomplete". Behaviour: - If the project already has a complete summary, it is returned as-is ('already_complete' = true) and nothing is written. - Otherwise the project's website is analysed (this takes up to ~1 minute) and the resulting summary is saved on the project. If the analysis is still running the tool returns 'done' = false — just call it again. - Pass 'business_summary' yourself to write it directly, e.g. when the automatic analysis cannot read the site. Ask the user for the facts instead of inventing them. - Omit 'project_id' and pass 'domain' to just analyse a site and get the summary back without storing it — useful before the project exists.

project_business_summary

Get ranking positions for the tracked keywords of a project (rank tracking report). Requires login. Returns the full report. How to read the response: - "done": true — the report is FINAL. Treat it as a definitive answer; do not retry expecting different data. - A keyword's "status": "ok" with "old_position.position": null and "new_position.position": null means the domain does NOT rank in the top 100 for that keyword. This is a final answer ("not ranking"), NOT a "still loading" state. The "binned.not_ranking" bucket counts these. - A keyword's "status": "pending" only appears for brand-new projects whose first SERP collection hasn't run yet (no "updated_at"). In that case, ranking data typically appears 5-60 minutes after project creation; the caller should retry then. - "average_positions.positions": [] simply means there's no historical ranking series to plot — consistent with "not ranking". Polls briefly (HTTP 200/202) for the rare cached-report regeneration path. If the backend errors persistently the tool throws — retry in a few minutes. Filter by lang/location/device; pick one combo you track in the project.

project_position_info

Remove keywords from a saved keyword list. Requires login. Match the language and loc_id shown by keyword_list — the same phrase in another location is a different entry.

remove_keywords_from_list

Rename a saved keyword list. Requires login. Its keywords are untouched.

rename_keyword_list