# Boring Marketing

> The marketing intelligence API for AI agents

- [Boring Marketing API](https://docs.boringmarketing.com/introduction.md): The marketing intelligence API for AI agents. Monitor search surfaces, discover content opportunities, generate briefs, draft articles, and track citations — all through a single API.
- [Quickstart](https://docs.boringmarketing.com/quickstart.md): Create an account via Stripe checkout, add your brand, run the pipeline, and see ranked content opportunities — from your terminal in under 10 minutes.
- [API Overview](https://docs.boringmarketing.com/api-reference/overview.md): Base URL, authentication, request format, error handling, rate limits, and async patterns for the Boring Marketing API.
- [Content Lifecycle](https://docs.boringmarketing.com/concepts/content-lifecycle.md): From ranked opportunity to published content to tracked outcomes. The full execution loop that closes the gap between intelligence and results.
- [Pipeline Overview](https://docs.boringmarketing.com/concepts/pipeline-overview.md): How the enrichment pipeline works — from brand registration through opportunity scoring. Understand each stage, what data it produces, and which endpoints to call.
- [Signals & Opportunities](https://docs.boringmarketing.com/concepts/signals-and-opportunities.md): How the API detects opportunity signals across 6 search surfaces and converts them into scored, actionable opportunities with priority rankings.
- [Agent Integration](https://docs.boringmarketing.com/guides/agent-integration.md): Reference tables, endpoint maps, and plain-text instructions for AI agents (Claude Code, Cursor, Codex) to autonomously operate the Boring Marketing API.
- [Authentication](https://docs.boringmarketing.com/guides/authentication.md): API key authentication, tier system, rate limits, key rotation, and creating an account via Stripe checkout.
- [Content Production](https://docs.boringmarketing.com/guides/content-production.md): Generate content briefs from your top opportunities and draft full articles — a step-by-step guide through the brief → draft → publish flow.
- [Documentation MCP](https://docs.boringmarketing.com/guides/mcp-server.md): Search and read the Boring Marketing documentation directly from your AI agent using our docs-only MCP server.
- [Polling Runs](https://docs.boringmarketing.com/guides/polling-runs.md): How to poll async pipeline runs, read stage progress, handle failures, and avoid duplicate runs.
- [Tracking Outcomes](https://docs.boringmarketing.com/guides/tracking-outcomes.md): Record published content in the learning loop, snapshot tracking data, compute changes between snapshots, and monitor rankings + LLM citations over time.
- [Billing Portal](https://docs.boringmarketing.com/api-reference/auth/billing-portal.md): Get a Stripe Customer Portal URL for managing subscription, updating payment methods, or reactivating a cancelled account.
- [Checkout Status](https://docs.boringmarketing.com/api-reference/auth/checkout-status.md): Poll for Stripe checkout completion. Response shape depends on whether the session was started in anonymous or authenticated mode.
- [Start Checkout](https://docs.boringmarketing.com/api-reference/auth/checkout.md): Create an account via Stripe checkout. Two modes: anonymous (server emails the link) or authenticated (fast-path inline URL).
- [Get My API Key](https://docs.boringmarketing.com/api-reference/auth/me-api-key.md): Return the current caller's API key. Used by the dashboard after a magic-link sign-in.
- [Get Current User](https://docs.boringmarketing.com/api-reference/auth/me.md): Returns your account information including tier and brand limit.
- [Recover API Key](https://docs.boringmarketing.com/api-reference/auth/recover.md): Start the API key recovery flow. Directs users to sign in to the dashboard via a magic link.
- [Register (Removed)](https://docs.boringmarketing.com/api-reference/auth/register.md): Self-serve free registration was removed. All accounts are now created via Stripe checkout.
- [Rotate API Key](https://docs.boringmarketing.com/api-reference/auth/rotate-key.md): Generate a new API key and invalidate the old one in a single atomic operation.
- [Check Usage](https://docs.boringmarketing.com/api-reference/auth/usage.md): Returns your current daily API usage against your tier limits.
- [Create Brand](https://docs.boringmarketing.com/api-reference/brands/create.md): Register a new brand for analysis. Returns the existing brand if the domain is already registered under your account.
- [Delete Brand](https://docs.boringmarketing.com/api-reference/brands/delete.md): Delete a brand registration. Does NOT cascade to pipeline data.
- [Get Brand](https://docs.boringmarketing.com/api-reference/brands/get.md): Retrieve a brand's full context including identity, competitors, brand pages, technical audit, and voice profile.
- [List Brands](https://docs.boringmarketing.com/api-reference/brands/list.md): List all brands registered under your account.
- [Reset Brand](https://docs.boringmarketing.com/api-reference/brands/reset.md): Clear all pipeline data for a brand while keeping the brand registration.
- [Update Brand](https://docs.boringmarketing.com/api-reference/brands/update.md): Update a brand's name or competitor list.
- [Full Pipeline](https://docs.boringmarketing.com/api-reference/pipeline/analyze.md): Run the complete intelligence pipeline end-to-end: brand enrichment, competitor discovery, keyword universe, evidence collection, opportunity synthesis, and leverage scoring.
- [Discover Competitors](https://docs.boringmarketing.com/api-reference/pipeline/discover-competitors.md): Automatically discover competitors in your space using JTBD-framed research.
- [Discover](https://docs.boringmarketing.com/api-reference/pipeline/discover.md): Build the keyword universe, collect evidence, and synthesize scored opportunities.
- [Enrich Brand](https://docs.boringmarketing.com/api-reference/pipeline/enrich-brand.md): Crawl the brand website to extract trust signals, services, certifications, and identify content gaps.
- [LLM Enrichment](https://docs.boringmarketing.com/api-reference/pipeline/enrich-llm.md): Pull LLM citation metrics via DataForSEO: AI search volume, citation gaps, and competitor comparison. Populates brand.llm_context.
- [Technical Enrichment](https://docs.boringmarketing.com/api-reference/pipeline/enrich-technical.md): Run a technical site audit via GemMiner or upload an existing audit. Populates brand.technical_context plus technical_issue insights and evidence.
- [Score](https://docs.boringmarketing.com/api-reference/pipeline/score.md): Re-run leverage scoring to rebuild the action queue from existing opportunities and brand insights.
- [Re-Synthesize Opportunities](https://docs.boringmarketing.com/api-reference/pipeline/synthesize.md): Re-run opportunity synthesis and scoring from existing families + evidence, without re-crawling or re-calling DataForSEO.
- [Generate Brief](https://docs.boringmarketing.com/api-reference/content/brief.md): Generate a content brief from a queue item. Returns 202 — poll for completion.
- [List Briefs](https://docs.boringmarketing.com/api-reference/content/briefs-list.md): List all generated content briefs for a brand.
- [Execute Draft](https://docs.boringmarketing.com/api-reference/content/execute.md): Draft a full article from a content brief using Opus. Returns 202 — poll for completion.
- [Get Execution](https://docs.boringmarketing.com/api-reference/content/executions.md): Retrieve a completed content draft. The article content lives in the outputs field.
- [Evidence](https://docs.boringmarketing.com/api-reference/results/evidence.md): Get raw SERP evidence, citation data, technical audit findings, and competitive signals collected during pipeline runs.
- [Families](https://docs.boringmarketing.com/api-reference/results/families.md): Get the keyword universe organized by topic families.
- [Update Family Keywords](https://docs.boringmarketing.com/api-reference/results/family-keywords-update.md): Replace the keyword list on a specific topic family.
- [Insights](https://docs.boringmarketing.com/api-reference/results/insights.md): Get brand findings from enrichment — trust gaps, E-E-A-T issues, content gaps, and technical issues.
- [Opportunities](https://docs.boringmarketing.com/api-reference/results/opportunities.md): Get ranked content opportunities sorted by priority score.
- [Check Outcomes](https://docs.boringmarketing.com/api-reference/results/outcomes-check.md): Run milestone checks for any outcomes overdue for 7/30/90-day observation. Batches DataForSEO calls to minimize cost.
- [List Outcomes](https://docs.boringmarketing.com/api-reference/results/outcomes.md): Get outcome events with milestone tracking data. This is the learning-loop read endpoint.
- [Get Queue Item](https://docs.boringmarketing.com/api-reference/results/queue-get.md): Fetch a single action queue item by ID. Returns the bare item shape (not wrapped in a list envelope).
- [Action Queue](https://docs.boringmarketing.com/api-reference/results/queue.md): Get the unified action queue — opportunities and brand fixes ranked by leverage score.
- [Cancel Run](https://docs.boringmarketing.com/api-reference/runs/cancel.md): Mark a stuck or running pipeline run as failed. Use when a run has not made progress for more than 15 minutes.
- [Get Run](https://docs.boringmarketing.com/api-reference/runs/get.md): Get the status and progress of a specific pipeline run.
- [List Runs](https://docs.boringmarketing.com/api-reference/runs/list.md): List all pipeline runs for a brand, with status and stage information.
- [AI Overviews](https://docs.boringmarketing.com/api-reference/tracking/aio.md): Check Google AI Overview presence for your brand's topic family hub keywords.
- [Get Tracking Changes](https://docs.boringmarketing.com/api-reference/tracking/changes.md): Compute the delta between the latest tracking snapshot and an earlier one. Returns structured ranking and citation deltas.
- [Citations](https://docs.boringmarketing.com/api-reference/tracking/citations.md): Get LLM citation metrics for your brand's domain — total mentions, impressions, and per-platform breakdown.
- [Report Outcome Event](https://docs.boringmarketing.com/api-reference/tracking/outcomes-report.md): Record an outcome event for the learning loop — accepted, rejected, completed, or observed at 7/30/90 days.
- [Rankings](https://docs.boringmarketing.com/api-reference/tracking/rankings.md): Get current Google organic rankings for your brand's domain. Always fresh, pulled from DataForSEO on every call.
- [Full Report](https://docs.boringmarketing.com/api-reference/tracking/report.md): Get a combined 30-day report with Google organic, LLM citations, and competitor comparison.
- [Create Tracking Snapshot](https://docs.boringmarketing.com/api-reference/tracking/snapshot.md): Capture a point-in-time snapshot of rankings and LLM citations for later diff computation.