# MarketPulse

> Marketing intelligence API for the AI era — LLM visibility, channel mix strategy, content briefs, ad copy, local SEO, email sequences, competitor gap analysis, social strategy, ROI forecasting, and technical SEO audits. Pay-per-query via x402 on Base.

## What This Is

MarketPulse answers the marketing questions small businesses, freelancers, and growth teams don't have agency budgets to solve. Works globally — covers Western platforms (Meta, Google, TikTok, LinkedIn) and Asian platforms (WeChat/Weixin, Douyin, Xiaohongshu/RED, LINE, Kakao, Bilibili, Naver). Built specifically for the post-SEO world where Google AI Overviews answer without clicks and ChatGPT recommends without search. The flagship `/api/market/llm-visibility` endpoint is the only pay-per-query tool for AI citation optimization.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/market/llm-visibility?brand={brand}&topic={topic}
- Returns: AI citation likelihood assessment, E-E-A-T gap analysis, schema recommendations, content types AI models favor, 6-week improvement roadmap
- At least one of brand or topic required
- Price: $0.15

GET /api/market/content-brief?topic={topic}&audience={audience}
- Returns: dual-optimized content brief with structure, headings, E-E-A-T requirements, schema to add, AI visibility tactics, unique data angle, internal linking
- topic required
- Price: $0.15

GET /api/market/channel-mix?business_type={type}&budget={budget}
- Returns: channel allocation with specific budget percentages, ROI timeline, channel notes, test budget, first-30-days actions
- business_type required
- Price: $0.10

GET /api/market/roi-forecast?industry={industry}&budget={budget}&channels={channels}
- Returns: projected outcomes per channel (impressions, leads, revenue), industry benchmarks for CPC/CPA/ROAS, scaling trigger, kill switch trigger
- industry and budget required
- Price: $0.08

GET /api/market/competitor-gap?competitor={name}&industry={industry}
- Returns: identified gaps with opportunity size and how-to-exploit, content and channel gaps, positioning angle they haven't claimed, quick wins and 6-month attack plan
- competitor and industry required
- Price: $0.10

GET /api/market/ad-copy?platform={platform}&product={product}&goal={goal}
- Returns: 3 ready-to-use variants (headline + body + CTA), headline bank (5-8 options), hook bank, compliance notes, targeting parameters
- platform and product required
- Price: $0.08

GET /api/market/email-sequence?product={product}&goal={goal}&sequence_type={type}
- Returns: full sequence with subject lines, preview text, timing, body outline per email, deliverability rules, segmentation note, A/B subject line bank
- product and goal required; sequence_type: welcome|nurture|abandoned_cart|post_purchase|re_engagement
- Price: $0.15

GET /api/market/social-strategy?platform={platform}&industry={industry}
- Returns: algorithm summary, content formats ranked by reach/effort, posting cadence with best times, content pillars with ideas, hook formulas, what to stop doing
- platform and industry required
- Price: $0.08

GET /api/market/local-seo?business={type}&location={location}
- Returns: GBP must-complete fields, photo/post/Q&A strategy, review ask script, priority citation directories, on-page local changes, quick wins, 6-month roadmap
- business required
- Price: $0.08

GET /api/market/seo-audit?website={url}&industry={industry}
- Returns: prioritized audit by category (Core Web Vitals, Technical, On-Page, E-E-A-T, Schema, AI Readiness), quick wins, schema recommendations, top 5 fixes in order of impact
- website and industry required
- Price: $0.10

## Discovery

- OpenAPI spec: https://marketpulse-brown.vercel.app/openapi.json
- Agent discovery: https://marketpulse-brown.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Natural flow: /api/market/competitor-gap → /api/market/content-brief → /api/market/llm-visibility
- /api/market/llm-visibility and /api/market/content-brief both include Amazon book links (affiliate tag auto-injected)
- All endpoints accept ?lang= for any language
- /api/market/ad-copy includes platform compliance notes — always review before launching campaigns