Common inputs and validation
What every tool input accepts, the global country and date filters, and the exact message you get when a value is rejected.
Last updated 2026-10-01
Summary#
Nearly every tool in Metric Vault takes a single value in a single field. This page lists the input shapes, the global filters that travel with every run, the exact placeholder each tool shows, and every validation message you can be shown, so you can tell a typo apart from a real failure.
Overview#
There are seven input shapes across the product.
| Shape | Example value | Used by |
|---|---|---|
| Domain | nike.com | Most analysis tools |
| Page URL | https://nike.com/mens-running | The page-level technical tools |
| Keyword | running shoes | Keyword and SERP tools |
| Topic or product description | email marketing | Content and ad-planning tools |
Two domains, separated by vs | yourdomain.com vs competitor.com | Gap Finder, Competitor Battle, Audience Overlap |
| Business name and city | Joe's Pizza, New York | GBP Audit |
| Pasted text | Your draft article | Pre-Publish Trust Checks, Live Writing Editor, GEO Content Scorer, Image Support, Localization |
You never need to type https://. If you leave the scheme off a domain, it is added for you before the tool runs. Typing it does no harm.
Pressing Enter in an input field runs the tool, exactly like clicking the run button.
Global filters#
Five settings are attached to every analysis run. Together with the tool and your query they define a unique run, which is what the already-ran prompt and the data cache both match on. Change one and you get a genuinely new run. See Result caching and freshness.
| Filter | Where it lives | Values | Default |
|---|---|---|---|
| Country | Topbar, next to the credit counter | Worldwide, plus 47 countries | United States |
| Date range | Topbar, appears only on time-series tools | 6M, 12M, 24M, 5Y, Custom | 6M |
| Minimum volume | Filter pills above the input on Keyword Explorer | Any, 100+, 1K+, 10K+, 100K+ | Any |
| Intent | Filter pills above the input on Keyword Explorer | All intents, Informational, Commercial, Transactional, Navigational | All intents |
| Device | Not adjustable | Desktop | Desktop |
The Range control appears on time-series screens only: Traffic Analytics, Market Map, Domain Overview, Top Pages, Audience Overlap, Rank Tracker, Backlink Profile, Organic Research, Brand Performance, Advertising Research, AdClarity, Shopping Ads, Social, Competitor Battle, Site Audit, Keyword Overview, AI Competitor Research, Visibility Overview, Prompt Tracking and Rank Alerts. Elsewhere it is hidden, because those tools do not return a time series.
The Minimum volume and Intent pills are stored in your browser and are remembered between visits.
Note: Analyses currently run against desktop results. There is no device toggle in the interface.
Worldwide#
Worldwide is the first entry in the country list. It is not a country, and it is not the default: a new account starts on United States, and Worldwide only applies once you choose it.
It asks for figures that are not tied to any one country. For a domain that means the total across every market we hold data for, not the figure for the largest one, so the traffic and keyword counts a Worldwide run reports are higher than any single country's. The run says how many markets went into the total.
Eight tools accept it:
| Tool | What Worldwide gives you |
|---|---|
| Organic Research | Keywords and traffic summed across every market |
| Traffic Intelligence | The same totals, as a trend |
| Content Decay Detector | Pages losing traffic in any market, not just one |
| Top Pages | Your best pages worldwide |
| Site Audit | The technical crawl, which never depended on a country |
| Backlink Profile | Links are counted per site and have no country |
| Backlink Gap | As above |
| Link Prospector | As above |
Every other tool asks you to pick a country, and says so instead of running:
This tool cannot run worldwide. Keyword difficulty, search intent and SERP positions only exist inside a single country, so there is no global figure for it to return. Pick a country in the market selector, or keep Worldwide and run one of these: ... Nothing was charged.
That is not a limitation we chose. A keyword's difficulty is how hard it is to rank in one country's results, and a position is a place in one country's search page, so neither has a worldwide value to report. A tool that showed you one anyway would be showing you some single country's number with a global label on it, which is exactly what the old Worldwide option did before it was removed. Nothing is charged for a refused run.
If you work across several markets, run the country you care about most and compare, or use one of the eight tools above for the global picture.
Input placeholders, by tool#
The placeholder text is the fastest guide to what a field expects.
Site Health#
| Tool | Placeholder |
|---|---|
| Site Audit | e.g. nike.com |
| On-Page SEO Checker | e.g. https://nike.com/mens-running |
| PageSpeed & Vitals | e.g. https://nike.com |
| robots.txt Auditor | e.g. nike.com |
| Schema Tool | e.g. https://nike.com/product |
| Security Headers | e.g. nike.com |
| Sitemap Validator | e.g. nike.com |
| Advanced Technical Checks | example.com |
| GBP Audit | e.g. Joe's Pizza, New York |
| Duplicate Content Audit | e.g. nike.com |
| Responsiveness | example.com |
| Redirect Chain (inside Advanced Technical Checks) | e.g. https://nike.com/old-page |
| Mixed Content (inside Advanced Technical Checks) | e.g. https://nike.com |
| Hreflang (inside Advanced Technical Checks) | e.g. https://nike.com |
| Tech Stack (inside Advanced Technical Checks) | e.g. nike.com |
Keyword & Content Research#
| Tool | Placeholder |
|---|---|
| Keyword Explorer | e.g. running shoes |
| Keyword Overview | e.g. running shoes |
| Gap Finder | yourdomain.com and competitor.com. Two domains, no more: the fields for a second and third rival were removed because the analysis never used them |
| Topic Map | e.g. email marketing |
| Content Decay Detector | e.g. nike.com |
| Internal Linking Engine | e.g. nike.com |
Competitors & Backlinks#
| Tool | Placeholder |
|---|---|
| Domain Overview | e.g. nike.com |
| Backlink Profile | e.g. nike.com |
| Competitor Battle | e.g. nike.com and Competitor (e.g., adidas.com) |
| Organic Research | e.g. nike.com |
| Traffic Analytics | e.g. nike.com |
| Top Pages | e.g. nike.com |
| SERP Features | e.g. best running shoes |
| Link Prospector | e.g. email marketing |
| Market Map | e.g. project management software |
| Audience Overlap | e.g. nike.com |
| Competitor Monitor | e.g. nike.com |
AI Visibility#
| Tool | Placeholder |
|---|---|
| Visibility Overview | e.g. nike.com |
| Competitor Research | e.g. crm software or salesforce.com |
| Prompt & Question Research | e.g. nike.com |
| Questions | e.g. nike.com |
| Brand Performance | e.g. nike.com |
| Brand Perception | e.g. nike.com |
| Narrative Drivers | e.g. nike.com |
| Prompt Tracking | e.g. nike.com |
| Google AI Overview Tracker | brand or domain (e.g. nike.com) |
| AI Citation Tracker | brand or domain (e.g. nike.com) |
| Forum & Reddit Visibility | brand or domain (e.g. nike.com) |
Write & Optimize#
| Tool | Placeholder | |
|---|---|---|
| Content Brief & Template | e.g. email marketing | |
| Content Template | e.g. how to start a podcast | |
| AI Article Generator | e.g. email marketing | |
| Content Optimizer | `e.g. your-url.com \ | target keyword` |
| Meta Generator | Describe the page (e.g., homepage for a CRM for small businesses) | |
| Content Repurposer | e.g. your article URL or a topic | |
| Live Writing Editor | Start writing… your score updates live as you type. | |
| GEO Content Scorer | Paste your article or section (Markdown or HTML is fine)… | |
| Image Support | Paste your article HTML (the <img> … |
Content Optimizer accepts three forms: a URL on its own, a keyword on its own, or a URL and keyword separated by a pipe. The pipe form is the most useful, because it scores your live page against a specific target keyword.
Promote#
| Tool | Placeholder |
|---|---|
| Social Analytics (Social Tracker) | e.g. nike.com |
| Social Analysis | e.g. nike.com |
| Social Composer | e.g. productivity tips for founders |
| Social Content | e.g. sustainable skincare |
| Brand Monitor | e.g. nike.com |
| Media Monitoring | e.g. nike.com |
| Influencer Analysis | e.g. fitness or a brand |
| PPC Research | e.g. running shoes |
| Advertising Intelligence | e.g. nike.com |
| AdClarity | e.g. nike.com |
| Ads Launch Assistant | e.g. project management software |
| Shopping Ads (PLA) | e.g. walmart.com |
Get Started and Track & Report#
| Screen | Placeholder |
|---|---|
| Growth Actions | yourdomain.com |
| Analyst AI | Ask anything about your SEO, content, or competitors… |
| Auto-Execute | content topic (e.g. email marketing) |
| Bulk Analysis | A list of domains, one per line |
| Rank Tracker | e.g. nike.com |
| Rank Alerts | e.g. nike.com and e.g., yourbrand.com |
| Scheduled Reports | e.g. nike.com and you@company.com — leave blank for in-app only |
Workflow launchers#
| Workflow | Fields |
|---|---|
| Competitor Intelligence | competitor domain (e.g. adidas.com), Your domain (for gap analysis, optional) |
| Keyword Strategy | seed keyword or domain (e.g. running shoes) |
| Content Engine | Content topic (e.g., best running shoes for marathons) |
| Brand Health | brand domain (e.g. nike.com) |
| Technical SEO | domain or URL (e.g. nike.com) |
| Advertising Intelligence | domain or URL (e.g. nike.com) |
Tools that need two values#
Three tools compare two things, and both halves are required.
| Tool | How to enter it | If a half is missing |
|---|---|---|
| Gap Finder | Two fields, joined for you as you vs competitor. Up to three competitors. | The run returns an honest empty result rather than an error. |
| Competitor Battle | Two fields, joined as A vs B. | The comparison cannot be built and returns empty. |
| Audience Overlap | One field, split on vs or a comma, plus optional extra fields. Up to three competitors. | You get the recommendation Enter at least two domains to compare, e.g. "asana.com vs monday.com". |
Validation and error messages#
From the tool screen#
| Message | Meaning |
|---|---|
Enter a value first. | The input field was empty when you pressed Run. |
Please sign in to run this tool. | You are signed out. |
Monthly limit reached — upgrade to continue. | Your premium allowance is spent. |
Something went wrong. | The run failed without a specific message. Try again. |
From a workflow launcher#
| Message | Which workflow |
|---|---|
Enter a competitor domain first. | Competitor Intelligence, Advertising Intelligence |
Enter a seed keyword first. | Keyword Strategy |
Enter a content topic first. | Content Engine |
Enter a brand name first. | Brand Health |
Enter a URL first. | Technical SEO |
Please fill in the required field. | Fallback wording |
From the server, about your value#
| Message | Meaning |
|---|---|
Missing url | The request arrived without a target. Re-enter the value. |
Invalid URL | The value could not be read as a web address at all. |
Only http(s) URLs are allowed | The address used a scheme other than http or https. |
That host is not allowed | The address points at a private, local or internal host. Public addresses only. |
Enter a competitor domain to compare against. | The free SEO comparison tool was given only one domain. |
From the text tools#
| Message | Meaning |
|---|---|
Paste at least a couple of sentences to check. | Plagiarism and Fact Check need at least 25 words. |
Too many strings (max 100 per request) | The translation tool was given more than 100 separate strings. |
Payload too large (max 20000 chars per request) | The translation request exceeded 20,000 characters. |
From the responsiveness analyzer#
| Message | Meaning |
|---|---|
Enter a valid website address, for example example.com | The address could not be parsed. |
That site took too long to respond… | The target did not answer in time. |
That site returned HTTP <n>… | The target answered with an error status. |
That page returned almost no HTML… | The page was empty or entirely rendered by scripts. |
Could not read the AI response. Please run the analysis again. | The analysis came back unusable. Re-run. |
Tip: A message that names your value is a validation problem you can fix. A message about limits, plans or availability is an account or service problem. Error message reference lists every error string in the product.
See also
Was this article helpful?
Thanks — feedback noted for the docs team.