Ranked AI provides industry leading AI SEO & PPC software, with a fully managed service integrated into it. We combine AI with industry veterans that know how to help you rank your website on traditional & AI search. Manage your traditional & AI search keywords, audits, backlinks, reports and more with our integrated app.
ranked_add_keywordsAdd keywords to track in Google search results. Duplicates are automatically skipped. Returns how many were added.
keywordsarrayArray of keyword strings to track.
project_idstringThe project UUID to add keywords to.
locationstringTarget location e.g. "Waterbury, Connecticut, United States". Default: "United States".
ranked_add_promptsAdd prompts to track brand visibility across 6 AI models (ChatGPT, Claude, Gemini, Perplexity, Grok, Meta Llama). Prompts should be natural questions someone would ask an AI assistant, without mentioning the brand name.
project_idstringThe project UUID.
promptsarrayArray of prompt strings to track.
target_locationstringTarget location. Default: "Global".
ranked_generate_reportGenerate a shareable SEO report link for a project. The report includes keywords, AI visibility, audits, backlinks, and analytics data.
project_idstringThe project UUID.
date_rangestringDate range for the report.
7days30days90dayslastMonthtitlestringOptional custom report title.
ranked_get_ai_visibilityGet AI visibility data showing how your brand appears in AI model responses. Returns visibility scores, mention rates, brand position, and performance across 6 AI models: ChatGPT, Claude, Gemini, Perplexity, Grok, and Meta Llama. Includes per-prompt breakdown with change indicators and estimated AI search volume.
project_idstringThe project UUID to get AI visibility data for.
limitnumberMaximum number of prompts to return (default: 20, max: 50).
ranked_get_audit_detailsGet detailed information about a specific SEO audit issue, including the list of affected URLs/pages. Use get_audit_summary first to get issue IDs, then use this tool to drill down into specific issues.
issue_idstringThe audit issue UUID to get details for.
project_idstringThe project UUID.
limitnumberMaximum number of affected items to return (default: 20, max: 50).
ranked_get_audit_summaryGet a summary of SEO audit issues for a project. Returns counts by severity (critical, warning, notice) and lists the top issues that need attention.
project_idstringThe project UUID to get audit summary for.
limitnumberMaximum number of issues to return (default: 20, max: 50).
severitystringFilter by severity level.
criticalwarningnoticeranked_get_backlink_summaryGet backlink data for a project. Returns total backlinks, referring domains, follow/nofollow breakdown, and lists top referring domains with their metrics.
project_idstringThe project UUID to get backlink data for.
limitnumberMaximum number of referring domains to return (default: 20, max: 50).
ranked_get_content_calendarGet content calendar data for a project. Returns scheduled content items, their status (draft, scheduled, published), due dates, and content types.
project_idstringThe project UUID to get content calendar for.
limitnumberMaximum number of content items to return (default: 30, max: 50).
statusstringFilter by content status.
ranked_get_heatmapsGet local SEO heatmap data for a project. Returns competition and ranking heatmaps that show how your business ranks across a geographic area in Google Maps for specific keywords.
project_idstringThe project UUID to get heatmaps for.
heatmap_typestringFilter by heatmap type.
competitionrankinglimitnumberMaximum number of heatmaps to return (default: 10, max: 20).
ranked_get_keyword_rankingsGet keyword ranking data for a project. Returns current positions across Desktop, Mobile, AI Mode, and Maps channels with per-channel and net position changes. Can filter by date range and limit results.
project_idstringThe project UUID to get keyword rankings for.
date_rangestringDate range for comparison. Default: "30d".
7d30d60d90d180d365dalllimitnumberMaximum number of keywords to return (default: 50, max: 100).
ranked_get_project_overviewGet an overview of your SEO projects. If no project_id is provided, returns a list of all your accessible projects with key metrics. If a project_id is provided, returns detailed metrics for that specific project including keyword rankings, AI visibility, audit issues, backlinks, and content calendar summary. Every project has a productMode: "managed" (Ranked's team does the SEO work - content, publishing, optimization, backlinks - with the full software suite included in the plan at no separate charge) or "software" (self-serve SEO Software on accounts that already have it: the client runs it themselves, tracking and audits only, no content pipeline; the tier is closed to new accounts). When software projects exist the response also carries softwarePlan (the account-wide software plan, capacity and usage - it never applies to managed projects) and productModes (how the two differ) - use them to guide the user correctly.
project_idstringOptional project UUID. If not provided, returns a list of all your projects.
ranked_get_sitemap_indexingGet sitemap URLs and their Google indexing status for a project. Shows which URLs are indexed, submitted, or not indexed, along with impressions and clicks data from Google Search Console.
project_idstringThe project UUID to get sitemap indexing data for.
indexed_statusstringFilter by indexing status.
submittedindexednot_indexedlimitnumberMaximum number of URLs to return (default: 50, max: 100).
ranked_remove_keywordsRemove tracked keywords by their IDs. Use ranked_get_keyword_rankings first to get keyword IDs. This permanently deletes the keywords and their position history.
keyword_idsarrayArray of keyword UUID IDs to remove (from ranked_get_keyword_rankings).
project_idstringThe project UUID.
ranked_request_revisionRequest a revision on a content item with specific notes. Sets status to "Revising" and attaches the revision notes.
content_idstringThe content calendar item UUID.
notesstringDetailed revision notes describing what needs to be changed.
project_idstringThe project UUID.
ranked_run_auditStart a technical SEO audit that crawls the project website for issues. This uses API credits. Results will be available via ranked_get_audit_summary once the crawl completes.
project_idstringThe project UUID.
max_pagesnumberMaximum pages to crawl (default: 100, max: 500).
ranked.get_ai_visibilityGet AI visibility data showing how your brand appears in AI model responses. Returns visibility scores, mention rates, and performance across different AI models (GPT-4, Claude, Gemini).
project_idstringThe project UUID to get AI visibility data for.
limitnumberMaximum number of prompts to return (default: 20, max: 50).
ranked.get_audit_summaryGet a summary of SEO audit issues for a project. Returns counts by severity (critical, warning, notice) and lists the top issues that need attention.
project_idstringThe project UUID to get audit summary for.
limitnumberMaximum number of issues to return (default: 20, max: 50).
severitystringFilter by severity level.
criticalwarningnoticeranked.get_backlink_summaryGet backlink data for a project. Returns total backlinks, referring domains, follow/nofollow breakdown, and lists top referring domains with their metrics.
project_idstringThe project UUID to get backlink data for.
limitnumberMaximum number of referring domains to return (default: 20, max: 50).
ranked.get_content_calendarGet content calendar data for a project. Returns scheduled content items, their status (draft, scheduled, published), due dates, and content types.
project_idstringThe project UUID to get content calendar for.
limitnumberMaximum number of content items to return (default: 30, max: 50).
statusstringFilter by content status.
ranked.get_keyword_rankingsGet keyword ranking data for a project. Returns current search positions, ranking URLs, and position changes for tracked keywords. Can filter by date range and limit results.
project_idstringThe project UUID to get keyword rankings for.
date_rangestringDate range for comparison: "7d" (7 days), "30d" (30 days), or "90d" (90 days). Default: "7d".
7d30d90dlimitnumberMaximum number of keywords to return (default: 50, max: 100).
ranked.get_project_overviewGet an overview of your SEO projects. If no project_id is provided, returns a list of all your accessible projects with key metrics. If a project_id is provided, returns detailed metrics for that specific project including keyword rankings, AI visibility, audit issues, backlinks, and content calendar summary.
project_idstringOptional project UUID. If not provided, returns a list of all your projects.