Finds, filters, and verifies local-business leads; every email carries a verification receipt.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional API-key alternative to the default OAuth login (mint one at app.noseforleads.com/keys)
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add an email or domain to the suppression list (scope is 'email' or 'domain') so future campaigns exclude it.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add an email or domain to the suppression list (scope is 'email' or 'domain') so future campaigns exclude it.
| Argument | Type | Description |
|---|---|---|
| scope* | string | |
| value* | string | |
| reason* | string |
{
"type": "object",
"title": "add_suppressionArguments",
"required": [
"scope",
"value",
"reason"
],
"properties": {
"scope": {
"type": "string",
"title": "Scope"
},
"value": {
"type": "string",
"title": "Value"
},
"reason": {
"type": "string",
"title": "Reason"
}
}
}Fetch a page of leads produced by a campaign (paginate with offset/limit). kept_only=True returns only rows the user marked kept in review (for export). match_status narrows to one population: 'validated' (verified email, billed) or 'needs_review' (surfaced free; rejection_reason says why) — omit it for both. Returns {summary, total, offset, limit, rows}; total counts the filtered population. Rows carry verification receipts (verified_by/verified_at/ verifier_verdict) when a live verification exists — treat them as the authoritative proof; null means no receipt, not a failure. Two more quotable proof lines appear where earned: person_receipt (who the person is and where we saw them launch, on person-target leads) and tech_receipt (dated evidence of the detected platform) — forward them as-is.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| job_id* | string | |
| offset | integer | |
| kept_only | boolean | |
| match_status | any |
{
"type": "object",
"title": "fetch_resultsArguments",
"required": [
"job_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 100
},
"job_id": {
"type": "string",
"title": "Job Id"
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"kept_only": {
"type": "boolean",
"title": "Kept Only",
"default": false
},
"match_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Match Status",
"default": null
}
}
}Check the status of a previously submitted campaign (queued/running/done/ done_partial/failed) by job_id. Prefer wait_seconds=45 over sleeping between polls: the call holds until the status or pipeline stage changes (or the timer expires) and returns the normal snapshot either way — loop on it until `status` is terminal. Out-of-range wait_seconds clamps to [0, 45], never errors.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | |
| wait_seconds | integer |
{
"type": "object",
"title": "get_campaign_statusArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id"
},
"wait_seconds": {
"type": "integer",
"title": "Wait Seconds",
"default": 0
}
}
}Check this tenant's prepaid credit balance (a validated lead costs 1 credit — 2 for person-target or Meta-ads campaigns), the available credit packs, and the ledger (paginate ledger entries with offset/limit, newest first). Campaigns cannot start with a zero balance — buy a pack via the dashboard when balance runs low. When you authenticate with an API key this also returns YOUR key's remaining budgets — check it before large campaigns.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"type": "object",
"title": "get_creditsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 50
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
}
}
}List the ICP packs (saved vertical/geo templates) available to this tenant.
No arguments.
{
"type": "object",
"title": "get_icp_packArguments",
"properties": {}
}Today's external vendor usage against the tenant's daily quota (vendor_calls_today / per_day_max / remaining). This is the OTHER ceiling besides credits: when remaining hits 0, campaign work pauses until midnight even with a healthy credit balance — check it before launching a large or urgent campaign. `remaining` is quota UNITS, which usually equals calls; a creator discovery costs one unit per delivered record, so it can consume far more than one call's worth. Mirrors REST GET /v1/usage.
No arguments.
{
"type": "object",
"title": "get_usageArguments",
"properties": {}
}List this tenant's campaigns, newest first — the recovery path when a job_id was lost: every row carries job_id, status, the query it ran, and credits spent, so you can resume polling (get_campaign_status) or fetch results without resubmitting (and double-charging). Filters: q (substring over vertical/geo), status (queued | running | done | done_partial | failed), created_after/ created_before (ISO-8601 window over creation time), order ('desc' default, 'asc' oldest first). Paginate with offset/limit (limit 1-200); `total` counts everything matching the filters, not just this page.
| Argument | Type | Description |
|---|---|---|
| q | any | |
| limit | integer | |
| order | string | |
| offset | integer | |
| status | any | |
| created_after | any | |
| created_before | any |
{
"type": "object",
"title": "list_campaignsArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50
},
"order": {
"type": "string",
"title": "Order",
"default": "desc"
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
},
"created_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created After",
"default": null
},
"created_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created Before",
"default": null
}
}
}Mark a lead kept or discarded after review (status: kept | discarded | unreviewed). Then fetch_results(kept_only=true) returns only kept leads — the export set.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | |
| status* | string | |
| result_id* | integer |
{
"type": "object",
"title": "review_leadArguments",
"required": [
"job_id",
"result_id",
"status"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id"
},
"status": {
"type": "string",
"title": "Status"
},
"result_id": {
"type": "integer",
"title": "Result Id"
}
}
}Send feedback to the Nose for Leads team. Set kind='product' for feedback about the leads, the service, coverage, or pricing — relay what the business owner tells you (categories: lead_quality, pricing, missing_feature, praise, other). Set kind='tool' (default) for feedback about these MCP tools themselves — a confusing description, a bug, a missing capability. Use freely; it's our main signal for improving the product and the agent experience.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| tool | any | |
| message* | string | |
| category | string |
{
"type": "object",
"title": "send_feedbackArguments",
"required": [
"message"
],
"properties": {
"kind": {
"enum": [
"tool",
"product"
],
"type": "string",
"title": "Kind",
"default": "tool"
},
"tool": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tool",
"default": null
},
"message": {
"type": "string",
"title": "Message"
},
"category": {
"enum": [
"bug",
"confusing",
"missing_feature",
"lead_quality",
"pricing",
"praise",
"other"
],
"type": "string",
"title": "Category",
"default": "other"
}
}
}Submit a lead-generation campaign. Pass translate_icp's `vertical`, `geo`, and `query` fields directly (category/location are ALIASES for vertical/geo, accepted so translate output round-trips; prefer vertical/geo when constructing calls). `query`'s full shape and field vocabulary are in this tool's schema — build it with translate_icp from free text (recommended), or construct it directly. An unknown predicate field (or rank), and any unknown `discovery` key, is rejected with a 422 naming it; an unknown top-level `query` key is silently ignored, so keep to predicates/rank/discovery — a typo there will not error, it will just do nothing. Costs 1 credit per validated lead — every campaign type, including founder/person campaigns and campaigns that filter on Meta ads. A campaign cannot overspend: if discovered leads exceed your balance it delivers what your credits cover and the campaign ends `done_partial`; check get_credits first if your balance is low. vertical/geo are REQUIRED except for a locationless campaign — `query` carrying a discovery block with mode 'launch_feeds' or 'web_search' — which has no geography at all. If the tenant has no card on file this returns a 403 `card_required` error with a `setup_url` — surface that URL to the user so they can verify a card (never charged unless they buy a pack). Pass a stable idempotency_key when you might retry — a retry returns the ORIGINAL campaign (idempotent_replay=true), never a duplicate charge. Returns {job_id, idempotent_replay}; poll get_campaign_status with job_id.
| Argument | Type | Description |
|---|---|---|
| geo | any | |
| query* | any | |
| category | any | |
| location |
Translate free-text ICP description (e.g. "plumbers in phoenix with no website") into a structured query. Call this BEFORE start_campaign — start_campaign only accepts a structured `query` dict, never free text. Returns {query, vertical, geo, category, location, preview, unsupported, discovery} — pass vertical/geo/query straight to start_campaign. `discovery` is non-empty when the ask routes OUTSIDE Google Maps, in one of two shapes. Mode 'launch_feeds': people/companies that RECENTLY LAUNCHED (e.g. "founders of B2B SaaS that launched in the last 3 months") — it names the launch feeds to search and whether the leads are people or companies. Mode 'web_search': long-tail ONLINE businesses Google Maps never had (e.g. "marketing agencies for dentists"), found via paid organic search — companies only, never people. Either way the block is already embedded inside the returned `query`, so passing `query` through unchanged is all that's needed; neither mode has a geography, so vertical/geo come back empty and start_campaign does not require them. Anything we cannot actually source lands in `unsupported` instead — read that list aloud to the user rather than pretending the campaign will cover it.
| Argument | Type | Description |
|---|---|---|
| text* | string |
{
"type": "object",
"title": "translate_icpArguments",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text"
}
}
}| any |
| vertical | any |
| idempotency_key | any |
{
"type": "object",
"$defs": {
"QueryInput": {
"type": "object",
"title": "QueryInput",
"properties": {
"rank": {
"enum": [
"ads_state",
"areas_served",
"booking_state",
"category",
"detected_tech",
"digital_maturity_score",
"emergency_24_7",
"first_review_at",
"has_contact_form",
"has_h1",
"has_hours",
"has_meta_description",
"has_real_site",
"has_robots",
"has_schema_org",
"has_sitemap",
"has_title",
"has_viewport",
"has_website",
"in_local_pack",
"is_claimed",
"is_franchise",
"is_social_only",
"licensed",
"locations_in_campaign",
"low_star_reviews_30d",
"low_star_reviews_60d",
"low_star_reviews_90d",
"multi_location",
"outdated_state",
"page_count",
"platform",
"rating",
"review_count",
"review_trend_state",
"runs_google_ads",
"runs_meta_ads",
"seo_basics_state",
"serp_rank",
"tech_state",
"titles_identical",
"total_photos",
"website_social_only",
"website_state",
"years_in_business"
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Rank",
"default": null,
"description": "optional field to sort/prioritize results by (same vocabulary as predicate fields)"
},
"discovery": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Discovery",
"default": null,
"description": "OPTIONAL non-Maps discovery directive. Omit it (the default) to discover local businesses on Google Maps, which is what vertical/geo describe. Two other modes exist, both with NO geography (vertical/geo are then not required). mode \"launch_feeds\": companies that RECENTLY LAUNCHED — and, optionally, the named founders behind them — from Product Hunt, Y Combinator and TinyLaunch; keys target_type (\"person\" for named founders or \"company\"; both bill 1 credit per validated lead), role (default \"founder\"), launch_window_days (1-365, default 90), category_keywords (e.g. [\"b2b\", \"saas\"]; empty keeps everything). mode \"web_search\": long-tail ONLINE businesses Google Maps never had, found by organic search — keys search_queries (1-5 queries, each a separate paid search; say what the business IS, e.g. [\"marketing agencies for dentists\"]), search_location (search locale, default \"United States\"), search_depth (10-100, default 60). It finds COMPANIES ONLY (billed 1 credit) and cannot carry the city-keyed signals runs_google_ads / serp_rank / runs_meta_ads / in_local_pack / ads_state. Filter platform membership with the detected_tech and tech_state fields instead. Firmographics (funding stage, headcount, revenue, technology spend) are NOT available in any mode and must never be written into a search query. Prefer translate_icp, which emits this block for you; a malformed or unknown-mode block is rejected at submit with a 422 naming the problem, never silently run as a Maps campaign. A mode may also be temporarily unavailable when its costs are not covered: submitting it returns a 422 that says so, and nothing is charged."
},
"predicates": {
"type": "array",
"items": {
"$ref": "#/$defs/QueryPredicateInput"
},
"title": "Predicates",
"description": "all predicates must hold for a lead to count as a confirmed match"
}
},
"description": "The structured filter start_campaign runs. Build it with translate_icp from free\ntext (recommended), or construct it directly from this schema's vocabulary.",
"additionalProperties": true
},
"QueryPredicateInput": {
"type": "object",
"title": "QueryPredicateInput",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"eq",
"neq",
"lt",
"lte",
"gt",
"gte",
"contains",
"not_contains",
"in",
"exists"
],
"type": "string",
"title": "Op",
"description": "comparison operator"
},
"field": {
"enum": [
"ads_state",
"areas_served",
"booking_state",
"category",
"detected_tech",
"digital_maturity_score",
"emergency_24_7",
"first_review_at",
"has_contact_form",
"has_h1",
"has_hours",
"has_meta_description",
"has_real_site",
"has_robots",
"has_schema_org",
"has_sitemap",
"has_title",
"has_viewport",
"has_website",
"in_local_pack",
"is_claimed",
"is_franchise",
"is_social_only",
"licensed",
"locations_in_campaign",
"low_star_reviews_30d",
"low_star_reviews_60d",
"low_star_reviews_90d",
"multi_location",
"outdated_state",
"page_count",
"platform",
"rating",
"review_count",
"review_trend_state",
"runs_google_ads",
"runs_meta_ads",
"seo_basics_state",
"serp_rank",
"tech_state",
"titles_identical",
"total_photos",
"website_social_only",
"website_state",
"years_in_business"
],
"type": "string",
"title": "Field",
"description": "the business attribute to filter on. The enum is the supported vocabulary; x-field-catalog documents each field's meaning, type, allowed ops, an example value, and — for the *_state verdict fields — the exact values to compare against. An unknown predicate field is rejected at submit with a 422 naming it.",
"x-field-catalog": {
"has_h1": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the homepage has a non-empty <h1> heading, read from raw served HTML (may read absent on client-rendered sites; prefer the seo_basics segment for render-safe SEO health)"
},
"rating": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "float",
"example": 4.2,
"description": "average star rating, 0-5"
},
"category": {
"ops": [
"eq"
],
"type": "str",
"example": "plumber",
"description": "the business vertical/type — goes in the top-level `category`, NOT a predicate"
},
"licensed": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "site states licensed/insured"
},
"platform": {
"ops": [
"eq",
"neq"
],
"type": "str",
"example": "wix",
"description": "site builder/platform (wix, squarespace, wordpress, godaddy, weebly, shopify, custom)"
},
"ads_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"ADS_PRESENT",
"NO_ADS_FOUND"
],
"example": "NO_ADS_FOUND",
"description": "paid-ads verdict ADS_PRESENT/NO_ADS_FOUND, null when unresolved"
},
"has_hours": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "business lists opening hours"
},
"has_title": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "the homepage has a non-empty <title>"
},
"serp_rank": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq"
],
"type": "int",
"example": 10,
"description": "Google organic position for its category+city, 1=top. Prefer page thresholds: <=10 'page 1', <=50 'top 50', >10 'not on page 1', eq 1 'ranked #1'. Never emit a value above 100 or compare against the not-ranked sentinel. Approximate (keyword-proxy): a business may rank for a narrower term than category+city, so 'not ranking' can under-count."
},
"has_robots": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the site has a /robots.txt, read from raw served HTML (may read absent on client-rendered sites; prefer the seo_basics segment for render-safe SEO health)"
},
"is_claimed": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the Google listing is claimed/managed by the owner"
},
"page_count": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 1,
"description": "how many of home/contact/about/team pages resolved"
},
"tech_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"TECH_DETECTED",
"TECH_NONE_DETECTED"
],
"example": "TECH_DETECTED",
"description": "platform-membership verdict from the site crawl — TECH_DETECTED / TECH_NONE_DETECTED, null when the site could not be crawled or is client-rendered (a runtime-injected widget is invisible in served HTML). Pair it with detected_tech to name the platform"
},
"has_sitemap": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the site has a /sitemap.xml, read from raw served HTML (may read absent on client-rendered sites; prefer the seo_basics segment for render-safe SEO health)"
},
"has_website": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "business has any website at all"
},
"areas_served": {
"ops": [
"contains",
"not_contains"
],
"type": "list[str]",
"example": "Phoenix",
"description": "service-area city names parsed from the site"
},
"has_viewport": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the site is mobile-friendly (has a viewport meta tag)"
},
"is_franchise": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the business name matches a known national franchise brand (dated list); False means no match on this list, NOT verified independent — never claim independence from this field alone"
},
"review_count": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 30,
"description": "number of reviews"
},
"total_photos": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 10,
"description": "number of listing photos"
},
"booking_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"BOOKING_PRESENT",
"BOOKING_ABSENT"
],
"example": "BOOKING_ABSENT",
"description": "online-booking verdict BOOKING_PRESENT/BOOKING_ABSENT, null when unresolved"
},
"detected_tech": {
"ops": [
"contains",
"not_contains"
],
"type": "list[str]",
"example": "shopify",
"description": "tech/widgets detected on the site (e.g. shopify, calendly, toast, doordash)"
},
"has_real_site": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "has a real website (not social-only / not empty)"
},
"in_local_pack": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "appears in the Google Maps local 3-pack for its category+city"
},
"runs_meta_ads": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the business runs active Meta/Facebook ads (Ad Library). EXPERIMENTAL: the resolver is unverified and OFF by default (needs --enable-meta); without it this yields needs_review, never a confident answer"
},
"website_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"WEBSITE_NONE",
"WEBSITE_SOCIAL_ONLY",
"WEBSITE_PRESENT"
],
"example": "WEBSITE_NONE",
"description": "website-presence verdict — WEBSITE_NONE / WEBSITE_SOCIAL_ONLY / WEBSITE_PRESENT, null when unresolved"
},
"emergency_24_7": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "site advertises 24/7 emergency service"
},
"has_schema_org": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the site has schema.org structured data"
},
"is_social_only": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "the only web presence is a social page (Facebook/Instagram/etc.)"
},
"multi_location": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the same business record was found in multiple data sources and merged into one canonical record during dedupe (a dedupe multiplicity) — NOT chain/multi-site detection; use locations_in_campaign for multi-location/chain filtering"
},
"outdated_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"OUTDATED",
"CURRENT"
],
"example": "OUTDATED",
"description": "outdated-website verdict OUTDATED/CURRENT, null when unresolved"
},
"first_review_at": {
"ops": [
"eq",
"neq",
"lt",
"lte",
"gt",
"gte",
"exists"
],
"type": "str",
"example": "2024-01-15",
"description": "the date of the business's EARLIEST Google review (ISO, e.g. 2024-01-15) -- only set when the reviews we fetched are provably its ENTIRE review history. This is an AGE FLOOR ('has existed at least since this date'), never an opening date: a long-established business that only recently got its first review looks new by this measure. Blank/null when we only saw part of its history and cannot know the true first review -- a real, unbilled outcome, not an error. Use this to answer how-long-has-this-business-existed style asks by comparing against a cutoff date; never present it as a founding or opening date"
},
"runs_google_ads": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the business runs Google Search ads (advertiser-level, any campaign)"
},
"has_contact_form": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the site has a contact/inquiry form"
},
"seo_basics_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"values": [
"SEO_BASICS_MISSING",
"SEO_BASICS_PRESENT"
],
"example": "SEO_BASICS_MISSING",
"description": "render-safe SEO health verdict: SEO_BASICS_MISSING (2+ of no title/no meta description/no H1/identical titles/no sitemap+robots) or SEO_BASICS_PRESENT; null when unresolved or the site is client-rendered (title/meta/H1 injected at runtime, so raw HTML can't be trusted) — prefer this over the raw has_title/has_h1/etc. fields for SEO-health filtering"
},
"titles_identical": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "the <title> tag is identical across every crawled page (thin/templated-site smell), read from raw served HTML (may read absent on client-rendered sites; prefer the seo_basics segment for render-safe SEO health)"
},
"years_in_business": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 1998,
"description": "the FOUNDING YEAR (a 4-digit year like 1998), parsed from 'since/established YYYY' — NOT a duration. To find businesses younger than N years, use years_in_business > (current_year - N); older than N, use < that value"
},
"review_trend_state": {
"ops": [
"eq",
"neq",
"exists"
],
"type": "str",
"example": "NEGATIVE_WAVE",
"description": "recent-reviews verdict — NEGATIVE_WAVE when the business received 3 or more reviews rated 2 stars or less in the last 90 days, STABLE when it did not, null when we could not see the whole 90-day window (a real, unbilled outcome — not an error, and not the same as STABLE). Use this for 'recent bad reviews', 'wave of 1-star reviews', 'reputation problems lately'. It is about RECENT ratings only — for overall rating or review volume use rating / review_count instead"
},
"website_social_only": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": true,
"description": "the business's only web presence is a social/directory page like Facebook, no real website"
},
"has_meta_description": {
"ops": [
"eq",
"exists"
],
"type": "bool",
"example": false,
"description": "the homepage has a meta description (basic SEO)"
},
"low_star_reviews_30d": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 3,
"description": "how many of this business's Google reviews are rated 2 stars or less, counting back 30 days from the date we FETCHED its reviews (not today's date). null means we could not prove we saw the whole 30-day window -- a real, unbilled outcome, not an error, and NOT the same as a proven zero (zero means we saw the whole window and it was clean). For a plain yes/no 'does this business have a reputation problem' ask, use review_trend_state instead of a raw count"
},
"low_star_reviews_60d": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 3,
"description": "how many of this business's Google reviews are rated 2 stars or less, counting back 60 days from the date we FETCHED its reviews (not today's date). null means we could not prove we saw the whole 60-day window -- a real, unbilled outcome, not an error, and NOT the same as a proven zero (zero means we saw the whole window and it was clean). For a plain yes/no 'does this business have a reputation problem' ask, use review_trend_state instead of a raw count"
},
"low_star_reviews_90d": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 3,
"description": "how many of this business's Google reviews are rated 2 stars or less, counting back 90 days from the date we FETCHED its reviews (not today's date). null means we could not prove we saw the whole 90-day window -- a real, unbilled outcome, not an error, and NOT the same as a proven zero (zero means we saw the whole window and it was clean). For a plain yes/no 'does this business have a reputation problem' ask, use review_trend_state instead of a raw count"
},
"locations_in_campaign": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "int",
"example": 3,
"description": "how many businesses in this search share this name or domain at different addresses (>1 = multi-location/chain in this run)"
},
"digital_maturity_score": {
"ops": [
"lt",
"lte",
"gt",
"gte",
"eq",
"neq"
],
"type": "float",
"example": 50,
"description": "0-100 composite web-maturity score (low = bigger digital gap)"
}
}
},
"value": {
"title": "Value",
"default": null,
"description": "comparison value; omit for op='exists'"
}
},
"additionalProperties": true
}
},
"title": "start_campaignArguments",
"required": [
"query"
],
"properties": {
"geo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Geo",
"default": null
},
"query": {
"$ref": "#/$defs/QueryInput"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
},
"vertical": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Vertical",
"default": null
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Idempotency Key",
"default": null
}
}
}