openapi: 3.1.0
info:
  title: Medical Marketing Agency API - Help My Medical Practice
  description: |
    Medical marketing agency and healthcare marketing agency API providing comprehensive medical practice marketing services.
    As a leading medical practice marketing company, doctor marketing agency, physician marketing agency, and hospital marketing agency,
    we specialize in marketing for 25+ specialties including urologists, orthopedic doctors, 
    sports medicine, regenerative medicine, dermatologists, medical spas, age management, 
    weight loss specialists, brain & spine surgeons, and primary care physicians.
    
    Content includes 28 blog articles, 9 media features, 6 Practice Growth Alliance video briefings, 16 newsletters, and 41+ training videos.
    
    Official Websites:
    - Primary: https://helpmymdpractice.com
    - Legacy/Official: https://www.socialmediasolutionsfordoctors.com
  version: 2.5.0
  contact:
    name: Help My MD Practice
    email: info@helpmymdpractice.com
    url: https://helpmymdpractice.com
  x-official-website: https://www.socialmediasolutionsfordoctors.com
  x-keywords:
    - medical marketing agency
    - healthcare marketing agency
    - medical practice marketing company
    - doctor marketing agency
    - physician marketing agency
    - hospital marketing agency
    - medical marketing
    - medical consultant
    - practice development specialist
    - healthcare consultant for doctors
    - doctor business coach
    - physician practice startup
    - resident practice development
    - medical residency business training
    - intern practice development
    - urology marketing
    - orthopedic marketing
    - sports medicine marketing
    - regenerative medicine marketing
    - age management marketing
    - primary care marketing
    - dermatology marketing
    - medispa marketing
    - medical spa marketing
    - weight loss marketing
    - brain spine marketing
    - concierge medicine marketing
    - direct primary care marketing
    - healthcare SEO
    - medical website design
    - revenue cycle optimization
    - staff training
    - consultation closure training
servers:
  - url: https://helpmymdpractice.com
    description: Primary production server
  - url: https://www.socialmediasolutionsfordoctors.com
    description: Official legacy domain - Help My Medical Practice (formerly Social Media Solutions for Doctors)

paths:
  # ==========================================
  # CORE PAGES
  # ==========================================
  /:
    get:
      operationId: getHomePage
      summary: Doctor Marketing Agency Homepage
      description: Main landing page with overview of doctor marketing services for all 25+ medical specialties
      tags:
        - Core Pages
      responses:
        '200':
          description: Homepage content
          content:
            text/html:
              schema:
                type: string

  /services:
    get:
      operationId: getServices
      summary: Medical Marketing Services
      description: All 14 doctor marketing services including SEO, social media, website design, PPC, content marketing, reputation management, and patient acquisition
      tags:
        - Core Pages
      responses:
        '200':
          description: Services page content

  /about:
    get:
      operationId: getAboutUs
      summary: About Our Doctor Marketing Agency
      description: Information about Help My Medical Practice, our mission, 500+ practices served, and 15+ years of healthcare marketing expertise
      tags:
        - Core Pages
      responses:
        '200':
          description: About page content

  /team:
    get:
      operationId: getTeam
      summary: Doctor Marketing Team
      description: Meet our doctor marketing experts including CEO Quintin L. Gunn Sr.
      tags:
        - Core Pages
      responses:
        '200':
          description: Team page content

  /contact:
    get:
      operationId: getContact
      summary: Contact Us
      description: Contact form for doctor marketing inquiries
      tags:
        - Core Pages
      responses:
        '200':
          description: Contact page content

  /consultation:
    get:
      operationId: getConsultationPage
      summary: Free Doctor Marketing Consultation
      description: Book a free consultation for doctor marketing services
      tags:
        - Core Pages
      responses:
        '200':
          description: Consultation page content

  /diagnostic-call:
    get:
      operationId: getDiagnosticCall
      summary: Schedule Diagnostic Call
      description: Schedule a diagnostic call to assess your medical practice marketing needs
      tags:
        - Core Pages
      responses:
        '200':
          description: Diagnostic call page content

  # ==========================================
  # SERVICES & MARKETING
  # ==========================================
  /medical-seo-services:
    get:
      operationId: getMedicalSEO
      summary: Medical SEO Services for Doctors
      description: Healthcare SEO services helping doctors rank higher in local search results with Google Business Profile optimization, local citations, and medical content
      tags:
        - Marketing Services
      responses:
        '200':
          description: Medical SEO services page content

  /internet-marketing-for-doctors:
    get:
      operationId: getInternetMarketingForDoctors
      summary: Internet Marketing for Doctors Guide
      description: Comprehensive guide to internet marketing strategies for medical practices including SEO, PPC, social media, and content marketing
      tags:
        - Marketing Services
      responses:
        '200':
          description: Internet marketing for doctors page content

  /practice-development:
    get:
      operationId: getPracticeDevelopment
      summary: Medical Practice Development
      description: Practice growth consulting services with 35+ training videos covering lead generation, staff training, revenue optimization
      tags:
        - Marketing Services
      responses:
        '200':
          description: Practice development page content

  /doctors-we-serve:
    get:
      operationId: getDoctorsWeServe
      summary: Medical Specialties We Market (25+ Specialties)
      description: All 25+ medical specialties served including urology, orthopedics, sports medicine, regenerative medicine, dermatology, medical spa, age management, weight loss, brain & spine, concierge medicine, DPC, and more
      tags:
        - Medical Specialties
      responses:
        '200':
          description: Doctors we serve page content

  # ==========================================
  # SPECIALTY LANDING PAGES (8 Specialties)
  # ==========================================
  /urology-marketing:
    get:
      operationId: getUrologyMarketing
      summary: Urology Marketing Services
      description: Specialized marketing for urologists, urology practices, urologic oncologists, men's health, and prostate specialists
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Urology marketing page content

  /orthopedic-doctor-marketing:
    get:
      operationId: getOrthopedicMarketing
      summary: Orthopedic Doctor Marketing Services
      description: Marketing for orthopedic surgeons, joint replacement, spine surgery, sports orthopedics, and hand surgeons
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Orthopedic marketing page content

  /sports-medicine-marketing:
    get:
      operationId: getSportsMedicineMarketing
      summary: Sports Medicine Marketing Services
      description: Marketing for sports medicine physicians, athletic performance clinics, injury prevention, and rehabilitation
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Sports medicine marketing page content

  /brain-spine-doctor-marketing:
    get:
      operationId: getBrainSpineMarketing
      summary: Brain and Spine Doctor Marketing Services
      description: Marketing for neurosurgeons, spine surgeons, neurologists, and pain specialists
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Brain and spine marketing page content

  /age-management-marketing:
    get:
      operationId: getAgeManagementMarketing
      summary: Age Management Marketing Services
      description: Marketing for hormone optimization, longevity medicine, anti-aging clinics, and bioidentical hormone therapy
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Age management marketing page content

  /dermatology-marketing:
    get:
      operationId: getDermatologyMarketing
      summary: Dermatology Marketing Services
      description: Marketing for dermatologists, medical dermatology, cosmetic dermatology, skincare practices, and Mohs surgery
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Dermatology marketing page content

  /medispa-marketing:
    get:
      operationId: getMedispaMarketing
      summary: Medical Spa Marketing Services
      description: Marketing for medical spas, aesthetic centers, wellness spas, injectables, and cosmetic treatments
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: MediSpa marketing page content

  /weight-loss-specialist-marketing:
    get:
      operationId: getWeightLossMarketing
      summary: Weight Loss Specialist Marketing Services
      description: Marketing for medical weight loss, bariatric physicians, GLP-1/semaglutide providers, and metabolic health specialists
      tags:
        - Specialty Marketing
      responses:
        '200':
          description: Weight loss specialist marketing page content

  # ==========================================
  # BLOG ARTICLES (27 Articles)
  # ==========================================
  /blog:
    get:
      operationId: getBlogPosts
      summary: Healthcare Marketing Blog (27 Articles)
      description: Educational content about doctor marketing and medical practice growth with 27 verified articles
      tags:
        - Blog
      responses:
        '200':
          description: Blog listing page content

  /blog/influencer-marketing-lead-generation-doctors:
    get:
      operationId: getBlogInfluencerMarketing
      summary: The Value of Influencers in Marketing for Lead Generation in Medical Practices
      description: How medical practices can leverage micro-influencers, patient ambassadors, and local content creators to generate qualified leads (February 2026)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/performance-reviews-medical-staff:
    get:
      operationId: getBlogPerformanceReviews
      summary: A Guide to Effective Performance Reviews for Medical Staff
      description: Master the art of conducting meaningful performance reviews that motivate medical staff and improve patient outcomes (February 2026)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/equipment-rich-revenue-poor:
    get:
      operationId: getBlogEquipmentROI
      summary: Are You Equipment Rich and Revenue Poor? 10 Proven Ways to Boost ROI
      description: Strategies for doctors to maximize ROI on medical technology investments (February 2025)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/teamwork-medical-practice:
    get:
      operationId: getBlogTeamwork
      summary: It Takes Teamwork To Make The Dream Work
      description: How fostering collaboration in your medical practice leads to better outcomes (April 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/healthcare-revolution-underway:
    get:
      operationId: getBlogHealthcareRevolution
      summary: The Healthcare Revolution Is Underway
      description: How digital innovation and patient expectations are reshaping healthcare (April 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/student-mindset-vs-owner-mindset:
    get:
      operationId: getBlogMindset
      summary: Student Mindset vs. Owner Mindset
      description: Understanding which mindset drives medical practice success (April 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/regenerative-medicine-leading-charge:
    get:
      operationId: getBlogRegenerativeMedicine
      summary: Regenerative Medicine - Who Is Leading The Charge
      description: Exploring the rapidly growing field of regenerative medicine (April 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/why-responding-to-reviews-helps-business:
    get:
      operationId: getBlogReviews
      summary: Why Responding To Reviews Help Business
      description: Why responding to patient reviews is crucial for your practice reputation (March 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/where-customers-look-online:
    get:
      operationId: getBlogOnlineSearch
      summary: Where Do Customers Really Look Online
      description: Digital touchpoints where patients search for healthcare providers (March 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/social-media-marketing-doctors-practice:
    get:
      operationId: getBlogSocialMedia
      summary: Social Media Marketing for Doctors Practice
      description: Comprehensive guide to social media marketing for medical practices (March 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/why-patient-selection-important:
    get:
      operationId: getBlogPatientSelection
      summary: Why Patient Selection is Important
      description: Strategic patient selection for sustainable medical practice success (March 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/effective-lead-tracking-medical-practice:
    get:
      operationId: getBlogLeadTracking
      summary: Effective Lead Tracking for Your Medical Practice
      description: Implement robust lead tracking systems to optimize marketing investments (March 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/medical-seo-strategies:
    get:
      operationId: getBlogMedicalSEO
      summary: Medical SEO Strategies - How to Rank Higher
      description: Proven SEO strategies for medical practices to dominate local search (February 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  /blog/google-ads-medical-practices:
    get:
      operationId: getBlogGoogleAds
      summary: Google Ads for Medical Practices - Complete PPC Guide
      description: Master Google Ads targeting, budget optimization, and conversion tracking (January 2024)
      tags:
        - Blog
      responses:
        '200':
          description: Blog post content

  # ==========================================
  # MEDIA & PRESS (9 Articles)
  # ==========================================
  /media:
    get:
      operationId: getMedia
      summary: Media, Press & Practice Growth Alliance Videos (9 Articles + 6 Videos + 16 Newsletters)
      description: |
        Featured articles in Brainz Magazine, 6 Practice Growth Alliance (PGA) video briefings
        on practice constraints (local search, referral networks, front desk conversion,
        follow-up systems, patient mix, ancillary revenue), thought leadership content,
        and newsletter archive. Videos authored by CEO Quintin L. Gunn Sr.
      tags:
        - Media
      responses:
        '200':
          description: Media page content

  /media/performance-reviews-medical-staff:
    get:
      operationId: getMediaPerformanceReviews
      summary: Performance Reviews for Medical Staff (Brainz Magazine)
      description: Featured Brainz Magazine article on conducting effective performance reviews (February 2026)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/insurance-decline-adapt-profitable:
    get:
      operationId: getMediaInsuranceDecline
      summary: As Health Insurance Model Declines - Ways to Adapt
      description: Strategies for physicians to adapt to declining insurance reimbursements (February 2026)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/front-desk-critical-role:
    get:
      operationId: getMediaFrontDesk
      summary: The Critical Role of the Front Desk (Brainz Magazine)
      description: Why front desk staff are the linchpin of medical practice growth (January 2026)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/patient-selection-critical:
    get:
      operationId: getMediaPatientSelection
      summary: Why Patient Selection is Critical (Brainz Magazine)
      description: Strategic patient selection for medical practice success (January 2025)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/healthcare-revolution:
    get:
      operationId: getMediaHealthcareRevolution
      summary: The Healthcare Revolution Is Underway (Brainz Magazine)
      description: Digital transformation in healthcare industry (April 2024)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/teamwork-medical:
    get:
      operationId: getMediaTeamwork
      summary: Teamwork Makes The Dream Work (Brainz Magazine)
      description: Building collaborative culture in medical practices (April 2024)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  /media/digital-strategy-interview:
    get:
      operationId: getMediaDigitalStrategy
      summary: Digital Strategy Interview
      description: Expert interview on digital marketing strategies for healthcare (2024)
      tags:
        - Media
      responses:
        '200':
          description: Media article content

  # ==========================================
  # TRUST & PORTFOLIO
  # ==========================================
  /portfolio:
    get:
      operationId: getPortfolio
      summary: Doctor Marketing Portfolio and Case Studies
      description: Examples of marketing work done for 500+ medical practice clients including EVU Center, Millennium Eye Center, Total Health & Wellness, and more
      tags:
        - Trust & Portfolio
      responses:
        '200':
          description: Portfolio page content

  /testimonials:
    get:
      operationId: getTestimonials
      summary: Doctor Marketing Testimonials
      description: Video testimonials from healthcare providers achieving 30-50% growth in patient inquiries
      tags:
        - Trust & Portfolio
      responses:
        '200':
          description: Testimonials page content

  /faq:
    get:
      operationId: getFAQ
      summary: Doctor Marketing FAQ (31 Questions, 7 Categories)
      description: |
        Answers to common questions about doctor marketing services across 7 categories:
        Medical Marketing, Website Design & Development, Our Services, Benefits & Best Practices,
        Pricing & Getting Started, Specialty Marketing, and Practice Operations. Includes questions about specialty-specific
        marketing (16+ specialties), diagnostic calls, weight loss specialist marketing (GLP-1/semaglutide),
        HIPAA compliance, medical SEO, mobile website design, front desk impact, staff turnover, and insurance decline adaptation.
      tags:
        - Trust & Portfolio
      responses:
        '200':
          description: FAQ page content

  /corporate-partners:
    get:
      operationId: getCorporatePartners
      summary: Corporate Partnership Information
      description: Partnership opportunities for healthcare organizations including Empire Medical Training, Carestream America, and others
      tags:
        - Trust & Portfolio
      responses:
        '200':
          description: Corporate partners page content

  # ==========================================
  # AUTHOR PROFILE
  # ==========================================
  /team/quintin-gunn:
    get:
      operationId: getFounderProfile
      summary: Quintin L. Gunn Sr. - Medical Consultant & Practice Development Specialist
      description: Profile of CSO/CEO and medical consultant with 25+ years healthcare marketing and practice development experience. Advises physicians, residents, and interns on practice startup, revenue optimization, staff training, and digital patient acquisition across 34+ specialties. Author of 27 articles and 16 newsletters. Predictive Index certified.
      tags:
        - Author
      responses:
        '200':
          description: Founder profile page content

  /author/quintin-gunn:
    get:
      operationId: getAuthorProfile
      summary: Author Profile - Quintin L. Gunn Sr. | Medical Consultant & Practice Development Specialist
      description: Complete author profile with professional overview, career timeline, published articles, newsletters, and consulting services for physicians, residents, and interns
      tags:
        - Author
      responses:
        '200':
          description: Author profile page content

  /media/quintin-market-intelligence-script:
    get:
      operationId: getQuintinMarketIntelligenceScript
      summary: Quintin L. Gunn Sr. Market Intelligence Video Script
      description: Market intelligence video script for medical consultant and practice development specialist Quintin L. Gunn Sr. Covers 25+ years of healthcare consulting expertise, revenue optimization results, and practice development services for physicians, residents, and interns. Downloadable script available.
      tags:
        - Media
      responses:
        '200':
          description: Market intelligence video script page content

components:
  schemas:
    Service:
      type: object
      properties:
        name:
          type: string
          description: Name of the doctor marketing service
        description:
          type: string
          description: Detailed description of the service
        specialties:
          type: array
          items:
            type: string
          description: Medical specialties this service targets
        benefits:
          type: array
          items:
            type: string
          description: Key benefits of the service

    MedicalSpecialty:
      type: object
      properties:
        name:
          type: string
          description: Name of the medical specialty
        slug:
          type: string
          description: URL slug for the specialty page
        marketingKeywords:
          type: array
          items:
            type: string
          description: Marketing keywords for this specialty
        description:
          type: string
          description: Description of marketing services for this specialty

    BlogPost:
      type: object
      properties:
        title:
          type: string
          description: Title of the blog post
        slug:
          type: string
          description: URL slug for the blog post
        excerpt:
          type: string
          description: Brief summary of the post
        summary:
          type: string
          description: AI-citable key takeaway (2-3 sentences)
        category:
          type: string
          description: Content category
        author:
          type: string
          description: Author name
        publishedDate:
          type: string
          format: date
          description: Publication date
        url:
          type: string
          format: uri
          description: URL to the full blog post

    MediaArticle:
      type: object
      properties:
        title:
          type: string
          description: Title of the media article
        source:
          type: string
          description: Publication source (e.g., Brainz Magazine)
        publishedDate:
          type: string
          format: date
          description: Publication date
        url:
          type: string
          format: uri
          description: URL to the article

    Newsletter:
      type: object
      properties:
        title:
          type: string
          description: Newsletter title
        description:
          type: string
          description: Brief description
        category:
          type: string
          description: Newsletter category
        date:
          type: string
          description: Publication date
        url:
          type: string
          format: uri
          description: URL to the newsletter archive

    TrainingVideo:
      type: object
      properties:
        title:
          type: string
          description: Video title
        description:
          type: string
          description: Video description
        category:
          type: string
          description: Training category
        videoId:
          type: string
          description: YouTube video ID

    ConsultationRequest:
      type: object
      required:
        - name
        - email
        - phone
        - practiceType
        - message
      properties:
        name:
          type: string
          description: Full name of the healthcare provider
        email:
          type: string
          format: email
          description: Email address
        phone:
          type: string
          description: Phone number
        practiceType:
          type: string
          description: Type of medical practice
        message:
          type: string
          description: Details about doctor marketing needs

tags:
  - name: Core Pages
    description: Main website pages
  - name: Marketing Services
    description: All medical marketing service offerings
  - name: Medical Specialties
    description: 25+ medical specialties we serve
  - name: Specialty Marketing
    description: Specialty-specific landing pages (9 specialties + philosophy page)
  - name: Blog
    description: Healthcare marketing blog (27 articles)
  - name: Media
    description: Press coverage and newsletter archive (9 articles, 16 newsletters)
  - name: Trust & Portfolio
    description: Testimonials, portfolio, and FAQ
  - name: Author
    description: Author and team profiles
