{ "openapi": "3.1.0", "info": { "title": "PulseBench Studio API", "version": "0.1.0", "description": "Read-only business intelligence and website diagnostic tools. Reports are informational and not legal, financial or investment advice.", "contact": { "url": "https://pulse.dunnenterprisesinc.com/support" } }, "servers": [ { "url": "https://pulse.dunnenterprisesinc.com" } ], "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key" }, "AdminKey": { "type": "apiKey", "in": "header", "name": "X-MarketTest-Admin-Key" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } }, "paths": { "/healthz": { "get": { "summary": "Health check", "responses": { "200": { "description": "OK" } } } }, "/v1/govbidpulse/awards": { "get": { "summary": "Search federal awards", "parameters": [ { "name": "naics", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "contract_type", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Matching awards with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/govbidpulse/awards.csv": { "get": { "summary": "Free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/govbidpulse/match": { "post": { "summary": "Score federal opportunities for a trade and state", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "naics": { "type": "string", "enum": [ "238220", "238210", "238160", "561720", "561730", "339112", "561612", "541511", "541211" ], "description": "NAICS trade code" }, "state": { "type": "string", "description": "Two-letter US state code" }, "contract_type": { "type": "string", "enum": [ "expiring", "recent", "all" ], "default": "expiring" }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/formdpulse/filings": { "get": { "summary": "Search recent Form D filings", "parameters": [ { "name": "persona", "in": "query", "schema": { "type": "string" } }, { "name": "sector", "in": "query", "schema": { "type": "string" } }, { "name": "raise_size", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "exemption", "in": "query", "schema": { "type": "string" } }, { "name": "include_pooled_funds", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Matching filings", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/formdpulse/filings.csv": { "get": { "summary": "Free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/formdpulse/match": { "post": { "summary": "Score newly funded companies for a buyer persona", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "persona": { "type": "string", "enum": [ "cpa", "insurance_re", "recruiting", "wealth", "agency" ], "default": "cpa" }, "sector": { "type": "string", "enum": [ "Healthcare & Life Sciences", "Technology & SaaS", "Manufacturing & Industrial", "Real Estate & Construction", "Energy", "Financial Services", "Business Services", "Consumer & Retail", "Agriculture & Food", "Travel & Hospitality", "Other", "Pooled Fund" ] }, "raise_size": { "type": "string", "enum": [ "250k-1m", "1m-5m", "5m-25m", "25m+" ] }, "state": { "type": "string", "description": "Two-letter state code" }, "exemption": { "type": "string", "enum": [ "506(b)", "506(c)" ] }, "include_pooled_funds": { "type": "boolean", "default": false }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/accesspulse/scan": { "post": { "summary": "Read-only accessibility risk scan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Public http(s) URL to scan" }, "html": { "type": "string", "description": "Raw HTML to scan instead of a URL" }, "preset": { "type": "string", "enum": [ "demo-ecommerce-store", "demo-dental-clinic", "demo-saas-landing" ] }, "org_name": { "type": "string" }, "contact_email": { "type": "string" } } } } } }, "responses": { "200": { "description": "Scan report", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "502": { "description": "Target unreachable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/citepulse/audit": { "post": { "summary": "Read-only AI brand readiness audit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Public http(s) website URL" }, "preset": { "type": "string", "enum": [ "demo-dental-practice", "demo-online-store", "demo-saas-app" ] }, "business_type": { "type": "string", "enum": [ "local", "ecommerce", "saas" ] } } } } } }, "responses": { "200": { "description": "Audit report", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "502": { "description": "Target unreachable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/permitpulse/records": { "get": { "summary": "PermitPulse: list records", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "metro", "in": "query", "schema": { "type": "string" } }, { "name": "trade", "in": "query", "schema": { "type": "string" } }, { "name": "min_valuation", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/permitpulse/records.csv": { "get": { "summary": "PermitPulse: free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/verticals/permitpulse/match": { "post": { "summary": "PermitPulse: score matching records", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "metro": { "type": "string", "enum": [ "austin", "chicago" ], "description": "Metro" }, "trade": { "type": "string", "enum": [ "roofing", "hvac", "electrical", "commercial_ti", "new_build", "other" ], "description": "Trade" }, "min_valuation": { "type": "number", "description": "Minimum valuation (USD)" } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/fdapulse/records": { "get": { "summary": "FDAPulse: list records", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "record_type", "in": "query", "schema": { "type": "string" } }, { "name": "panel", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/fdapulse/records.csv": { "get": { "summary": "FDAPulse: free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/verticals/fdapulse/match": { "post": { "summary": "FDAPulse: score matching records", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "record_type": { "type": "string", "enum": [ "clearance", "Class I", "Class II", "Class III" ], "description": "Record type" }, "panel": { "type": "string", "enum": [ "Orthopedic", "Cardiovascular", "Dental", "Radiology", "General Hospital", "General, Plastic Surgery", "Neurology", "Gastroenterology, Urology", "Anesthesiology", "Clinical Chemistry", "Microbiology", "Ophthalmic", "Obstetrics/Gynecology", "Other" ], "description": "Medical specialty / review panel" } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/epapulse/records": { "get": { "summary": "EPAPulse: list records", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "statute", "in": "query", "schema": { "type": "string" } }, { "name": "industry", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/epapulse/records.csv": { "get": { "summary": "EPAPulse: free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/verticals/epapulse/match": { "post": { "summary": "EPAPulse: score matching records", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "state": { "type": "string", "enum": [ "TX", "CA", "LA", "OH", "PA", "IL", "IN", "MI", "NY", "FL", "NJ", "GA" ], "description": "State" }, "statute": { "type": "string", "enum": [ "CWA", "CAA", "RCRA" ], "description": "Statute in violation" }, "industry": { "type": "string", "enum": [ "211", "221", "311", "322", "324", "325", "326", "331", "332", "336", "562" ], "description": "Industry (NAICS)" } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/npipulse/records": { "get": { "summary": "NPIPulse: list records", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "specialty", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/npipulse/records.csv": { "get": { "summary": "NPIPulse: free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/verticals/npipulse/match": { "post": { "summary": "NPIPulse: score matching records", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "state": { "type": "string", "enum": [ "TX", "FL", "CA", "NY", "IL", "AZ" ], "description": "State" }, "specialty": { "type": "string", "enum": [ "dentist", "dermatology", "physical-therapy", "chiropractic", "optometry", "clinic" ], "description": "Specialty" } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/grantpulse/records": { "get": { "summary": "GrantPulse: list records", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "type": "string" } }, { "name": "category", "in": "query", "schema": { "type": "string" } }, { "name": "min_award", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records with scores", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/verticals/grantpulse/records.csv": { "get": { "summary": "GrantPulse: free 10-row CSV sample", "responses": { "200": { "description": "CSV", "content": { "text/csv": {} } } } } }, "/v1/verticals/grantpulse/match": { "post": { "summary": "GrantPulse: score matching records", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "status": { "type": "string", "enum": [ "posted", "forecasted" ], "description": "Status" }, "category": { "type": "string", "enum": [ "health", "education", "energy", "environment", "science-and-technology", "community-development", "agriculture", "business-and-commerce", "income-security-and-social-services", "employment-labor-and-training", "housing", "other" ], "description": "Funding category" }, "min_award": { "type": "number", "description": "Minimum award ceiling (USD)" } } } } } }, "responses": { "200": { "description": "Scored matches", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/localschemapulse/scan": { "post": { "summary": "Read-only local business structured-data check", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Public http(s) URL" }, "preset": { "type": "string", "enum": [ "demo-pizzeria", "demo-dentist", "demo-hvac" ] } } } } } }, "responses": { "200": { "description": "Readiness report", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/localschemapulse/pack": { "post": { "summary": "Copy-paste LocalBusiness JSON-LD pack (requires a pack key)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url", "api_key" ], "properties": { "url": { "type": "string" }, "api_key": { "type": "string" } } } } } }, "responses": { "200": { "description": "JSON-LD pack", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Pack key required" } } } }, "/v1/verticals/grantpulse/pack/{id}": { "get": { "summary": "Grant readiness pack in Markdown (requires a pack key)", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "api_key", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Markdown", "content": { "text/markdown": {} } }, "402": { "description": "Pack key required" } } } }, "/v1/telemetry/event": { "post": { "summary": "Record a client event (pricing_click, report_download)", "responses": { "204": { "description": "Recorded" } } } }, "/v1/admin/harvester/status": { "get": { "summary": "Public-record connector status and indexable URL counts", "security": [ { "AdminKey": [] } ], "responses": { "200": { "description": "Status" }, "401": { "description": "Unauthorized" } } } }, "/v1/admin/harvester/run": { "post": { "summary": "Refresh all public-record connectors now", "security": [ { "AdminKey": [] } ], "responses": { "202": { "description": "Started" }, "401": { "description": "Unauthorized" } } } }, "/v1/admin/distribute/indexnow": { "post": { "summary": "Submit sitemap URLs to IndexNow (refuses while the site is not public)", "security": [ { "AdminKey": [] } ], "responses": { "200": { "description": "Submitted" }, "401": { "description": "Unauthorized" }, "409": { "description": "Site not publicly reachable" } } } }, "/v1/billing/checkout": { "post": { "summary": "Start checkout (or free early access while billing is off)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "experiment_slug", "plan_id" ], "properties": { "email": { "type": "string" }, "company_or_domain": { "type": "string" }, "experiment_slug": { "type": "string" }, "plan_id": { "type": "string" }, "billing_interval": { "type": "string", "enum": [ "month", "year" ] } } } } } }, "responses": { "200": { "description": "Checkout URL or early-access key", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/billing/webhook": { "post": { "summary": "Stripe webhook (signature verified)", "responses": { "200": { "description": "Received" }, "400": { "description": "Invalid signature" } } } }, "/v1/billing/status": { "get": { "summary": "Billing mode and subscription status", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "Status", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/support": { "post": { "summary": "Submit a support ticket (instant rule-based answer)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string" }, "category": { "type": "string", "enum": [ "refund_request", "cancel_subscription", "billing_question", "technical_help", "feature_request" ] }, "experiment_slug": { "type": "string" }, "message": { "type": "string" }, "api_key": { "type": "string" } } } } } }, "responses": { "200": { "description": "Ticket", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/support/cancel": { "post": { "summary": "Instant cancellation (requires pb_live_ key)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "api_key" ], "properties": { "api_key": { "type": "string" } } } } } }, "responses": { "200": { "description": "Ticket receipt", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/support/refund": { "post": { "summary": "Instant refund within 14 days (requires pb_live_ key)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "api_key" ], "properties": { "api_key": { "type": "string" } } } } } }, "responses": { "200": { "description": "Ticket receipt", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/support/recover": { "post": { "summary": "Look up or re-issue a key (with key) or request recovery (with email)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string" }, "email": { "type": "string" }, "rotate": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Account or ticket", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } } } }, "/v1/admin/telemetry": { "get": { "summary": "Portfolio scorecard", "security": [ { "AdminKey": [] } ], "responses": { "200": { "description": "Metrics" }, "401": { "description": "Unauthorized" } } } }, "/v1/admin/support": { "get": { "summary": "List support tickets", "security": [ { "AdminKey": [] } ], "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Tickets" }, "401": { "description": "Unauthorized" } } } }, "/v1/admin/support/{id}/resolve": { "post": { "summary": "Resolve a ticket", "security": [ { "AdminKey": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "note" ], "properties": { "note": { "type": "string" } } } } } }, "responses": { "200": { "description": "Resolved" }, "401": { "description": "Unauthorized" } } } }, "/mcp": { "post": { "summary": "MCP Streamable HTTP endpoint (JSON-RPC 2.0)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "JSON-RPC response" }, "202": { "description": "Notification accepted" } } } } } }