Business & Operations

SearchFit

by SearchFIT

Overview

SearchFit tracks how a brand appears in AI assistant answers and helps close the gaps. See whether ChatGPT, Perplexity, Gemini, Claude and Google AI mention your brand for the questions buyers actually ask, and how you compare with competitors. From there, generate and publish articles to a connected CMS, research keywords, audit a site for technical problems, and report on Google Search Console and Google Analytics 4 alongside AI visibility. Requires a SearchFit account with at least one brand.

Tools

add_competitor

ChatGPT

Add a competitor by domain, discover them from the brand's own domain, or import the ones the AI engines named.

add_keywords

ChatGPT

Start tracking one or more keywords for a brand.

analytics_run_report

ChatGPT

Run a Google Analytics 4 report. Returns rows grouped by dimensions (e.g. ['date','pagePath']) with the requested metrics (e.g. ['sessions','totalUsers','screenPageViews']). Dates accept YYYY-MM-DD.

bulk_create_content

ChatGPT

Queue generation of many articles at once for the given locales. Returns jobs to poll.

bulk_update_content

ChatGPT

Apply the same change to up to 200 content items.

cancel_audit

ChatGPT

Cancel a running audit, or resume a cancelled one.

cancel_prompt_scan

ChatGPT

Cancel a scan that is still running.

check_page_frameable

ChatGPT

Whether a URL can be embedded in an iframe, which decides if SearchFit can preview it.

create_content

ChatGPT

Create a content item. With prompt it queues AI generation and returns a job to poll via get_content_job_status; with title and type alone it creates a plain record. title is honoured exactly when given.

create_tracked_prompts

ChatGPT

Start tracking one or more prompts for a brand. Pass a single prompt, or prompts for a batch of up to 100.

delete_content

ChatGPT

Delete content. Pass content_id for one item, or content_ids for up to 200. This cannot be undone.

delete_keyword

ChatGPT

Stop tracking a keyword and remove it.

delete_media_asset

ChatGPT

Remove an asset from the media library.

delete_pages

ChatGPT

Remove pages from a brand's page list by URL. Does not touch the live site.

delete_tracked_prompt

ChatGPT

Stop tracking a prompt. Its historical scan results are kept.

discover_keywords

ChatGPT

Find keywords a brand is not tracking yet. With seed it returns ideas around that term; with track it starts tracking a single keyword.

export_content

ChatGPT

Export content out of SearchFit. squarespace builds a WXR file for manual import (Squarespace has no publish API). Otherwise lists or creates export records for a content item.

generate_alt_text

ChatGPT

Write alt text for an image with AI. Pass keyword to target it at a search term. Pair with import_assets_from_audit to fix a whole site's missing alt text.

generate_image

ChatGPT

Generate a standalone image from a prompt. Use set_article_image to attach one to an article instead.

generate_reddit_comment

ChatGPT

Draft a comment for a Reddit opportunity. Returns the draft only; posting is done by the user.

generate_topic_suggestions

ChatGPT

Suggest article topics for a brand. Pass count for a themed batch, or current_topic to get adjacent ideas.

get_ai_visibility_metrics

ChatGPT

AI visibility as a time series: totals, the daily trend, and the split by AI engine. Complements get_visibility_overview, which is prompt-level.

get_audience_breakdown

ChatGPT

Search traffic split by country or by device.

get_audit

ChatGPT

An audit's status and summary. Pass audit_id for one audit, or brand_id for the brand's audit history.

get_audit_assets

ChatGPT

Assets an audit found (images, video, fonts), with size and status. Images here are what import_assets_from_audit pulls into the media library.

get_audit_issues

ChatGPT

The problems an audit found, by severity. This is the main output of a crawl.

get_audit_links

ChatGPT

Links an audit found, filterable by status. Use this to find broken links and redirect chains.

get_audit_pages

ChatGPT

Pages an audit crawled, with their status codes and metadata. Pass page_id for one page's full detail.

get_backlinks

ChatGPT

Backlinks pointing at a brand. Pass referring_domain_id for one domain's links, overview: true for headline counts, or anchors: true for anchor-text distribution.

get_brand

ChatGPT

Get one brand's full profile: website, description, target audience, and configuration. Use list_brands first to get the brand_id.

get_competitor_analysis

ChatGPT

Which competitors the AI engines name. Pass scan_id for one scan's competitors, or brand_id for everyone discovered across all scans.

get_content

ChatGPT

One content item in full, including its body.

get_content_job_status

ChatGPT

Whether a content item's generation job has finished, failed, or is still running. Poll this after create_content or regenerate_article.

get_ga4_events

ChatGPT

GA4 events for a brand over a date range.

get_ga4_metrics

ChatGPT

GA4 totals for a brand, and optionally the daily series behind them.

get_ga4_traffic_breakdown

ChatGPT

GA4 traffic split by one dimension: top pages, entry pages, exit pages, referrers, devices, or geography.

get_keyword_ranking_history

ChatGPT

How a brand's keyword positions have moved over a date range.

get_page_suggestions

ChatGPT

Optimization suggestions generated for one page.

get_prompt_analytics

ChatGPT

Visibility history and per-engine breakdown for a single tracked prompt.

get_published_content_urls

ChatGPT

URLs of the brand's published SearchFit content, for tying content back to search performance.

get_reddit_stats

ChatGPT

Reddit monitoring stats for a brand: opportunities found, acted on, dismissed.

get_referring_domains

ChatGPT

Domains linking to a brand, with authority ratings. top: true returns the strongest ones.

get_scan_results

ChatGPT

Raw per-engine answers from a completed scan: what each AI engine actually said, and whether the brand was mentioned.

get_scan_status

ChatGPT

Progress of one scan. Pass scan_id, or omit it and pass brand_id to list every scan currently running for the brand.

get_search_performance

ChatGPT

Google Search Console totals for a brand, and the day-by-day series behind them: clicks, impressions, CTR, average position.

get_sentiment_analysis

ChatGPT

How positively or negatively the AI engines described the brand in one scan.

get_top_pages

ChatGPT

The brand's pages earning the most search traffic.

get_top_queries

ChatGPT

The search queries bringing a brand the most traffic, with clicks, impressions, CTR and position.

get_visibility_insights

ChatGPT

Generated insights for a brand, and the market segments its scans fall into. Pass scan_id for that scan's segments.

get_visibility_overview

ChatGPT

Headline AI visibility for a brand: how often it appears across the tracked prompts and engines, and how that is trending.

get_workspace_details

ChatGPT

The workspaces you belong to: the plan each is on, its usage against that plan, and how many brands sit under it. Brands live inside a workspace, so this is the level at which billing and limits apply.

import_assets_from_audit

ChatGPT

Pull every distinct image found across all of a brand's audits into its media library. De-dupes, and keeps the newest version of each.

import_content

ChatGPT

Content imports for a brand. list shows past imports, items shows the rows of one import, create starts a new one.

import_sitemap_urls

ChatGPT

Populate a brand's page list from its sitemap. With discover it finds sitemap URLs for a domain first; with validate_url it checks one sitemap without importing.

list_ai_models

ChatGPT

The AI models available for content generation.

list_analytics_properties

ChatGPT

List GA4 properties on a connected Google account. Use the property_id returned here as the property_id for analytics_run_report. Universal Analytics properties are not returned (UA was sunset in 2023).

list_brands

ChatGPT

List the brands you have access to. Start here: every other SearchFit tool takes a brand_id from this list. Returns each brand's id, name, website, and owning workspace.

list_competitors

ChatGPT

Competitors tracked for a brand. Pass competitor_id for one, or include_dismissed to see hidden ones too.

list_connectors

ChatGPT

List the integrations connected to a brand (Webflow, WordPress, Google, Reddit, and so on), with the integration_id that publish_content needs. Credentials are never returned. To connect something new, the user does it in the dashboard.

list_content

ChatGPT

List a brand's content: articles, drafts, and opportunities. Filter by status or locale, and page through with page/page_size.

list_ga4_properties

ChatGPT

GA4 properties available to a brand's connected Google account. Keyed by brand, unlike list_analytics_properties which is keyed by connection.

list_google_connections

ChatGPT

List the Google accounts you have connected to SearchFit. Returns each connection's id (use it as connection_id in the other Google tools), the Google email, the OAuth scopes granted, the owning brand, and when it was connected.

list_keywords

ChatGPT

Keywords tracked for a brand, with volume and ranking data. Pass keyword_id for one keyword, or stats: true for aggregate counts instead of rows.

list_media_assets

ChatGPT

A brand's media library. Pass asset_id for one asset, or usage: true to see where that asset is used.

list_pages

ChatGPT

Pages SearchFit knows about for a brand, imported from its sitemap. Pass page_id for one page's detail.

list_publications

ChatGPT

Where a content item has been published, and the status of each attempt. Useful for diagnosing a failed publish.

list_reddit_opportunities

ChatGPT

Reddit threads where the brand could usefully join the conversation. Pass opportunity_id for one.

list_scans

ChatGPT

Past scans for a brand, newest first. Pass scan_id for one scan's detail instead.

list_search_console_sites

ChatGPT

List the Search Console properties (sites) on a connected Google account. Use the siteUrl returned here as the site_url for search_console_query.

list_tracked_prompts

ChatGPT

List the prompts being tracked for a brand across AI engines, with each prompt's latest visibility score. These are the questions SearchFit asks the AI engines to see whether the brand gets mentioned.

manage_media_folders

ChatGPT

Media library folders. list shows them, create adds one, rename and delete change one.

manage_reddit_keywords

ChatGPT

Keywords Reddit monitoring watches for. list shows them, add creates one, update and delete change one.

manage_tracked_competitors

ChatGPT

Curate the competitor list the AI engines surfaced. dismiss hides a name, restore un-hides it, confirm marks it a real competitor, unconfirm undoes that, and list_dismissed shows what is currently hidden.

manage_translations

ChatGPT

Translations and locales for a brand. locales lists configured locales, add_locale and remove_locale change them, missing finds untranslated content for a locale, and translate queues a translation of one item.

page_refresh_jobs

ChatGPT

Refresh jobs that regenerate a page's content. Lists a brand's jobs, or queues a new one for a page.

publish_content

ChatGPT

Publish a content item to a connected integration. Get integration_id from list_connectors, and shape publish_config using list_webflow_targets (collection id and field mapping) or list_wordpress_targets (category and author ids).

reddit_settings

ChatGPT

Reddit monitoring settings for a brand. Omit the optional fields to read them; pass any to update. generate_instructions writes brand-specific comment guidance with AI.

refresh_keyword_metrics

ChatGPT

Pull fresh volume and difficulty for a brand's keywords, or seed the list from the brand's own domain.

regenerate_article

ChatGPT

Rewrite an existing article. With fix_type it targets one weakness (images, keywords, links, wordcount, general); with new_title it regenerates against a new topic. Queues a job; poll get_content_job_status.

remove_competitor

ChatGPT

Stop tracking a competitor. dismiss hides it but keeps history; remove deletes it.

run_prompt_scan

ChatGPT

Queue a scan of the given tracked prompts across the AI engines. Returns immediately with a scan id: the scan itself runs in the background and can take many minutes. Poll get_scan_status, do not wait.

scan_urls

ChatGPT

Audit a specific list of URLs rather than crawling the whole sitemap. Up to 2000.

search_console_query

ChatGPT

Run a Search Console search-analytics query. Returns top queries with clicks, impressions, CTR, and average position. Pass dimensions: ['query'] for keywords, ['page'] for top pages, or ['query','page'] for both. Date range is up to 16 months back.

search_subreddits

ChatGPT

Find subreddits by name or topic, for choosing where to monitor. Also reports whether the Reddit connection is working.

set_article_image

ChatGPT

Give an article a featured image, or swap one of its inline images. Pass old_image_src to replace a specific image.

set_ga4_property

ChatGPT

Choose which GA4 property a brand reports from.

start_audit

ChatGPT

Queue a technical SEO crawl of a brand's site. Returns immediately with an audit id; the crawl runs in the background. Set max_pages to cap it.

suggest_tracking_prompts

ChatGPT

Generate prompt ideas worth tracking for a brand, based on its profile. Returns suggestions only; use create_tracked_prompts to start tracking them.

sync_backlinks

ChatGPT

Queue a backlink data refresh for a brand. Runs in the background.

sync_competitor_metrics

ChatGPT

Refresh one competitor's traffic and authority metrics.

sync_ga4

ChatGPT

Queue a GA4 sync for a brand, or check the current sync state. Syncs run in the background.

sync_search_console

ChatGPT

Queue a Search Console sync for a brand, or check the current sync state. Syncs run in the background.

trigger_reddit_scan

ChatGPT

Queue a Reddit scan for a brand's keywords. Runs in the background; check list_reddit_opportunities afterwards.

update_content

ChatGPT

Edit one content item's title, body, status, or metadata.

update_keyword

ChatGPT

Change a keyword's tracking flag or search intent.

update_media_asset

ChatGPT

Rename an asset or set its alt text by hand.

update_page_suggestion

ChatGPT

Accept or dismiss a page optimization suggestion.

update_reddit_opportunity

ChatGPT

Mark a Reddit opportunity completed or dismissed, or change its per-opportunity comment settings.

update_tracked_prompt

ChatGPT

Change a tracked prompt's text, category, or target location.

update_visibility_opportunity

ChatGPT

Mark a content opportunity surfaced by AI tracking as done or open again.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

100

Tools

Prompts

ChatGPT

Platforms