# IQRush

> User guides for IQRush: measure how your brand appears in AI answers and decide what to work on next.

- [IQRush user guides](https://docs.iqrush.ai/index.md): Measure how your brand appears in AI answers, check the strength of the evidence, and decide what to work on next.
- [Start here](https://docs.iqrush.ai/guides/01-start-here.md): IQRush helps you measure how your brand appears in AI answers and decide what to work on next.
- [Create your first project](https://docs.iqrush.ai/guides/02-create-project.md): Set up a project around the brand and subject you want to understand.
- [Choose where your prompts come from](https://docs.iqrush.ai/guides/03-prompt-sources.md): A prompt is a question IQRush asks an AI engine during a run.
- [Review and find prompts](https://docs.iqrush.ai/guides/04-review-prompts.md): Review the questions before your first run.
- [Run a project and set a schedule](https://docs.iqrush.ai/guides/05-runs-and-schedules.md): A run measures the project at a point in time.
- [Explore your project with Agent Q](https://docs.iqrush.ai/guides/23-agent-q.md): Agent Q helps you explore IQRush through a conversation.
- [Explore your project with ChatGPT or Claude](https://docs.iqrush.ai/guides/30-connected-assistants.md): Connect ChatGPT or Claude to IQRush when you want to explore project results in the assistant you already use.
- [Questions and reports to explore](https://docs.iqrush.ai/guides/31-questions-and-reports.md): Start with the decision you want to make.
- [Understand your first results](https://docs.iqrush.ai/guides/06-understand-results.md): Start with Overview to see the main findings.
- [See which websites AI answers cite](https://docs.iqrush.ai/guides/07-citations.md): Open Insights → Citations to understand the sources used in your project’s measured answers.
- [See where your brand is mentioned](https://docs.iqrush.ai/guides/08-mentions.md): Open Insights → Mentions to see which brands, products, and other named entities appear in the measured answers.
- [Understand what AI answers say about your brand](https://docs.iqrush.ai/guides/09-sentiment.md): Open Insights → Sentiment to review the tone of recorded brand mentions.
- [Compare your position in a run](https://docs.iqrush.ai/guides/10-distribution.md): Open Analytics → Distribution analysis to see your position in one run.
- [See what changed between runs](https://docs.iqrush.ai/guides/11-trends.md): Open Analytics → Trend analysis after at least two runs have completed.
- [Find where your results are stronger or weaker](https://docs.iqrush.ai/guides/12-factor-diagnostics.md): Open Analytics → Factor diagnostics when an overall result leaves you asking, “Where should we look more closely?”
- [Inspect an individual webpage](https://docs.iqrush.ai/guides/13-webpage-analysis.md): Use Webpage analysis to inspect how a page relates to the AI answers in your project.
- [Choose a recommendation to work on](https://docs.iqrush.ai/guides/14-choose-recommendations.md): Open Recommendations to turn the results into a practical task.
- [Prepare a clear content brief](https://docs.iqrush.ai/guides/15-content-brief.md): A content brief tells the writer who the content is for, what it needs to accomplish, and what it should include.
- [Create, open, and find content](https://docs.iqrush.ai/guides/16-find-content.md): Open Content in the left menu.
- [Write and edit in Content Playground](https://docs.iqrush.ai/guides/17-write-content.md): Content Playground is the editor where you turn a brief or existing page into a working draft.
- [Check a draft and improve its weak sections](https://docs.iqrush.ai/guides/18-content-analysis.md): Use Content analysis beside the editor to understand how the current draft relates to the project’s measured AI answers and to review content-readiness checks.
- [Save and return to a document version](https://docs.iqrush.ai/guides/19-history.md): 2.
- [Review and export finished content](https://docs.iqrush.ai/guides/20-review-export.md): Before handing off a draft, check the facts, the brief, and the text your reader will see.
- [Work through a technical recommendation](https://docs.iqrush.ai/guides/21-technical-recommendations.md): Technical recommendations describe changes to your website, such as a page title or meta description.
- [Record completed work and check what happened next](https://docs.iqrush.ai/guides/22-complete-recommendations.md): Keep the recommendation’s status aligned with the work that has actually happened.
- [Manage project settings](https://docs.iqrush.ai/guides/24-project-settings.md): Select Project settings, the gear beside Runs, to review the project’s configuration.
- [Manage your account, workspaces, and people](https://docs.iqrush.ai/guides/25-workspaces-and-people.md): Use the profile menu at the bottom left to open Settings.
- [Check credits and plan limits](https://docs.iqrush.ai/guides/26-credits.md): Credits and plan access determine which work you can run in the account.
- [Manage a Google Analytics connection](https://docs.iqrush.ai/guides/27-google-analytics.md): The Google Analytics integration links analytics properties to IQRush projects.
- [Common questions and quick fixes](https://docs.iqrush.ai/guides/28-common-questions.md): Use the checks below before changing a project or starting another run.
- [A short glossary](https://docs.iqrush.ai/guides/29-glossary.md): These definitions explain the terms you will meet while using IQRush.
- [Build with IQRush](https://docs.iqrush.ai/developers/guides/01-start-here.md): Use IQRush measurement data in an assistant, a reporting workflow, or your own application. These guides cover the MCP connector and the HTTP read interface used by configured integrations.
- [Make your first MCP calls](https://docs.iqrush.ai/developers/guides/02-mcp-quickstart.md): Retrieve one measurement and the information needed to interpret it. You need an authorized MCP connection and a project with a completed run.
- [Connect ChatGPT or Claude](https://docs.iqrush.ai/developers/guides/03-connect-assistants.md): Connect an assistant to your IQRush account so it can retrieve data for the projects you can access. Use the connection details from the same environment as your data.
- [Make your first HTTP request](https://docs.iqrush.ai/developers/guides/06-http-quickstart.md): Read your project list from your own backend using the IQRush MCP HTTP API. You need a valid bearer access token obtained for your integration and the matching environment.
- [Build your first report with Python or JavaScript](https://docs.iqrush.ai/developers/guides/24-report-starter.md): Discover projects, select a measurement, and produce the same small report in either language.
- [Authentication and permissions](https://docs.iqrush.ai/developers/guides/04-authentication.md): IQRush remote MCP uses a browser authorization flow. Your client receives a bearer access token and uses it for requests on your behalf.
- [Build a custom MCP client](https://docs.iqrush.ai/developers/guides/05-custom-mcp-client.md): Use a compatible MCP client library to connect your application to IQRush. The remote endpoint speaks Streamable HTTP; it is not a plain REST endpoint.
- [Choose projects and measurement runs](https://docs.iqrush.ai/developers/guides/07-projects-and-runs.md): A project defines the market and questions you measure. A run is one measurement of that project. Keep the project and run IDs with every report so someone else can retrieve the same evidence.
- [Choose filters, groups, and subjects](https://docs.iqrush.ai/developers/guides/08-filters-and-subjects.md): Use filters to select the answers you want to examine, groups to split the result, and a subject to choose the brands or sources returned.
- [Handle responses, metrics, and units](https://docs.iqrush.ai/developers/guides/09-responses-and-metrics.md): Keep a metric's value, confidence interval, scope, and availability together. That is what makes the result useful outside IQRush.
- [Preserve decision-grade measurement](https://docs.iqrush.ai/developers/guides/10-stability.md): Use stability and uncertainty to decide how much weight a measurement can carry. A precise-looking percentage is not enough on its own.
- [Compare measurements without mistaking noise for change](https://docs.iqrush.ai/developers/guides/11-compare-measurements.md): Use comparison tools when the question is whether a result changed. Two percentages, or two separate confidence intervals, are not a test of the difference.
- [Retrieve complete results](https://docs.iqrush.ai/developers/guides/12-pagination.md): Different tools limit results in different ways. Use the mechanism the tool actually provides, and tell report readers when you have returned only part of the data.
- [Handle errors and unavailable data](https://docs.iqrush.ai/developers/guides/13-errors.md): Check the transport, the tool result, and the IQRush payload before treating a response as data. A successful HTTP status can still contain an application error.
- [Protect credentials and customer data](https://docs.iqrush.ai/developers/guides/18-security.md): Build the integration so that access stays with the authorized user and reports expose only the information their audience needs.
- [Manage compatibility and interface differences](https://docs.iqrush.ai/developers/guides/19-compatibility.md): Keep a small set of contract checks in your integration so an added field or a changed deployment does not silently change a report.
- [Use Google Analytics and Search Console data](https://docs.iqrush.ai/developers/guides/14-google-data.md): Combine AI visibility with website traffic when the project has a connected Google property. Visibility measurements and referral traffic answer different questions and must keep their own dates and units.
- [Retrieve page evidence and technical recommendations](https://docs.iqrush.ai/developers/guides/15-content-and-technical.md): Use the page and source interfaces to help a developer or content team understand what to inspect next. Keep measured page evidence separate from an assistant's proposed edits.
- [Choose a report and its evidence](https://docs.iqrush.ai/developers/guides/16-report-recipes.md): Use the same IQRush data to answer different business questions. The report is a choice of scope and presentation, not a separate measurement mode for every industry.
- [Work through a visibility report](https://docs.iqrush.ai/developers/guides/17-worked-example.md): This example shows how the same data becomes a clear report without losing its measurement context. It uses the Colorescience Dev project checked on 4 October 2026. The figures are illustrative project results, not a claim about current production performance.
- [Compare brand visibility](https://docs.iqrush.ai/developers/recipes/report-competitors.md): Compare brands under the same measured conditions.
- [Review distribution-channel visibility](https://docs.iqrush.ai/developers/recipes/report-distribution.md): See which retailer, marketplace, and distributor sources appear in measured answers.
- [Find publisher and expert-source opportunities](https://docs.iqrush.ai/developers/recipes/report-publishers.md): Identify cited sources that support brands and deserve closer review.
- [Review product-page visibility](https://docs.iqrush.ai/developers/recipes/report-product-pages.md): Connect product-page citations to their answer evidence.
- [Prepare a content and technical handoff](https://docs.iqrush.ai/developers/recipes/report-content.md): Turn observed page evidence into a clear list of items to review.
- [Review financial-services and banker perspectives](https://docs.iqrush.ai/developers/recipes/report-financial-services.md): Use measured topics and personas to examine how a firm is represented.
- [HTTP read reference](https://docs.iqrush.ai/developers/guides/20-http-reference.md): Find a read operation, its parameters, and the response fields to use.
- [Developer glossary](https://docs.iqrush.ai/developers/guides/21-glossary.md): Use these terms consistently in your application and reports.
- [Availability, limits, and unsupported operations](https://docs.iqrush.ai/developers/guides/22-availability.md): Build around the capabilities exposed by your connected environment. A supported request can still return unavailable data when the selected run or linked account does not contain what it needs.
- [MCP tool index](https://docs.iqrush.ai/developers/guides/23-tool-index.md): Find the right IQRush MCP tool for your task.
- [Start a session](https://docs.iqrush.ai/developers/tools/start_session.md): Discover projects, or resolve the latest run for one project.
- [List projects](https://docs.iqrush.ai/developers/tools/list_projects.md): Find the projects available to the signed-in user.
- [Get a project](https://docs.iqrush.ai/developers/tools/get_project.md): Read the selected project and its brand context.
- [List measurement runs](https://docs.iqrush.ai/developers/tools/list_runs.md): Find measurement runs for a project, newest first.
- [Get a measurement run](https://docs.iqrush.ai/developers/tools/get_run.md): Read execution status, data-family readiness, and available run counts.
- [List dimension options](https://docs.iqrush.ai/developers/tools/list_dimension_options.md): Discover the filter labels available for the project.
- [Check query budget options](https://docs.iqrush.ai/developers/tools/valid_query_budgets.md): Find candidate query counts for a proposed set of measurement dimensions.
- [Saved baseline compatibility](https://docs.iqrush.ai/developers/tools/list_baselines.md): Recognize the compatibility response for saved baselines.
- [Read citation scores](https://docs.iqrush.ai/developers/tools/get_citation_score.md): Read citation share or citation coverage for domains or pages.
- [Read mention scores](https://docs.iqrush.ai/developers/tools/get_mention_score.md): Read how often an entity is named, or its recorded mention count.
- [Read sentiment](https://docs.iqrush.ai/developers/tools/get_sentiment.md): Read positive, negative, neutral, or net sentiment for scored entities.
- [Read groundedness](https://docs.iqrush.ai/developers/tools/get_groundedness.md): Read the extent to which measured brand mention statements have citation support.
- [Read visibility alignment](https://docs.iqrush.ai/developers/tools/get_visibility_alignment.md): Bring mention presence and citation support into one brand assessment.
- [Check results stability](https://docs.iqrush.ai/developers/tools/get_results_stability.md): Check whether one measurement has converged for the requested scope.
- [Read headline metrics](https://docs.iqrush.ai/developers/tools/get_job_summary.md): Read headline metrics for the selected run.
- [Read an executive summary](https://docs.iqrush.ai/developers/tools/get_executive_summary.md): Retrieve a broader set of summary measurements for a report.
- [Read grounding sources](https://docs.iqrush.ai/developers/tools/get_grounding_sources.md): Find which sources support the measured brand statements.
- [Find brands supported by a source](https://docs.iqrush.ai/developers/tools/get_brands_grounded_by_source.md): Find the brands whose mentions are supported by a selected source.
- [Compare source overlap](https://docs.iqrush.ai/developers/tools/compare_grounding_sources.md): Compare the sources that support your brand and competitors.
- [Read mention statements](https://docs.iqrush.ai/developers/tools/list_mention_statements.md): Retrieve answer statements that mention selected brand terms.
- [Read measured queries](https://docs.iqrush.ai/developers/tools/list_queries.md): Read the actual questions included in a run.
- [Read cited page targets](https://docs.iqrush.ai/developers/tools/get_placement_targets.md): Read a page of source URLs ranked by citation share.
- [Read brand co-mentions](https://docs.iqrush.ai/developers/tools/get_comention_network.md): Find brand pairs that appear together in measured statements.
- [Screen for citation drift](https://docs.iqrush.ai/developers/tools/screen_drift.md): Check how the citation landscape differs from a reference run.
- [Inspect source changes](https://docs.iqrush.ai/developers/tools/attribute_drift.md): Investigate source-level changes between a reference run and the selected run.
- [Compare one domain](https://docs.iqrush.ai/developers/tools/get_paired_contrast.md): Compare one domain’s citation share or count across two runs or two conditions.
- [Inspect rank movement](https://docs.iqrush.ai/developers/tools/get_rank_displacement.md): Read how source ranks move between a reference and checkpoint run.
- [Explore dimensions behind a result](https://docs.iqrush.ai/developers/tools/get_factor_analysis.md): Explore the available dimension-level analysis for a selected domain.
- [Find changes to investigate](https://docs.iqrush.ai/developers/tools/get_significant_findings.md): Collect candidate citation-share and rank changes for follow-up.
- [Read a metric over time](https://docs.iqrush.ai/developers/tools/get_metric_timeseries.md): Retrieve metric series across selected completed runs.
- [Summarize a metric trend](https://docs.iqrush.ai/developers/tools/get_trend_summary.md): Summarize first-to-latest movement over a run window.
- [Find the largest movers](https://docs.iqrush.ai/developers/tools/list_timeseries_movers.md): Rank selected metric series by their movement over a run window.
- [Check linked Google data](https://docs.iqrush.ai/developers/tools/list_ga4_properties.md): Read the Google property and Search Console site linked to a project.
- [Read a Google Analytics snapshot](https://docs.iqrush.ai/developers/tools/get_ga4_report.md): Read the latest stored website snapshot and available history.
- [Read available Google fields](https://docs.iqrush.ai/developers/tools/get_ga4_metadata.md): Find the metrics and dimensions represented in the stored Google data.
- [Read AI referral traffic](https://docs.iqrush.ai/developers/tools/get_ai_traffic_performance.md): Read sessions, users, and conversions attributed to tracked AI referral sources.
- [Read the AI referral funnel](https://docs.iqrush.ai/developers/tools/get_ecommerce_funnel.md): Read the ecommerce stages recorded for AI-referred activity.
- [Read AI-referred product performance](https://docs.iqrush.ai/developers/tools/get_product_performance.md): Read product activity and revenue represented in the AI referral data.
- [List AI traffic sources](https://docs.iqrush.ai/developers/tools/get_ai_traffic_sources.md): Read the reference list of tracked AI traffic sources.
- [Read Search Console performance](https://docs.iqrush.ai/developers/tools/get_search_console_data.md): Read stored organic query performance for the linked Search Console site.
- [Read page content evidence](https://docs.iqrush.ai/developers/tools/analyze_page_performance.md): Retrieve captured page sections and the answer statements citing the page.
- [Read technical page features](https://docs.iqrush.ai/developers/tools/get_technical_features.md): Retrieve recorded features for a page in the selected measurement.
- [Request an analysis plan](https://docs.iqrush.ai/developers/tools/analytics_mode.md): Return a plan for a report the user explicitly requested.
- [List projects — HTTP](https://docs.iqrush.ai/developers/http/http-list-projects.md): Find the projects available to the signed-in user.
- [Get a project — HTTP](https://docs.iqrush.ai/developers/http/http-get-project.md): Read the selected project and its brand context.
- [Saved baseline compatibility — HTTP](https://docs.iqrush.ai/developers/http/http-list-baselines.md): Recognize the compatibility response for saved baselines.
- [List dimension options — HTTP](https://docs.iqrush.ai/developers/http/http-list-dimension-options.md): Discover the filter labels available for the project.
- [List AI traffic sources — HTTP](https://docs.iqrush.ai/developers/http/http-get-ai-traffic-sources.md): Read the reference list of tracked AI traffic sources.
- [Read AI referral traffic — HTTP](https://docs.iqrush.ai/developers/http/http-get-ai-traffic-performance.md): Read sessions, users, and conversions attributed to tracked AI referral sources.
- [Read the AI referral funnel — HTTP](https://docs.iqrush.ai/developers/http/http-get-ecommerce-funnel.md): Read the ecommerce stages recorded for AI-referred activity.
- [Read AI-referred product performance — HTTP](https://docs.iqrush.ai/developers/http/http-get-product-performance.md): Read product activity and revenue represented in the AI referral data.
- [Read available Google fields — HTTP](https://docs.iqrush.ai/developers/http/http-get-ga4-metadata.md): Find the metrics and dimensions represented in the stored Google data.
- [Check linked Google data — HTTP](https://docs.iqrush.ai/developers/http/http-list-ga4-properties.md): Read the Google property and Search Console site linked to a project.
- [Read a Google Analytics snapshot — HTTP](https://docs.iqrush.ai/developers/http/http-get-ga4-report.md): Read the latest stored website snapshot and available history.
- [Read Search Console performance — HTTP](https://docs.iqrush.ai/developers/http/http-get-search-console-data.md): Read stored organic query performance for the linked Search Console site.
- [List measurement runs — HTTP](https://docs.iqrush.ai/developers/http/http-list-runs.md): Find measurement runs for a project, newest first.
- [Get a measurement run — HTTP](https://docs.iqrush.ai/developers/http/http-get-run.md): Read execution status, data-family readiness, and available run counts.
- [Inspect source changes — HTTP](https://docs.iqrush.ai/developers/http/http-attribute-drift.md): Investigate source-level changes between a reference run and the selected run.
- [Find brands supported by a source — HTTP](https://docs.iqrush.ai/developers/http/http-get-brands-grounded-by-source.md): Find the brands whose mentions are supported by a selected source.
- [Read citation scores — HTTP](https://docs.iqrush.ai/developers/http/http-get-citation-score.md): Read citation share or citation coverage for domains or pages.
- [Compare source overlap — HTTP](https://docs.iqrush.ai/developers/http/http-compare-grounding-sources.md): Compare the sources that support your brand and competitors.
- [Read brand co-mentions — HTTP](https://docs.iqrush.ai/developers/http/http-get-comention-network.md): Find brand pairs that appear together in measured statements.
- [Read an executive summary — HTTP](https://docs.iqrush.ai/developers/http/http-get-executive-summary.md): Retrieve a broader set of summary measurements for a report.
- [Explore dimensions behind a result — HTTP](https://docs.iqrush.ai/developers/http/http-get-factor-analysis.md): Explore the available dimension-level analysis for a selected domain.
- [Read groundedness — HTTP](https://docs.iqrush.ai/developers/http/http-get-groundedness.md): Read the extent to which measured brand mention statements have citation support.
- [Read grounding sources — HTTP](https://docs.iqrush.ai/developers/http/http-get-grounding-sources.md): Find which sources support the measured brand statements.
- [Read mention scores — HTTP](https://docs.iqrush.ai/developers/http/http-get-mention-score.md): Read how often an entity is named, or its recorded mention count.
- [Read mention statements — HTTP](https://docs.iqrush.ai/developers/http/http-list-mention-statements.md): Retrieve answer statements that mention selected brand terms.
- [Read page content evidence — HTTP](https://docs.iqrush.ai/developers/http/http-analyze-page-performance.md): Retrieve captured page sections and the answer statements citing the page.
- [Compare one domain — HTTP](https://docs.iqrush.ai/developers/http/http-get-paired-contrast.md): Compare one domain’s citation share or count across two runs or two conditions.
- [Read cited page targets — HTTP](https://docs.iqrush.ai/developers/http/http-get-placement-targets.md): Read a page of source URLs ranked by citation share.
- [Read measured queries — HTTP](https://docs.iqrush.ai/developers/http/http-list-queries.md): Read the actual questions included in a run.
- [Inspect rank movement — HTTP](https://docs.iqrush.ai/developers/http/http-get-rank-displacement.md): Read how source ranks move between a reference and checkpoint run.
- [Check results stability — HTTP](https://docs.iqrush.ai/developers/http/http-get-results-stability.md): Check whether one measurement has converged for the requested scope.
- [Screen for citation drift — HTTP](https://docs.iqrush.ai/developers/http/http-screen-drift.md): Check how the citation landscape differs from a reference run.
- [Read sentiment — HTTP](https://docs.iqrush.ai/developers/http/http-get-sentiment.md): Read positive, negative, neutral, or net sentiment for scored entities.
- [Find changes to investigate — HTTP](https://docs.iqrush.ai/developers/http/http-get-significant-findings.md): Collect candidate citation-share and rank changes for follow-up.
- [Read headline metrics — HTTP](https://docs.iqrush.ai/developers/http/http-get-job-summary.md): Read headline metrics for the selected run.
- [Read technical page features — HTTP](https://docs.iqrush.ai/developers/http/http-get-technical-features.md): Retrieve recorded features for a page in the selected measurement.
- [Read technical recommendations — HTTP](https://docs.iqrush.ai/developers/http/http-technical-recommendations.md): Read existing technical recommendations for a run, with optional URL, impact, and effort filters.
- [Read a metric over time — HTTP](https://docs.iqrush.ai/developers/http/http-get-metric-timeseries.md): Retrieve metric series across selected completed runs.
- [Find the largest movers — HTTP](https://docs.iqrush.ai/developers/http/http-list-timeseries-movers.md): Rank selected metric series by their movement over a run window.
- [Summarize a metric trend — HTTP](https://docs.iqrush.ai/developers/http/http-get-trend-summary.md): Summarize first-to-latest movement over a run window.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.