MarketPulse LLM Visibility Scorer

{
  "type": "json",
  "errors": {
    "400": {
      "example": {
        "error": "invalid request"
      },
      "description": "Invalid or missing parameter(s). Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."
    },
    "402": {
      "description": "Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."
    },
    "500": {
      "example": {
        "error": "upstream_failed"
      },
      "description": "Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."
    }
  },
  "example": {
    "disclaimer": "AI citation patterns change frequently. Re-assess monthly as LLM training and retrieval methods evolve.",
    "quick_wins": [
      {
        "action": "Add an FAQPage schema block to the service page",
        "effort": "low",
        "how_to": "Mark up the 5 most common customer questions with FAQPage schema",
        "impact": "medium"
      }
    ],
    "eat_signals": {
      "expertise": "Add technician credentials and years-in-business",
      "trustworthiness": "Display licensing info and verified reviews prominently",
      "authoritativeness": "Earn citations from local news or trade directories"
    },
    "amazon_search": "The Art of SEO by Eric Enge",
    "schema_markup": {
      "why": "Structured data helps AI systems extract and attribute answers",
      "priority_pages": "Homepage and primary service pages",
      "recommended_types": [
        "FAQPage",
        "LocalBusiness"
      ]
    },
    "six_week_plan": [
      {
        "week": "1-2",
        "action": "Publish FAQ page with schema markup"
      },
      {
        "week": "3-4",
        "action": "Add pricing transparency page"
      }
    ],
    "competitor_gap": "Top local competitors publish pricing ranges directly on their sites, which AI systems favor when answering cost questions",
    "why_it_matters": "AI Overviews and chat assistants increasingly answer local-service queries before a user ever clicks a search result",
    "llm_citation_factors": [
      {
        "score": "low",
        "factor": "Structured FAQ content answering direct customer questions",
        "what_to_do": "Publish a dedicated FAQ page with question-form headings"
      }
    ],
    "visibility_assessment": "Low — no evidence this brand is currently surfaced in AI-generated answers for its core service category",
    "content_types_ai_favors": [
      "Direct-answer FAQs",
      "Step-by-step how-to content",
      "Pricing transparency pages"
    ]
  }
}