Blueprint

A blueprint is the market intelligence behind AI-powered marketing plan generation. It studies a company's market position, competitive landscape, geographic opportunities, seasonal patterns, and target audiences. One blueprint can power multiple marketing plans, so the same intelligence can drive several plans with different budgets, channels, and durations.

API operations

Relationships

Every blueprint belongs to an advertiser. The advertiser provides the organizational context.
A blueprint serves as the foundation for one or more plans. Plans reference a blueprint by ID and inherit its market analysis and personas as a starting point.

Statuses

processing
Blueprint is being generated by AI. Market analysis and personas are not yet available.
ready
Blueprint generation is complete. Market analysis and personas are available. Plans can be created from this blueprint.
deleted
Blueprint has been deleted.

Key concepts

Market Analysis
Structured market intelligence containing 7 sections: strategic overview, industry context, competitive landscape (with competitor profiles), geographic opportunities (with scored clusters), seasonal patterns, core market challenges, and insights summary.
Personas
AI-generated audience profiles with demographics, psychographics (triggers and barriers), audience segments, and strategic prioritization ranking.
Blueprint Reuse
Blueprints capture market intelligence that is independent of plan-specific parameters like budget and duration. This allows creating multiple plan variants from one blueprint without re-running the market research.

Constraints

Rules to follow
  • companyName and companyDomain are required at creation.
  • Blueprint generation is asynchronous and can take up to 24 hours.
  • Market analysis and personas are only populated when status is 'ready' (and are not included in list responses).

Market Analysis Structure

The marketAnalysis object contains 7 research sections. Strategic overview: businessPositioning, coreMarketChallengesAndOpportunities, analyticalFramework. Industry context analysis: marketSizeAndGrowth, transformativeTrends, regulatoryConsiderations, seasonalImpacts, relatedIndustryInfluences, economicIndicators. Competitive landscape: competitiveAssessmentMethodology, keyCompetitorProfiles, marketPositioningAnalysis, shareOfVoiceAnalysis, gapAnalysis, competitivePositioningOpportunities. Geographic opportunities: geographicTargetingMethodology, regionalDemandAnalysis, opportunityScoringSystem, competitiveDensityAnalysis, demographicAnalysis, environmentalConsiderations. Seasonal and cyclical patterns: keySeasonalCycles, externalFactorAnalysis, demandVariationQuantification, consumerBehaviorTrends. Core challenges in market: coreChallengesInTheMarket, challengePrioritizationAnalysis, marketConstraintAnalysis. Insights summary: keyFindingsSynthesis, strategicDirection, businessSpecificStrategicInsights.

Persona Structure

Each persona includes id, name, description, demographics (ageRange, gender, incomeRange, education, occupation, lifestage, homeValue), triggers, barriers, rank, and prioritizationReason.

When building apps

Generation And Reuse Flow
Create a blueprint with company name and domain, then poll get-blueprint with exponential backoff until status becomes 'ready' - generation can take up to 24 hours, so don't hold the user on a loading screen. Once ready, use the blueprint ID to create plans with budget, channel, and persona configuration. A single blueprint can back multiple plan variants, so reuse it rather than re-running the market research for each plan.