apply_translation_update
ChatGPTReplace a translated article's text with a pending translation update (a candidate listed by get_translations). Applying does not publish; approve the result with approve_translation. Fails when the translation was edited after the update was generated, so manual edits are never overwritten; discard the update with discard_translation_update to keep them. Returns the article's language versions.
approve_post
ChatGPTApprove a Ready post and queue it for publication at its scheduled time. Returns the updated post.
approve_translation
ChatGPTApprove a translated article's current text for publication: VibeSEO publishes it to the project's connected site (its blog or CMS) once the original article is published. Returns the article's language versions.
autocomplete_keywords
ChatGPTGoogle-autocomplete-style keyword suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Each suggestion comes back with its own locationCode/languageCode — use this tool (or related_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty. Filter results by volume, CPC, difficulty, intent.
backlink_history
ChatGPTMonthly history of total backlinks, new and lost backlinks, and referring domains for a domain.
comparison_keywords
ChatGPTComparison-style suggestions ("X vs Y", "X alternative", ...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
competitive_overview
ChatGPTSide-by-side metrics for a primary domain and its competitors: traffic, keywords, backlinks, common keywords, gap size, monthly trend.
create_post
ChatGPTCreate a post from an article you wrote yourself, stored directly in Ready status. Creating a post costs no credits: it runs no strategist or AI generation, so the text is published exactly as you pass it. The slug is built from the title when omitted; if the slug is already used in the project, the call fails and you must pass a different slug (a title without Latin letters or digits needs an explicit slug). The SEO score stays empty and no automatic translations are queued. Nothing is published yet: set a date with schedule_post, then approve_post queues it for the project's connected site, or publish_post_now after approving. Returns the new post in the get_post format.
discard_translation_update
ChatGPTDrop a pending translation update (a candidate listed by get_translations) and keep the translated article's current text. Returns the article's language versions.
domain_competitor_suggestions
ChatGPTSuggested competitor domains based on keyword overlap and similar audience.
domain_overview
ChatGPTAuthority, organic/paid traffic estimate, keyword count, backlink count, and rank distribution for a domain.
domain_top_keywords
ChatGPTTop organic keywords the domain ranks for, with position, volume, traffic, and SERP features.
domain_top_pages
ChatGPTTop pages on the domain by estimated organic traffic.
domain_traffic_history
ChatGPTMonthly organic traffic history for a domain.
generate_post
ChatGPTTrigger AI draft generation for a scheduled Idea or Drafting post. Returns the post ID.
get_audit
ChatGPTAudit metadata + summary scores by audit ID.
get_audit_summary
ChatGPTCondensed audit scorecard: category breakdown, top recurring rule codes, average response time, indexable pages percent.
get_backlink_profile
ChatGPTAggregate backlink profile for a domain: total backlinks, referring domains (with dofollow/nofollow split), domain rank, spam score, broken links, and referring-link breakdowns by TLD, type, attribute, platform and country. Side effects: each call uses one backlink lookup from the account's plan, and when no fresh stored profile exists it fetches fresh data from DataForSEO and replaces the stored backlinks for that domain (the list list_backlinks reads).
get_keyword_metrics
ChatGPTMAX 5 KEYWORDS PER CALL. Sending 6 or more returns a 400 validation error — split larger lists across multiple calls. KEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD for every keyword. If the target market is unknown, first call autocomplete_keywords or related_keywords; their results include locationCode/languageCode per suggestion, which you can then pass back here. Looks up search volume, CPC, KD, and intent for 1 to 5 keywords.
get_location_by_code
ChatGPTLook up a single location by its DataForSEO location code, e.g. 2840 for United States.
get_month_view
ChatGPTRead all posts scheduled in a given month, grouped for calendar display.
get_post
ChatGPTRead a single post (markdown body, FAQ, internal links, SEO score, status, schedule).
get_project
ChatGPTGet a single project by ID.
get_publication
ChatGPTRead a single publication snapshot including daily impression/click signals.
get_site_information
ChatGPTRead the project's site information record (brand, audience, pain points, CTAs).
get_translation_settings
ChatGPTRead the blog's configured languages and translation price.
get_translations
ChatGPTRead linked language versions, stale status and translation candidates for an article.
gsc_query_details
ChatGPTGSC performance for a specific list of queries.
gsc_status
ChatGPTGSC connection status for a project: connected/pending/invalid, bound site, last sync time. Call this before gsc_summary or gsc_top_* to detect a missing connection cheaply.
gsc_summary
ChatGPTAggregate GSC performance for the project over a window: clicks, impressions, CTR, avg position, deltas vs previous period.
gsc_top_pages
ChatGPTTop landing pages from GSC for a project.
gsc_top_queries
ChatGPTTop search queries from GSC for a project.
gsc_trend
ChatGPTDaily GSC trend (clicks, impressions, position) over a window.
keyword_gap
ChatGPTKeywords the competitor ranks for that the primary domain doesn't (highest-opportunity gap targets), or common keywords. Returns { totalCount, items }.
list_audit_issues
ChatGPTFiltered list of issues from an audit. Filter by category (on-page, technical, content, performance, ...) or severity (critical, warning, info).
list_audits_for_project
ChatGPTAll audits previously run for a project, newest first.
list_backlinks
ChatGPTPaginated list of individual backlinks pointing at the domain: source page URL and title, target URL, anchor text, dofollow flag, source domain/page rank, spam score, and first/last-seen dates. Call get_backlink_profile for the same domain first — this reads the stored links and returns an empty list until it has been fetched.
list_cities
ChatGPTList cities supported within a country. Country code is ISO 3166-1 alpha-2, e.g. "US".
list_competitors
ChatGPTList the project's tracked competitors.
list_countries
ChatGPTList supported DataForSEO country locations (location codes + ISO codes).
list_crawled_pages
ChatGPTTop crawled pages from the project's most recent completed audit (URL, title, meta, word count). Useful for fact-checking and finding internal-link targets.
list_domain_history
ChatGPTReturn the calling user's recent domain search history.
list_keyword_history
ChatGPTReturn the calling user's recent keyword search history.
list_languages
ChatGPTList supported languages (language code + display name).
list_posts
ChatGPTList posts for a project. Filter by status: Idea, Drafting, Ready, Approved, Published.
list_projects
ChatGPTList the calling user's VibeSEO projects.
list_publications
ChatGPTList published article snapshots (read-only history) for the project, with traffic signals.
mark_post_ready
ChatGPTMove an Idea or Drafting post whose body you wrote (with update_post) to Ready, without changing its text. Costs no credits and runs no AI generation. Call get_post first and pass its contentRevision as expectedRevision. Fails if the body is empty, the post is still being generated, its status is not Idea or Drafting, it was edited since you read it (then call get_post again), or another post in the project already uses its slug (change the slug with update_post first). Then approve_post queues it for publication. Returns the updated post.
preposition_keywords
ChatGPTSuggestions containing prepositions (for/with/near/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
publish_post_now
ChatGPTPublish a post to the project's connected site (its blog or CMS) immediately. Only call it when the user asks to publish now. An Approved post goes live now instead of at its scheduled time. A Published post is republished, replacing the live version with its latest edits (use it after update_post when the post shows hasUnpublishedChanges). Works only on Approved or Published posts: approve a Ready post with approve_post first. A translated article cannot be published this way; it goes live through approve_translation once its original is published. Publishing runs in the background and takes a few seconds: the returned post may still show the old state, so confirm with get_post (status Published, hasUnpublishedChanges false). Returns the post.
question_keywords
ChatGPTQuestion-format suggestions (what/how/why/when/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Useful for FAQ and informational content.
refill_queue
ChatGPTQueue an async strategist job that appends new Idea-status posts to the queue (additive — does not touch existing posts). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.
refresh_ideas
ChatGPTQueue an async strategist job that replaces existing Idea-status posts with a fresh batch (Drafting/Ready/Approved/Published are untouched). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.
reject_post
ChatGPTReject a Ready post: clears the body and returns it to Drafting with the reason recorded. Returns the updated post.
related_keywords
ChatGPTSynonym-expansion related keywords for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Each suggestion comes back with its own locationCode/languageCode — use this tool (or autocomplete_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty.
replace_competitors
ChatGPTReplace the project's competitor list with the supplied set of domains. Returns the new competitor list.
save_translation_settings
ChatGPTSave the primary language and translation languages together. Read get_translation_settings first; include the enabled primary language and keep existing disabled languages in the list. Supply primaryLanguage when the project has none; omit it to preserve the current language. Renderer URLs are managed automatically. Saving settings does not generate articles or charge credits. Enabled additional languages generate reviewable translations of future originals at 20 credits per language; existing articles are not translated automatically.
schedule_post
ChatGPTSet or change the scheduled_for date on a post (Idea, Drafting, or Ready). Returns the updated post. To remove a scheduled date, call unschedule_post instead.
score_keyword
ChatGPTScore a candidate keyword against this project's archetype to get a 0-100 priority score with breakdown. The keyword must already appear in the project's top-100 ranking set.
search_locations
ChatGPTSearch countries and cities by name. Useful for resolving a city name to its DataForSEO location code.
start_site_audit
ChatGPTTrigger a new site audit (crawl + on-page/technical analysis). Runs asynchronously; poll get_audit until status="completed".
translate_articles
ChatGPTTranslate selected original posts into configured languages. Each new or refreshed translation costs 20 credits and requires review before publication. Refresh creates a candidate without overwriting manual edits. Returns the ids of the translated articles; translation runs in the background, so read them with get_translations and publish with approve_translation.
unschedule_post
ChatGPTClear the scheduled_for date on a post (Idea, Drafting, or Ready), returning it to the unscheduled state. Returns the updated post. Content is preserved.
update_post
ChatGPTEdit a post's text, SEO fields and images. Call get_post first and pass its contentRevision as expectedRevision. Only the fields you pass change; omitted, null or empty fields keep their current value. To remove an optional field, name it in clearFields. If the post was edited since you read it (in the web editor or by another call), the update fails with a conflict: call get_post again and reapply your changes to the new text instead of retrying blindly. A post that is still being generated (Drafting) cannot be edited. Editing costs no credits. Editing an Approved post changes what VibeSEO publishes to the project's connected site at its scheduled time. Editing a Published post does not change the live site: the post shows hasUnpublishedChanges until it is republished from the VibeSEO web app. Editing an original article marks its translations outdated: refresh them with translate_articles (refresh=true), then apply_translation_update and approve_translation; refreshed translations take the original's hero and OG images. Returns the updated post.
approve_post
Claudeautocomplete_keywords
Claudebacklink_history
Claudecomparison_keywords
Claudecompetitive_overview
Claudedomain_competitor_suggestions
Claudedomain_overview
Claudedomain_top_keywords
Claudedomain_top_pages
Claudedomain_traffic_history
Claudegenerate_post
Claudeget_audit
Claudeget_audit_summary
Claudeget_backlink_profile
Claudeget_keyword_metrics
Claudeget_location_by_code
Claudeget_month_view
Claudeget_post
Claudeget_project
Claudeget_publication
Claudeget_site_information
Claudegsc_query_details
Claudegsc_status
Claudegsc_summary
Claudegsc_top_pages
Claudegsc_top_queries
Claudegsc_trend
Claudekeyword_gap
Claudelist_audit_issues
Claudelist_audits_for_project
Claudelist_backlinks
Claudelist_cities
Claudelist_competitors
Claudelist_countries
Claudelist_crawled_pages
Claudelist_domain_history
Claudelist_keyword_history
Claudelist_languages
Claudelist_posts
Claudelist_projects
Claudelist_publications
Claudepreposition_keywords
Claudequestion_keywords
Clauderefill_queue
Clauderefresh_ideas
Claudereject_post
Clauderelated_keywords
Claudereplace_competitors
Claudeschedule_post
Claudescore_keyword
Claudesearch_locations
Claudestart_site_audit
Claudeunschedule_post
Claude