{ "openapi": "3.0.1", "info": { "title": "SEOAnalyzer.API", "version": "1.0" }, "paths": { "/api/v1/queries/{id}/run": { "post": { "tags": [ "PublicActions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicRunRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PublicRunRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/PublicRunRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/gaps/detect": { "post": { "tags": [ "PublicActions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDetectRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PublicDetectRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/PublicDetectRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/opportunities/{id}/generate-brief": { "post": { "tags": [ "PublicActions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicBriefRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PublicBriefRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/PublicBriefRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/opportunities/{id}/generate-content": { "post": { "tags": [ "PublicActions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicContentRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PublicContentRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/PublicContentRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/opportunities/{id}/publish": { "post": { "tags": [ "PublicActions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicPublishRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PublicPublishRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/PublicPublishRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/brand-check": { "post": { "tags": [ "PublicBrandCheck" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrandCheckRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BrandCheckRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/BrandCheckRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BrandCheckResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BrandCheckResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BrandCheckResponse" } } } } } } }, "/api/v1/citations": { "get": { "tags": [ "PublicCitations" ], "parameters": [ { "name": "platform", "in": "query", "schema": { "type": "string" } }, { "name": "sentiment", "in": "query", "schema": { "type": "string" } }, { "name": "sourceType", "in": "query", "schema": { "type": "string" } }, { "name": "hasMention", "in": "query", "schema": { "type": "boolean" } }, { "name": "searchQuery", "in": "query", "schema": { "type": "string" } }, { "name": "dateFrom", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "dateTo", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "page", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/citations/{id}": { "get": { "tags": [ "PublicCitations" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/competitors": { "get": { "tags": [ "PublicCompetitors" ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/competitors/{id}": { "get": { "tags": [ "PublicCompetitors" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/gaps": { "get": { "tags": [ "PublicGaps" ], "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/opportunities": { "get": { "tags": [ "PublicGaps" ], "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/opportunities/{id}": { "get": { "tags": [ "PublicGaps" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/jobs/{id}": { "get": { "tags": [ "PublicJobs" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/jobs": { "get": { "tags": [ "PublicJobs" ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "status", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/me": { "get": { "tags": [ "PublicMe" ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/me/credits": { "get": { "tags": [ "PublicMe" ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/queries": { "get": { "tags": [ "PublicQueries" ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/queries/{id}": { "get": { "tags": [ "PublicQueries" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/webhooks": { "get": { "tags": [ "PublicWebhooks" ], "responses": { "200": { "description": "OK" } } }, "post": { "tags": [ "PublicWebhooks" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookSubscriptionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookSubscriptionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateWebhookSubscriptionRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/webhooks/{id}": { "get": { "tags": [ "PublicWebhooks" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } }, "put": { "tags": [ "PublicWebhooks" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookSubscriptionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookSubscriptionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookSubscriptionRequest" } } } }, "responses": { "200": { "description": "OK" } } }, "delete": { "tags": [ "PublicWebhooks" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/webhooks/{id}/ping": { "post": { "tags": [ "PublicWebhooks" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "AICitationMetricsDto": { "type": "object", "properties": { "conversationContext": { "type": "string", "nullable": true }, "originalQuery": { "type": "string", "nullable": true }, "aiModel": { "type": "string", "nullable": true }, "responseLength": { "type": "integer", "format": "int32" }, "mentionCount": { "type": "integer", "format": "int32" }, "competitorMentioned": { "type": "boolean" }, "citationAccuracy": { "type": "number", "format": "double", "nullable": true }, "contextRelevance": { "type": "number", "format": "double", "nullable": true }, "responseHelpfulness": { "type": "number", "format": "double", "nullable": true }, "citedEntities": { "type": "array", "items": { "type": "string" }, "nullable": true }, "entityRelevanceScores": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "primaryCompetitor": { "type": "string", "nullable": true }, "competitivePositionScore": { "type": "number", "format": "double" }, "entityMentions": { "type": "array", "items": { "$ref": "#/components/schemas/EntityMentionDto" }, "nullable": true }, "competitorPositions": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true } }, "additionalProperties": false }, "AIQueryStrategyResponse": { "type": "object", "properties": { "queries": { "type": "array", "items": { "$ref": "#/components/schemas/SuggestedQuery" }, "nullable": true }, "suggestedPlatforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedFrequency": { "type": "integer", "format": "int32" }, "reasoning": { "type": "string", "nullable": true } }, "additionalProperties": false }, "AddCreditsRequest": { "type": "object", "properties": { "amount": { "type": "integer", "format": "int32" }, "type": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true } }, "additionalProperties": false }, "AeoSnapshotRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true }, "competitorName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "Alert": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "alertType": { "type": "string", "nullable": true }, "severity": { "type": "string", "nullable": true }, "isEnabled": { "type": "boolean" }, "conditions": { "type": "object", "additionalProperties": { }, "nullable": true }, "notificationChannels": { "type": "array", "items": { "type": "string" }, "nullable": true }, "tenantId": { "type": "integer", "format": "int32" }, "brandProfileId": { "type": "integer", "format": "int32", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "lastTriggeredAt": { "type": "string", "format": "date-time", "nullable": true }, "triggerCount": { "type": "integer", "format": "int32" }, "metadata": { "type": "object", "additionalProperties": { }, "nullable": true } }, "additionalProperties": false }, "AlertResponse": { "type": "object", "properties": { "alerts": { "type": "array", "items": { "$ref": "#/components/schemas/Alert" }, "nullable": true }, "stats": { "$ref": "#/components/schemas/AlertStats" } }, "additionalProperties": false }, "AlertStats": { "type": "object", "properties": { "totalAlerts": { "type": "integer", "format": "int32" }, "activeAlerts": { "type": "integer", "format": "int32" }, "triggeredToday": { "type": "integer", "format": "int32" }, "alertsBySeverity": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true }, "alertsByType": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true } }, "additionalProperties": false }, "AlertTrigger": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "alertId": { "type": "string", "nullable": true }, "alertName": { "type": "string", "nullable": true }, "alertType": { "type": "string", "nullable": true }, "severity": { "type": "string", "nullable": true }, "message": { "type": "string", "nullable": true }, "triggerData": { "type": "object", "additionalProperties": { }, "nullable": true }, "triggeredAt": { "type": "string", "format": "date-time" }, "isAcknowledged": { "type": "boolean" }, "acknowledgedAt": { "type": "string", "format": "date-time", "nullable": true }, "acknowledgedBy": { "type": "string", "nullable": true }, "tenantId": { "type": "integer", "format": "int32" }, "brandProfileId": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "AlertTriggerResponse": { "type": "object", "properties": { "recentTriggers": { "type": "array", "items": { "$ref": "#/components/schemas/AlertTrigger" }, "nullable": true }, "totalTriggers": { "type": "integer", "format": "int32" }, "unacknowledgedTriggers": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "AnalyzeWebsiteRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true }, "fullAnalysis": { "type": "boolean" } }, "additionalProperties": false }, "ApprovalRequestDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "action": { "type": "string", "nullable": true }, "resourceRef": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "requestedBy": { "type": "string", "nullable": true }, "reviewedBy": { "type": "string", "nullable": true }, "reason": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "reviewedAt": { "type": "string", "format": "date-time", "nullable": true }, "payload": { "nullable": true }, "summary": { "type": "string", "nullable": true }, "resourceTitle": { "type": "string", "nullable": true }, "queryText": { "type": "string", "nullable": true }, "destinationName": { "type": "string", "nullable": true }, "destinationType": { "type": "string", "nullable": true } }, "additionalProperties": false }, "AttachPaymentMethodRequest": { "type": "object", "properties": { "paymentMethodId": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BrandCheckCompetitor": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "citedUrl": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BrandCheckPlatformResult": { "type": "object", "properties": { "platform": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "mentionCount": { "type": "integer", "format": "int32" }, "evidenceSnippet": { "type": "string", "nullable": true }, "competitors": { "type": "array", "items": { "type": "string" }, "nullable": true }, "competitorCitedUrls": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "errorMessage": { "type": "string", "nullable": true }, "costIncurred": { "type": "number", "format": "double" }, "modelUsed": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BrandCheckRequest": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "recaptchaToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BrandCheckResponse": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "visibilityScore": { "type": "integer", "format": "int32" }, "grade": { "type": "string", "nullable": true }, "platforms": { "type": "array", "items": { "$ref": "#/components/schemas/BrandCheckPlatformResult" }, "nullable": true }, "topCompetitors": { "type": "array", "items": { "type": "string" }, "nullable": true }, "topCompetitorCitedPages": { "type": "array", "items": { "$ref": "#/components/schemas/BrandCheckCompetitor" }, "nullable": true }, "summary": { "type": "string", "nullable": true }, "hasUpsell": { "type": "boolean" }, "requestId": { "type": "string", "nullable": true }, "completedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "BrandMention": { "type": "object", "properties": { "text": { "type": "string", "nullable": true }, "confidence": { "type": "integer", "format": "int32" }, "context": { "type": "string", "nullable": true }, "sourceUrl": { "type": "string", "nullable": true }, "position": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "BrandMentionDto": { "type": "object", "properties": { "text": { "type": "string", "nullable": true }, "matchType": { "type": "string", "nullable": true }, "confidence": { "type": "number", "format": "double" }, "context": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "isCompetitor": { "type": "boolean" }, "entityMentions": { "type": "array", "items": { "$ref": "#/components/schemas/EntityMentionDto" }, "nullable": true } }, "additionalProperties": false }, "BrandPerformanceDto": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "visibilityScore": { "type": "number", "format": "double" }, "mentionCount": { "type": "integer", "format": "int32" }, "trend": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BrandProfileDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "userId": { "type": "integer", "format": "int32" }, "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "keywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "visibilityScore": { "type": "integer", "format": "int32" }, "lastVisibilityCalculation": { "type": "string", "format": "date-time", "nullable": true }, "isActive": { "type": "boolean" }, "monitoringFrequencyHours": { "type": "integer", "format": "int32" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "searchQueryCount": { "type": "integer", "format": "int32" }, "visibilityResultCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "BrandVisibilityTrendDto": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "averageVisibilityScore": { "type": "number", "format": "double" }, "totalMentions": { "type": "integer", "format": "int32" }, "resultCount": { "type": "integer", "format": "int32" }, "platforms": { "type": "array", "items": { "$ref": "#/components/schemas/PlatformScoreDto" }, "nullable": true } }, "additionalProperties": false }, "CitationDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "tenantId": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "platformIcon": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "relevanceScore": { "type": "number", "format": "double" }, "engagementMetrics": { "$ref": "#/components/schemas/EngagementMetricsDto" }, "aiCitationMetrics": { "$ref": "#/components/schemas/AICitationMetricsDto" }, "tags": { "type": "array", "items": { "type": "string" }, "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "searchQueryId": { "type": "integer", "format": "int32", "nullable": true }, "searchQueryText": { "type": "string", "nullable": true }, "aiOverviewDetected": { "type": "boolean" }, "aiOverviewState": { "type": "string", "nullable": true }, "inlineCitationCount": { "type": "integer", "format": "int32" }, "citationSourceType": { "type": "string", "nullable": true }, "visibilityResultId": { "type": "integer", "format": "int32", "nullable": true }, "detectionVerdict": { "type": "string", "nullable": true }, "detectionConfidence": { "type": "number", "format": "double", "nullable": true }, "detectionEvidence": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CitationEvidenceAnswerDto": { "type": "object", "properties": { "visibilityResultId": { "type": "integer", "format": "int32" }, "queryTextUsed": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "answerText": { "type": "string", "nullable": true }, "executedAt": { "type": "string", "format": "date-time" }, "visibilityScore": { "type": "integer", "format": "int32" }, "resultUrl": { "type": "string", "nullable": true }, "resultTitle": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CitationEvidenceDto": { "type": "object", "properties": { "citationId": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "citationSourceType": { "type": "string", "nullable": true }, "linkConfidence": { "type": "string", "nullable": true }, "linkMethod": { "type": "string", "nullable": true }, "visibilityResultId": { "type": "integer", "format": "int32", "nullable": true }, "linkKind": { "type": "string", "nullable": true }, "originatingAnswer": { "$ref": "#/components/schemas/CitationEvidenceAnswerDto" } }, "additionalProperties": false }, "CitationScanToOpportunityRequest": { "type": "object", "properties": { "sourceUrl": { "type": "string", "nullable": true }, "strengths": { "type": "array", "items": { "type": "string" }, "nullable": true }, "gaps": { "type": "array", "items": { "type": "string" }, "nullable": true }, "detectedEntities": { "type": "array", "items": { "type": "string" }, "nullable": true }, "detectedSchemaTypes": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "CitationSignalItem": { "type": "object", "properties": { "signalId": { "type": "string", "nullable": true }, "label": { "type": "string", "nullable": true }, "level": { "type": "string", "nullable": true }, "boost": { "type": "string", "nullable": true }, "improvementInstruction": { "type": "string", "nullable": true }, "isStrength": { "type": "boolean" }, "priority": { "type": "integer", "format": "int32" }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "effort": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CitationStatsDto": { "type": "object", "properties": { "total": { "type": "integer", "format": "int32" }, "positive": { "type": "integer", "format": "int32" }, "neutral": { "type": "integer", "format": "int32" }, "negative": { "type": "integer", "format": "int32" }, "byPlatform": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true }, "byBrand": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true }, "byDateRange": { "type": "array", "items": { "$ref": "#/components/schemas/DateRangeCountDto" }, "nullable": true } }, "additionalProperties": false }, "CitedSourceItem": { "type": "object", "properties": { "title": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "domain": { "type": "string", "nullable": true }, "citedAt": { "type": "string", "format": "date-time" }, "searchQuery": { "type": "string", "nullable": true }, "contentType": { "type": "string", "nullable": true }, "authorityTier": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CloneTenantRequest": { "type": "object", "properties": { "sourceTenantId": { "type": "integer", "format": "int32" }, "businessName": { "type": "string", "nullable": true }, "businessEmail": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "targetKeywords": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "CoOccurringCompetitor": { "type": "object", "properties": { "competitorName": { "type": "string", "nullable": true }, "coOccurrenceCount": { "type": "integer", "format": "int32" }, "averageRelevanceScore": { "type": "number", "format": "double" } }, "additionalProperties": false }, "ComparisonMetrics": { "type": "object", "properties": { "marketShare": { "type": "number", "format": "double" }, "sentimentScore": { "type": "number", "format": "double" }, "platformPresence": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "engagementRate": { "type": "number", "format": "double" }, "growthRate": { "type": "number", "format": "double" }, "brandAuthority": { "type": "number", "format": "double" } }, "additionalProperties": false }, "CompetitorAnalysis": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "competitorId": { "type": "integer", "format": "int32", "nullable": true }, "competitorName": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true }, "tenantId": { "type": "integer", "format": "int32" }, "industry": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "mentionCount": { "type": "integer", "format": "int32" }, "visibilityScore": { "type": "number", "format": "double" }, "trend": { "type": "string", "nullable": true }, "trendPercentage": { "type": "number", "format": "double" }, "comparisonMetrics": { "$ref": "#/components/schemas/ComparisonMetrics" }, "lastAnalyzed": { "type": "string", "format": "date-time" }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "recentMentions": { "type": "array", "items": { "$ref": "#/components/schemas/CompetitorMention" }, "nullable": true }, "platformScores": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "rank": { "type": "integer", "format": "int32", "nullable": true }, "notes": { "type": "string", "nullable": true }, "firstDetected": { "type": "string", "format": "date-time" }, "lastDetected": { "type": "string", "format": "date-time" }, "score": { "$ref": "#/components/schemas/CompetitorScore" }, "trends": { "type": "array", "items": { "$ref": "#/components/schemas/CompetitorTrend" }, "nullable": true }, "strength": { "type": "string", "nullable": true }, "platformDistribution": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "citationReferences": { "type": "array", "items": { "type": "integer", "format": "int32" }, "nullable": true }, "marketShare": { "type": "number", "format": "double", "nullable": true }, "analysisDate": { "type": "string", "format": "date-time" }, "totalMentionInstances": { "type": "integer", "format": "int32" }, "averageMentionsPerCitation": { "type": "number", "format": "double" }, "crossQueryPersistenceCount": { "type": "integer", "format": "int32" }, "mentionVelocityScore": { "type": "number", "format": "double" }, "imageUrl": { "type": "string", "nullable": true }, "detailedDescription": { "type": "string", "nullable": true }, "detailedDescriptionUrl": { "type": "string", "nullable": true }, "sameAsUrls": { "type": "array", "items": { "type": "string" }, "nullable": true }, "coOccurringCompetitors": { "type": "array", "items": { "$ref": "#/components/schemas/CoOccurringCompetitor" }, "nullable": true }, "platformGaps": { "type": "array", "items": { "type": "string" }, "nullable": true }, "sentimentTrend": { "type": "array", "items": { "$ref": "#/components/schemas/SentimentTrendPoint" }, "nullable": true }, "topPerformingQueries": { "type": "array", "items": { "$ref": "#/components/schemas/QueryAttribution" }, "nullable": true }, "dataSource": { "type": "string", "nullable": true }, "recencyBand": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CompetitorComparisonRequest": { "type": "object", "properties": { "competitorIds": { "type": "array", "items": { "type": "string" }, "nullable": true }, "timeRange": { "type": "string", "nullable": true }, "metrics": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "CompetitorComparisonResponse": { "type": "object", "properties": { "comparisonData": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "type": "number", "format": "double" } }, "nullable": true }, "metrics": { "type": "array", "items": { "type": "string" }, "nullable": true }, "generatedAt": { "type": "string", "format": "date-time" }, "insights": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CompetitorDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "tenantId": { "type": "integer", "format": "int32" }, "name": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "keywords": { "type": "string", "nullable": true }, "isActive": { "type": "boolean" }, "isDismissed": { "type": "boolean" }, "dismissedAt": { "type": "string", "format": "date-time", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time", "nullable": true }, "visibilityRank": { "type": "integer", "format": "int32", "nullable": true }, "imageUrl": { "type": "string", "nullable": true }, "detailedDescription": { "type": "string", "nullable": true }, "detailedDescriptionUrl": { "type": "string", "nullable": true }, "sameAsUrls": { "type": "array", "items": { "type": "string" }, "nullable": true }, "totalMentions": { "type": "integer", "format": "int32" }, "lastDetected": { "type": "string", "format": "date-time", "nullable": true }, "dataSource": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CompetitorInfo": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "isTracked": { "type": "boolean" } }, "additionalProperties": false }, "CompetitorMention": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "context": { "type": "string", "nullable": true }, "sourceUrl": { "type": "string", "nullable": true }, "timestamp": { "type": "string", "format": "date-time" }, "confidence": { "type": "number", "format": "double" }, "sentiment": { "type": "string", "nullable": true }, "keywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "mentionContextType": { "type": "string", "nullable": true }, "confidenceQualifier": { "type": "string", "nullable": true }, "citationSourceType": { "type": "string", "nullable": true }, "citationTitle": { "type": "string", "nullable": true }, "citationSnippet": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CompetitorMentionCountDto": { "type": "object", "properties": { "competitorId": { "type": "integer", "format": "int32" }, "competitorName": { "type": "string", "nullable": true }, "mentionCount": { "type": "integer", "format": "int32" }, "periodStart": { "type": "string", "format": "date-time" }, "periodEnd": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CompetitorScore": { "type": "object", "properties": { "mentionVelocityScore": { "type": "number", "format": "double" }, "sentimentScore": { "type": "number", "format": "double" }, "mentionCountScore": { "type": "number", "format": "double" }, "trendScore": { "type": "number", "format": "double" }, "overallScore": { "type": "number", "format": "double" }, "platformDiversityScore": { "type": "number", "format": "double", "nullable": true }, "queryBreadthScore": { "type": "number", "format": "double", "nullable": true }, "contentQualityScore": { "type": "number", "format": "double", "nullable": true } }, "additionalProperties": false }, "CompetitorTrackingResponse": { "type": "object", "properties": { "competitors": { "type": "array", "items": { "$ref": "#/components/schemas/CompetitorAnalysis" }, "nullable": true }, "generatedAt": { "type": "string", "format": "date-time" }, "summary": { "type": "string", "nullable": true }, "platformDistribution": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "industryDistribution": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "webMentions": { "type": "array", "items": { "$ref": "#/components/schemas/WebMentionItem" }, "nullable": true }, "citedSources": { "type": "array", "items": { "$ref": "#/components/schemas/CitedSourceItem" }, "nullable": true } }, "additionalProperties": false }, "CompetitorTrend": { "type": "object", "properties": { "period": { "type": "string", "format": "date-time" }, "mentionCount": { "type": "integer", "format": "int32" }, "score": { "type": "number", "format": "double" }, "mentionVelocityScore": { "type": "number", "format": "double" }, "sentimentScore": { "type": "number", "format": "double" }, "trendScore": { "type": "number", "format": "double" } }, "additionalProperties": false }, "CompleteOnboardingRequest": { "type": "object", "properties": { "websiteUrl": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "targetKeywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "selectedPlatforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "scanFrequency": { "type": "string", "nullable": true }, "alertEmail": { "type": "string", "nullable": true }, "selectedQueries": { "type": "array", "items": { "$ref": "#/components/schemas/SelectedQueryItem" }, "nullable": true }, "skipped": { "type": "boolean" } }, "additionalProperties": false }, "CompleteRecommendationRequestDto": { "type": "object", "properties": { "notes": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ConfirmSubscriptionPaymentRequest": { "type": "object", "properties": { "paymentIntentId": { "type": "string", "nullable": true }, "userId": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ContactFormRequest": { "required": [ "email", "message", "name", "subject" ], "type": "object", "properties": { "name": { "minLength": 2, "type": "string" }, "email": { "minLength": 1, "type": "string", "format": "email" }, "subject": { "minLength": 5, "type": "string" }, "message": { "maxLength": 2000, "minLength": 10, "type": "string" }, "captchaToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ContentOpportunityDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "tenantId": { "type": "integer", "format": "int32" }, "brandProfileId": { "type": "integer", "format": "int32" }, "searchQueryId": { "type": "integer", "format": "int32", "nullable": true }, "queryText": { "type": "string", "nullable": true }, "gapType": { "type": "string", "nullable": true }, "citedCompetitors": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedTitle": { "type": "string", "nullable": true }, "targetIntent": { "type": "string", "nullable": true }, "targetEntities": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedHeadings": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedSchemaTypes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "contentFormat": { "type": "string", "nullable": true }, "recommendedWordCount": { "type": "integer", "format": "int32" }, "authoritySignalsNeeded": { "type": "string", "nullable": true }, "citationSignals": { "type": "array", "items": { "$ref": "#/components/schemas/CitationSignalItem" }, "nullable": true }, "generatedContent": { "type": "string", "nullable": true }, "generatedSchemaMarkup": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "priorityScore": { "type": "integer", "format": "int32" }, "contentPublishedUrl": { "type": "string", "nullable": true }, "contentPublishedAt": { "type": "string", "format": "date-time", "nullable": true }, "firstCitedAt": { "type": "string", "format": "date-time", "nullable": true }, "citationScore": { "type": "integer", "format": "int32", "nullable": true }, "groundingSources": { "type": "array", "items": { "$ref": "#/components/schemas/GroundingSource" }, "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "gapTypeLabel": { "type": "string", "nullable": true, "readOnly": true }, "statusLabel": { "type": "string", "nullable": true, "readOnly": true }, "intentLabel": { "type": "string", "nullable": true, "readOnly": true }, "formatLabel": { "type": "string", "nullable": true, "readOnly": true } }, "additionalProperties": false }, "ContentStudioStatsDto": { "type": "object", "properties": { "totalOpportunities": { "type": "integer", "format": "int32" }, "pending": { "type": "integer", "format": "int32" }, "briefGenerated": { "type": "integer", "format": "int32" }, "contentCreated": { "type": "integer", "format": "int32" }, "published": { "type": "integer", "format": "int32" }, "cited": { "type": "integer", "format": "int32" }, "highPriority": { "type": "integer", "format": "int32" }, "byGapType": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true }, "byFormat": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true } }, "additionalProperties": false }, "CostBreakdownItemDto": { "type": "object", "properties": { "label": { "type": "string", "nullable": true }, "cost": { "type": "number", "format": "double" }, "operationCount": { "type": "integer", "format": "int32" }, "totalTokens": { "type": "integer", "format": "int32" }, "percentage": { "type": "number", "format": "double" } }, "additionalProperties": false }, "CostLogEntryDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "tenantId": { "type": "integer", "format": "int32", "nullable": true }, "tenantName": { "type": "string", "nullable": true }, "operationType": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "model": { "type": "string", "nullable": true }, "inputTokens": { "type": "integer", "format": "int32", "nullable": true }, "outputTokens": { "type": "integer", "format": "int32", "nullable": true }, "totalTokens": { "type": "integer", "format": "int32", "nullable": true }, "costIncurred": { "type": "number", "format": "double" }, "executionDurationMs": { "type": "integer", "format": "int32", "nullable": true }, "isSuccess": { "type": "boolean" }, "errorMessage": { "type": "string", "nullable": true }, "referenceType": { "type": "string", "nullable": true }, "referenceId": { "type": "integer", "format": "int32", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CostLogEntryDtoPagedResultDto": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CostLogEntryDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" }, "totalPages": { "type": "integer", "format": "int32", "readOnly": true } }, "additionalProperties": false }, "CostSummaryDto": { "type": "object", "properties": { "totalCost": { "type": "number", "format": "double" }, "todayCost": { "type": "number", "format": "double" }, "thisWeekCost": { "type": "number", "format": "double" }, "thisMonthCost": { "type": "number", "format": "double" }, "totalOperations": { "type": "integer", "format": "int32" }, "totalTokens": { "type": "integer", "format": "int32" }, "failedOperations": { "type": "integer", "format": "int32" }, "costByPlatform": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true }, "costByOperationType": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true } }, "additionalProperties": false }, "CreateAlertRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "alertType": { "type": "string", "nullable": true }, "severity": { "type": "string", "nullable": true }, "conditions": { "type": "object", "additionalProperties": { }, "nullable": true }, "notificationChannels": { "type": "array", "items": { "type": "string" }, "nullable": true }, "brandProfileId": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "CreateApiKeyRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "scopes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "expiresAt": { "type": "string", "format": "date-time", "nullable": true }, "rpmLimit": { "type": "integer", "format": "int32" }, "dailyCreditCeiling": { "type": "integer", "format": "int32", "nullable": true }, "isAgent": { "type": "boolean" } }, "additionalProperties": false }, "CreateBrandProfileRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "keywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "monitoringFrequencyHours": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateCitationRequest": { "type": "object", "properties": { "tenantId": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "platformIcon": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "relevanceScore": { "type": "number", "format": "double" }, "engagementMetrics": { "$ref": "#/components/schemas/EngagementMetricsDto" }, "aiCitationMetrics": { "$ref": "#/components/schemas/AICitationMetricsDto" }, "tags": { "type": "array", "items": { "type": "string" }, "nullable": true }, "searchQueryId": { "type": "integer", "format": "int32", "nullable": true }, "visibilityResultId": { "type": "integer", "format": "int32", "nullable": true }, "linkConfidence": { "type": "string", "nullable": true }, "citationSourceType": { "type": "string", "nullable": true }, "aiOverviewDetected": { "type": "boolean" }, "aiOverviewState": { "type": "string", "nullable": true }, "inlineCitationCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateCompetitorRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "keywords": { "type": "string", "nullable": true }, "visibilityRank": { "type": "integer", "format": "int32", "nullable": true }, "imageUrl": { "type": "string", "nullable": true }, "detailedDescription": { "type": "string", "nullable": true }, "detailedDescriptionUrl": { "type": "string", "nullable": true }, "sameAsUrls": { "type": "string", "nullable": true }, "dataSource": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateCustomerPortalSessionRequest": { "type": "object", "properties": { "returnUrl": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateSearchQueryRequest": { "type": "object", "properties": { "brandProfileId": { "type": "integer", "format": "int32" }, "queryText": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "persona": { "type": "string", "nullable": true }, "geographicTarget": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true }, "region": { "type": "string", "nullable": true }, "language": { "type": "string", "nullable": true }, "executionFrequencyHours": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateSetupIntentRequest": { "type": "object", "properties": { "planType": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "businessName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateStripeCustomerRequest": { "type": "object", "properties": { "email": { "type": "string", "nullable": true }, "businessName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateStripeSubscriptionRequest": { "type": "object", "properties": { "stripeCustomerId": { "type": "string", "nullable": true }, "priceId": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateTrackerSubscriptionRequest": { "type": "object", "properties": { "trackerTenantId": { "type": "integer", "format": "int32" }, "stripeSubscriptionId": { "type": "string", "nullable": true }, "planType": { "type": "string", "nullable": true }, "monthlyPrice": { "type": "number", "format": "double" }, "creditsIncluded": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateTrackerTenantRequest": { "type": "object", "properties": { "userId": { "type": "integer", "format": "int32" }, "businessName": { "type": "string", "nullable": true }, "industry": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateWebhookSubscriptionRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true }, "events": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "CustomerPortalSessionResponse": { "type": "object", "properties": { "url": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DailyCostDto": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "cost": { "type": "number", "format": "double" }, "operationCount": { "type": "integer", "format": "int32" }, "totalTokens": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "DailyPulsePoint": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "mentionCount": { "type": "integer", "format": "int32" }, "visibilityScore": { "type": "integer", "format": "int32" }, "platformBreakdown": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true } }, "additionalProperties": false }, "DailyStatsDto": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "count": { "type": "integer", "format": "int32" }, "avgScore": { "type": "number", "format": "double" }, "dailyMentions": { "type": "integer", "format": "int32" }, "dailyCompetitorMentions": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "DashboardSignalDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "actionLabel": { "type": "string", "nullable": true }, "actionLink": { "type": "string", "nullable": true }, "timestamp": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "DashboardStatsDto": { "type": "object", "properties": { "brandCount": { "type": "integer", "format": "int32" }, "queryCount": { "type": "integer", "format": "int32" }, "resultCount": { "type": "integer", "format": "int32" }, "totalMentions": { "type": "integer", "format": "int32" }, "totalCompetitorMentions": { "type": "integer", "format": "int32" }, "competitorCount": { "type": "integer", "format": "int32" }, "averageVisibilityScore": { "type": "number", "format": "double" }, "successRate": { "type": "number", "format": "double" }, "recentResultsCount": { "type": "integer", "format": "int32" }, "credits": { "type": "integer", "format": "int32" }, "totalCitations": { "type": "integer", "format": "int32" }, "last7Days": { "type": "array", "items": { "$ref": "#/components/schemas/DailyStatsDto" }, "nullable": true }, "topCompetitors": { "type": "array", "items": { "$ref": "#/components/schemas/CompetitorMentionCountDto" }, "nullable": true }, "shareOfVoice": { "type": "array", "items": { "$ref": "#/components/schemas/ShareOfVoiceDto" }, "nullable": true } }, "additionalProperties": false }, "DateRangeCountDto": { "type": "object", "properties": { "date": { "type": "string", "nullable": true }, "count": { "type": "integer", "format": "int32" }, "positive": { "type": "integer", "format": "int32" }, "neutral": { "type": "integer", "format": "int32" }, "negative": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "DeductCreditsRequest": { "type": "object", "properties": { "credits": { "type": "integer", "format": "int32" }, "referenceType": { "type": "string", "nullable": true }, "referenceId": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DemoBrandDto": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "aeoScore": { "type": "number", "format": "double" }, "grade": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DemoDashboardResponse": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "demoBrands": { "type": "array", "items": { "$ref": "#/components/schemas/DemoBrandDto" }, "nullable": true }, "aeoScore": { "type": "number", "format": "double" }, "grade": { "type": "string", "nullable": true }, "totalMentions": { "type": "integer", "format": "int32" }, "totalCitations": { "type": "integer", "format": "int32" }, "totalPrompts": { "type": "integer", "format": "int32" }, "platforms": { "type": "array", "items": { "$ref": "#/components/schemas/DemoPlatformPerformanceDto" }, "nullable": true }, "shareOfVoice": { "type": "array", "items": { "$ref": "#/components/schemas/DemoShareOfVoiceDto" }, "nullable": true }, "recentCitations": { "type": "array", "items": { "$ref": "#/components/schemas/DemoRecentCitationDto" }, "nullable": true }, "updatedAtUtc": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "DemoPlatformPerformanceDto": { "type": "object", "properties": { "platform": { "type": "string", "nullable": true }, "mentions": { "type": "integer", "format": "int32" }, "avgVisibilityScore": { "type": "number", "format": "double" }, "status": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DemoRecentCitationDto": { "type": "object", "properties": { "platform": { "type": "string", "nullable": true }, "query": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "date": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DemoShareOfVoiceDto": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "percentage": { "type": "number", "format": "double" }, "mentionCount": { "type": "integer", "format": "int32" }, "visibilityScore": { "type": "number", "format": "double" }, "isTrackedBrand": { "type": "boolean" }, "trend": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DismissCompetitorRequest": { "type": "object", "properties": { "dismissFuturePattern": { "type": "boolean" }, "classification": { "type": "string", "nullable": true } }, "additionalProperties": false }, "DismissedCompetitorPatternDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "tenantId": { "type": "integer", "format": "int32" }, "pattern": { "type": "string", "nullable": true }, "patternType": { "type": "string", "nullable": true }, "dismissedAt": { "type": "string", "format": "date-time" }, "originalCompetitorId": { "type": "integer", "format": "int32", "nullable": true }, "originalCompetitorName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "EmailPasswordSignInRequest": { "type": "object", "properties": { "email": { "type": "string", "nullable": true }, "password": { "type": "string", "nullable": true } }, "additionalProperties": false }, "EmailSubscribeRequest": { "required": [ "email" ], "type": "object", "properties": { "email": { "minLength": 1, "type": "string", "format": "email" }, "captchaToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "EngagementMetricsDto": { "type": "object", "properties": { "likes": { "type": "integer", "format": "int32", "nullable": true }, "shares": { "type": "integer", "format": "int32", "nullable": true }, "comments": { "type": "integer", "format": "int32", "nullable": true }, "views": { "type": "integer", "format": "int32", "nullable": true }, "impressions": { "type": "integer", "format": "int32", "nullable": true }, "clicks": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "EntityMentionDto": { "type": "object", "properties": { "entityName": { "type": "string", "nullable": true }, "entityType": { "type": "string", "nullable": true }, "relevanceScore": { "type": "number", "format": "double" }, "context": { "type": "string", "nullable": true }, "relationship": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "positionIndex": { "type": "integer", "format": "int32" }, "mentionContextType": { "type": "string", "nullable": true }, "confidenceQualifier": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ExportCitationsRequest": { "type": "object", "properties": { "tenantId": { "type": "integer", "format": "int32" }, "format": { "type": "string", "nullable": true }, "filters": { "$ref": "#/components/schemas/GetCitationsRequest" } }, "additionalProperties": false }, "ExportCitationsResponse": { "type": "object", "properties": { "downloadUrl": { "type": "string", "nullable": true }, "fileName": { "type": "string", "nullable": true }, "fileSize": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "FreeAnalysisRequest": { "required": [ "email", "url" ], "type": "object", "properties": { "url": { "minLength": 1, "type": "string", "format": "uri" }, "email": { "minLength": 1, "type": "string", "format": "email" }, "useUserFriendlyReport": { "type": "boolean" }, "recaptchaToken": { "type": "string", "nullable": true }, "score": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "FreeAnalyzerRequest": { "required": [ "url" ], "type": "object", "properties": { "url": { "minLength": 1, "type": "string", "format": "uri" }, "recaptchaToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "GenerateBriefRequest": { "type": "object", "properties": { "contentFormat": { "type": "string", "nullable": true } }, "additionalProperties": false }, "GenerateOptimizationBriefRequest": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true } }, "additionalProperties": false }, "GetCitationsRequest": { "type": "object", "properties": { "tenantId": { "type": "integer", "format": "int32" }, "platform": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "startDate": { "type": "string", "format": "date-time", "nullable": true }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "searchQuery": { "type": "string", "nullable": true }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" }, "sortBy": { "type": "string", "nullable": true }, "sortOrder": { "type": "string", "nullable": true }, "hasBrandMention": { "type": "boolean" }, "citationSourceType": { "type": "string", "nullable": true } }, "additionalProperties": false }, "GetCitationsResponse": { "type": "object", "properties": { "citations": { "type": "array", "items": { "$ref": "#/components/schemas/CitationDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" }, "totalPages": { "type": "integer", "format": "int32" }, "stats": { "$ref": "#/components/schemas/CitationStatsDto" } }, "additionalProperties": false }, "GoogleSignInRequest": { "type": "object", "properties": { "googleId": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "picture": { "type": "string", "nullable": true }, "idToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "GroundingSource": { "type": "object", "properties": { "sourceType": { "type": "string", "nullable": true }, "content": { "type": "string", "nullable": true }, "originalFileName": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true } }, "additionalProperties": false }, "MiniAnalysisRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true } }, "additionalProperties": false }, "MonitoringEvent": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "tenantId": { "type": "integer", "format": "int32" }, "brandProfileId": { "type": "integer", "format": "int32" }, "timestamp": { "type": "string", "format": "date-time" }, "eventType": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "query": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true }, "confidence": { "type": "integer", "format": "int32" }, "context": { "type": "string", "nullable": true }, "sourceUrl": { "type": "string", "nullable": true }, "mentions": { "type": "array", "items": { "$ref": "#/components/schemas/BrandMention" }, "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "OptimizationBriefResponse": { "type": "object", "properties": { "gapAnalysis": { "type": "string", "nullable": true }, "recommendations": { "type": "array", "items": { "$ref": "#/components/schemas/OptimizationRecommendation" }, "nullable": true }, "competitorsFound": { "type": "array", "items": { "type": "string" }, "nullable": true }, "competitorUrls": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "priorityLevel": { "type": "string", "nullable": true }, "estimatedEffort": { "type": "string", "nullable": true }, "platformGaps": { "type": "array", "items": { "type": "string" }, "nullable": true }, "searchQueryId": { "type": "integer", "format": "int32" }, "competitorRecencyBands": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "competitorAveragePositions": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "nullable": true } }, "additionalProperties": false }, "OptimizationRecommendation": { "type": "object", "properties": { "title": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "category": { "type": "string", "nullable": true }, "priority": { "type": "string", "nullable": true }, "dataSource": { "type": "string", "nullable": true }, "evidenceJson": { "type": "string", "nullable": true }, "competitorComparisonJson": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PaymentMethodDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "brand": { "type": "string", "nullable": true }, "last4": { "type": "string", "nullable": true }, "expMonth": { "type": "integer", "format": "int32" }, "expYear": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "PaymentRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "useUserFriendlyReport": { "type": "boolean" }, "termsAgreed": { "type": "boolean" }, "successUrl": { "type": "string", "nullable": true }, "cancelUrl": { "type": "string", "nullable": true }, "deliveryMethod": { "type": "string", "nullable": true }, "isCreditPurchase": { "type": "boolean" }, "creditPackage": { "type": "integer", "format": "int32" }, "reportType": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PlatformPerformanceDto": { "type": "object", "properties": { "platform": { "type": "string", "nullable": true }, "totalExecutions": { "type": "integer", "format": "int32" }, "successfulExecutions": { "type": "integer", "format": "int32" }, "successRate": { "type": "number", "format": "double" }, "averageVisibilityScore": { "type": "number", "format": "double" }, "averageConfidenceScore": { "type": "number", "format": "double" }, "totalCreditsUsed": { "type": "integer", "format": "int32" }, "lastExecution": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "PlatformScoreDto": { "type": "object", "properties": { "platform": { "type": "string", "nullable": true }, "avgScore": { "type": "number", "format": "double" } }, "additionalProperties": false }, "PreviewQueriesResponse": { "type": "object", "properties": { "categories": { "type": "array", "items": { "$ref": "#/components/schemas/QueryCategoryGroup" }, "nullable": true }, "totalQueries": { "type": "integer", "format": "int32" }, "suggestedIndustryCategory": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ProviderBalanceDto": { "type": "object", "properties": { "provider": { "type": "string", "nullable": true }, "label": { "type": "string", "nullable": true }, "balance": { "type": "number", "format": "double", "nullable": true }, "currency": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "hasBalanceEndpoint": { "type": "boolean" }, "error": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PublicBriefRequest": { "type": "object", "properties": { "contentFormat": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PublicContentRequest": { "type": "object", "properties": { "persona": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PublicDetectRequest": { "type": "object", "properties": { "brandProfileId": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "PublicPublishRequest": { "type": "object", "properties": { "destinationId": { "type": "string", "nullable": true }, "mode": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PublicRunRequest": { "type": "object", "properties": { "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "PublishDestinationDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "type": { "type": "string", "nullable": true }, "endpointUrl": { "type": "string", "nullable": true }, "hasSecret": { "type": "boolean" }, "indexNowHost": { "type": "string", "nullable": true }, "hasIndexNowKey": { "type": "boolean" }, "isActive": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "typeLabel": { "type": "string", "nullable": true, "readOnly": true } }, "additionalProperties": false }, "PublishDestinationUpsertRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "type": { "type": "string", "nullable": true }, "endpointUrl": { "type": "string", "nullable": true }, "secret": { "type": "string", "nullable": true }, "indexNowHost": { "type": "string", "nullable": true }, "indexNowKey": { "type": "string", "nullable": true }, "isActive": { "type": "boolean" } }, "additionalProperties": false }, "PublishRequest": { "type": "object", "properties": { "destinationId": { "type": "string", "nullable": true }, "slug": { "type": "string", "nullable": true }, "contentType": { "type": "string", "nullable": true }, "author": { "type": "string", "nullable": true } }, "additionalProperties": false }, "QueryAttribution": { "type": "object", "properties": { "queryText": { "type": "string", "nullable": true }, "mentionCount": { "type": "integer", "format": "int32" }, "averagePosition": { "type": "number", "format": "double", "nullable": true }, "isGap": { "type": "boolean" }, "dataSource": { "type": "string", "nullable": true } }, "additionalProperties": false }, "QueryCategoryGroup": { "type": "object", "properties": { "category": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "queries": { "type": "array", "items": { "$ref": "#/components/schemas/SelectedQueryItem" }, "nullable": true } }, "additionalProperties": false }, "QueryExecutionLogDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "searchQueryId": { "type": "integer", "format": "int32" }, "queryName": { "type": "string", "nullable": true }, "queryText": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "message": { "type": "string", "nullable": true }, "platformsQueried": { "type": "string", "nullable": true }, "resultsCount": { "type": "integer", "format": "int32" }, "creditsUsed": { "type": "integer", "format": "int32" }, "durationMs": { "type": "integer", "format": "int64", "nullable": true }, "source": { "type": "string", "nullable": true }, "executedAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "executionBatchId": { "type": "string", "nullable": true } }, "additionalProperties": false }, "QueryPerformanceDto": { "type": "object", "properties": { "queryId": { "type": "integer", "format": "int32" }, "queryText": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true }, "totalExecutions": { "type": "integer", "format": "int32" }, "successfulExecutions": { "type": "integer", "format": "int32" }, "successRate": { "type": "number", "format": "double" }, "averageVisibilityScore": { "type": "number", "format": "double" }, "totalMentions": { "type": "integer", "format": "int32" }, "lastExecution": { "type": "string", "format": "date-time", "nullable": true }, "totalCitations": { "type": "integer", "format": "int32" }, "citationRate": { "type": "number", "format": "double" }, "last7DaysCitations": { "type": "integer", "format": "int32" }, "trendDirection": { "type": "string", "nullable": true } }, "additionalProperties": false }, "QuerySuggestionRequest": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "brandDescription": { "type": "string", "nullable": true }, "brandKeywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "userInput": { "type": "string", "nullable": true } }, "additionalProperties": false }, "RecentMentionDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "mentionCount": { "type": "integer", "format": "int32" }, "date": { "type": "string", "nullable": true } }, "additionalProperties": false }, "Recommendation": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "category": { "type": "string", "nullable": true }, "priority": { "type": "string", "nullable": true }, "estimatedImpact": { "type": "integer", "format": "int32" }, "estimatedEffort": { "type": "integer", "format": "int32" }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "tags": { "type": "array", "items": { "type": "string" }, "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "dueDate": { "type": "string", "format": "date-time", "nullable": true }, "isCompleted": { "type": "boolean" }, "completedAt": { "type": "string", "format": "date-time", "nullable": true }, "completedBy": { "type": "string", "nullable": true }, "notes": { "type": "string", "nullable": true }, "metadata": { "type": "object", "additionalProperties": { }, "nullable": true } }, "additionalProperties": false }, "RecommendationResponse": { "type": "object", "properties": { "recommendations": { "type": "array", "items": { "$ref": "#/components/schemas/Recommendation" }, "nullable": true }, "generatedAt": { "type": "string", "format": "date-time" }, "summary": { "type": "string", "nullable": true }, "categoryCounts": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "nullable": true } }, "additionalProperties": false }, "RefreshTokenRequest": { "type": "object", "properties": { "accessToken": { "type": "string", "nullable": true }, "refreshToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "ReportsStatusRequest": { "type": "object", "properties": { "reportIds": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "ReviewApprovalRequest": { "type": "object", "properties": { "approve": { "type": "boolean" }, "reason": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SearchQueryCompetitorsResponse": { "type": "object", "properties": { "competitors": { "type": "array", "items": { "$ref": "#/components/schemas/CompetitorInfo" }, "nullable": true }, "queryId": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "SearchQueryDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "userId": { "type": "integer", "format": "int32" }, "tenantId": { "type": "integer", "format": "int32", "nullable": true }, "brandProfileId": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "queryText": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "persona": { "type": "string", "nullable": true }, "geographicTarget": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true }, "region": { "type": "string", "nullable": true }, "language": { "type": "string", "nullable": true }, "isActive": { "type": "boolean" }, "executionFrequencyHours": { "type": "integer", "format": "int32" }, "lastExecutedAt": { "type": "string", "format": "date-time", "nullable": true }, "lastExecutionStatus": { "type": "string", "nullable": true }, "creditsPerExecution": { "type": "integer", "format": "int32" }, "totalExecutions": { "type": "integer", "format": "int32" }, "successfulExecutions": { "type": "integer", "format": "int32" }, "successRate": { "type": "number", "format": "double" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "nextScheduledExecution": { "type": "string", "format": "date-time", "nullable": true }, "visibilityResultCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "SelectedQueryItem": { "type": "object", "properties": { "queryText": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "SentimentTrendPoint": { "type": "object", "properties": { "period": { "type": "string", "format": "date-time" }, "positiveCount": { "type": "integer", "format": "int32" }, "neutralCount": { "type": "integer", "format": "int32" }, "negativeCount": { "type": "integer", "format": "int32" }, "totalCount": { "type": "integer", "format": "int32" }, "positivePercentage": { "type": "number", "format": "double" }, "negativePercentage": { "type": "number", "format": "double" } }, "additionalProperties": false }, "ShareOfVoiceDto": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "percentage": { "type": "number", "format": "double" }, "mentionCount": { "type": "integer", "format": "int32" }, "visibilityScore": { "type": "number", "format": "double" }, "trend": { "type": "string", "nullable": true }, "isTrackedBrand": { "type": "boolean" } }, "additionalProperties": false }, "SignInWithTokenRequest": { "type": "object", "properties": { "accessToken": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SignUpRequest": { "type": "object", "properties": { "firstName": { "type": "string", "nullable": true }, "lastName": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "password": { "type": "string", "nullable": true }, "businessName": { "type": "string", "nullable": true }, "businessEmail": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "targetKeywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "planName": { "type": "string", "nullable": true }, "stripePaymentIntentId": { "type": "string", "nullable": true }, "isTrial": { "type": "boolean" }, "stripeSetupIntentId": { "type": "string", "nullable": true }, "signupVariant": { "type": "string", "nullable": true }, "heroBrandName": { "type": "string", "nullable": true }, "heroWebsiteUrl": { "type": "string", "nullable": true }, "heroBrandScore": { "type": "integer", "format": "int32", "nullable": true }, "heroGrade": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SignUpResponse": { "type": "object", "properties": { "tenant": { "nullable": true }, "subscription": { "nullable": true }, "brandProfile": { "nullable": true }, "apiKey": { "type": "string", "nullable": true }, "message": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SiteContentCitationMonitorResult": { "type": "object", "properties": { "contentChecked": { "type": "integer", "format": "int32" }, "contentNewlyCited": { "type": "integer", "format": "int32" }, "opportunitiesNewlyCited": { "type": "integer", "format": "int32" }, "citationsMatched": { "type": "integer", "format": "int32" }, "isEmpty": { "type": "boolean", "readOnly": true } }, "additionalProperties": false }, "SiteContentDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "contentType": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "slug": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "content": { "type": "string", "nullable": true }, "category": { "type": "string", "nullable": true }, "clusterType": { "type": "string", "nullable": true }, "seoScore": { "type": "integer", "format": "int32" }, "author": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "publishDate": { "type": "string", "format": "date-time", "nullable": true }, "updatedDate": { "type": "string", "format": "date-time", "nullable": true }, "schemaMarkup": { "type": "string", "nullable": true }, "metadata": { "type": "object", "additionalProperties": { "nullable": true }, "nullable": true }, "clusters": { "type": "array", "items": { }, "nullable": true }, "clusterCount": { "type": "integer", "format": "int32" }, "isActive": { "type": "boolean" }, "url": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "SiteContentListResponse": { "type": "object", "properties": { "pillars": { "type": "array", "items": { "$ref": "#/components/schemas/SiteContentDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" }, "totalPages": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "SiteContentUpsertRequest": { "type": "object", "properties": { "contentType": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "slug": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "content": { "type": "string", "nullable": true }, "category": { "type": "string", "nullable": true }, "clusterType": { "type": "string", "nullable": true }, "seoScore": { "type": "integer", "format": "int32" }, "author": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "publishDate": { "type": "string", "format": "date-time", "nullable": true }, "updatedDate": { "type": "string", "format": "date-time", "nullable": true }, "schemaMarkup": { "type": "string", "nullable": true }, "metadata": { "type": "object", "additionalProperties": { "nullable": true }, "nullable": true }, "isActive": { "type": "boolean" }, "monitorUrl": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SnoozeRecommendationRequest": { "type": "object", "properties": { "until": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "SubscriptionPaymentIntentResponse": { "type": "object", "properties": { "clientSecret": { "type": "string", "nullable": true }, "paymentIntentId": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currency": { "type": "string", "nullable": true }, "planType": { "type": "string", "nullable": true }, "stripeCustomerId": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "SubscriptionPaymentRequest": { "type": "object", "properties": { "email": { "type": "string", "nullable": true }, "businessName": { "type": "string", "nullable": true }, "businessEmail": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "targetKeywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "planType": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currency": { "type": "string", "nullable": true }, "termsAgreed": { "type": "boolean" }, "password": { "type": "string", "nullable": true }, "billingName": { "type": "string", "nullable": true }, "billingAddressLine1": { "type": "string", "nullable": true }, "billingAddressLine2": { "type": "string", "nullable": true }, "billingCity": { "type": "string", "nullable": true }, "billingState": { "type": "string", "nullable": true }, "billingPostalCode": { "type": "string", "nullable": true }, "billingCountry": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SuggestedQuery": { "type": "object", "properties": { "queryText": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "category": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SystemHealthDto": { "type": "object", "properties": { "totalTenants": { "type": "integer", "format": "int32" }, "activeTenants": { "type": "integer", "format": "int32" }, "totalQueries": { "type": "integer", "format": "int32" }, "activeQueries": { "type": "integer", "format": "int32" }, "inactiveQueries": { "type": "integer", "format": "int32" }, "totalExecutions": { "type": "integer", "format": "int32" }, "successfulExecutions": { "type": "integer", "format": "int32" }, "failedExecutions": { "type": "integer", "format": "int32" }, "successRate": { "type": "number", "format": "double" }, "lastExecutionAt": { "type": "string", "format": "date-time", "nullable": true }, "lastExecutionStatus": { "type": "string", "nullable": true }, "totalCitations": { "type": "integer", "format": "int32" }, "citationTenants": { "type": "integer", "format": "int32" }, "totalCompetitors": { "type": "integer", "format": "int32" }, "competitorTenants": { "type": "integer", "format": "int32" }, "contentOpportunities": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "TenantApiKeyCreatedResponse": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "name": { "type": "string", "nullable": true }, "keyPrefix": { "type": "string", "nullable": true }, "apiKey": { "type": "string", "nullable": true }, "scopes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "TenantApiKeyDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "name": { "type": "string", "nullable": true }, "keyPrefix": { "type": "string", "nullable": true }, "scopes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "isActive": { "type": "boolean" }, "isAgent": { "type": "boolean" }, "expiresAt": { "type": "string", "format": "date-time", "nullable": true }, "lastUsedAt": { "type": "string", "format": "date-time", "nullable": true }, "rpmLimit": { "type": "integer", "format": "int32" }, "dailyCreditCeiling": { "type": "integer", "format": "int32", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "revokedAt": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "TenantCostDto": { "type": "object", "properties": { "tenantId": { "type": "integer", "format": "int32" }, "businessName": { "type": "string", "nullable": true }, "totalCost": { "type": "number", "format": "double" }, "operationCount": { "type": "integer", "format": "int32" }, "totalTokens": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "TrackerCreditTransactionDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "tenantId": { "type": "integer", "format": "int32" }, "type": { "type": "string", "nullable": true }, "amount": { "type": "integer", "format": "int32" }, "description": { "type": "string", "nullable": true }, "balanceAfter": { "type": "integer", "format": "int32" }, "referenceId": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "processedAt": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "TrackerSubscriptionDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "trackerTenantId": { "type": "integer", "format": "int32" }, "stripeSubscriptionId": { "type": "string", "nullable": true }, "planType": { "type": "string", "nullable": true }, "monthlyPrice": { "type": "number", "format": "double" }, "creditsIncluded": { "type": "integer", "format": "int32" }, "status": { "type": "string", "nullable": true }, "currentPeriodStart": { "type": "string", "format": "date-time" }, "currentPeriodEnd": { "type": "string", "format": "date-time" }, "canceledAt": { "type": "string", "format": "date-time", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "TrackerSubscriptionSummaryDto": { "type": "object", "properties": { "planType": { "type": "string", "nullable": true }, "monthlyPrice": { "type": "number", "format": "double" }, "creditsIncluded": { "type": "integer", "format": "int32" }, "status": { "type": "string", "nullable": true }, "currentPeriodEnd": { "type": "string", "format": "date-time" }, "daysRemaining": { "type": "integer", "format": "int32" }, "isActive": { "type": "boolean", "readOnly": true } }, "additionalProperties": false }, "TrackerTenantApiKeyResponse": { "type": "object", "properties": { "apiKey": { "type": "string", "nullable": true }, "generatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "TrackerTenantDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "userId": { "type": "integer", "format": "int32" }, "businessName": { "type": "string", "nullable": true }, "industry": { "type": "string", "nullable": true }, "apiKey": { "type": "string", "nullable": true }, "stripeCustomerId": { "type": "string", "nullable": true }, "creditsBalance": { "type": "integer", "format": "int32" }, "isActive": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time", "nullable": true }, "userEmail": { "type": "string", "nullable": true }, "onboardingCompleted": { "type": "boolean" }, "autonomyMode": { "type": "string", "nullable": true }, "notificationEmail": { "type": "string", "nullable": true }, "activeSubscription": { "$ref": "#/components/schemas/TrackerSubscriptionDto" } }, "additionalProperties": false }, "TrialSetupIntentResponse": { "type": "object", "properties": { "clientSecret": { "type": "string", "nullable": true }, "setupIntentId": { "type": "string", "nullable": true }, "stripeCustomerId": { "type": "string", "nullable": true }, "planType": { "type": "string", "nullable": true }, "isMock": { "type": "boolean" } }, "additionalProperties": false }, "UnifiedAnalysisRequest": { "required": [ "url" ], "type": "object", "properties": { "url": { "minLength": 1, "type": "string", "format": "uri" }, "useUserFriendlyReport": { "type": "boolean" }, "reportType": { "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateAlertRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "alertType": { "type": "string", "nullable": true }, "severity": { "type": "string", "nullable": true }, "isEnabled": { "type": "boolean", "nullable": true }, "conditions": { "type": "object", "additionalProperties": { }, "nullable": true }, "notificationChannels": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "UpdateApiKeyRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "scopes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "isActive": { "type": "boolean", "nullable": true }, "expiresAt": { "type": "string", "format": "date-time", "nullable": true }, "rpmLimit": { "type": "integer", "format": "int32", "nullable": true }, "dailyCreditCeiling": { "type": "integer", "format": "int32", "nullable": true }, "isAgent": { "type": "boolean", "nullable": true } }, "additionalProperties": false }, "UpdateAutonomyModeRequest": { "type": "object", "properties": { "mode": { "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateBrandProfileRequest": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "websiteUrl": { "type": "string", "nullable": true }, "brandVariations": { "type": "array", "items": { "type": "string" }, "nullable": true }, "keywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "isActive": { "type": "boolean", "nullable": true }, "monitoringFrequencyHours": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "UpdateCitationRequest": { "type": "object", "properties": { "brandName": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "platformIcon": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "sentiment": { "type": "string", "nullable": true }, "date": { "type": "string", "format": "date-time", "nullable": true }, "relevanceScore": { "type": "number", "format": "double", "nullable": true }, "engagementMetrics": { "$ref": "#/components/schemas/EngagementMetricsDto" }, "aiCitationMetrics": { "$ref": "#/components/schemas/AICitationMetricsDto" }, "tags": { "type": "array", "items": { "type": "string" }, "nullable": true }, "searchQueryId": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "UpdateContentBriefRequest": { "type": "object", "properties": { "suggestedTitle": { "type": "string", "nullable": true }, "contentFormat": { "type": "string", "nullable": true }, "targetIntent": { "type": "string", "nullable": true }, "recommendedWordCount": { "type": "integer", "format": "int32", "nullable": true }, "targetEntities": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedHeadings": { "type": "array", "items": { "type": "string" }, "nullable": true }, "suggestedSchemaTypes": { "type": "array", "items": { "type": "string" }, "nullable": true }, "authoritySignalsNeeded": { "type": "string", "nullable": true }, "groundingSources": { "type": "array", "items": { "$ref": "#/components/schemas/GroundingSource" }, "nullable": true }, "generatedContent": { "type": "string", "nullable": true }, "generatedSchemaMarkup": { "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateContentOpportunityRequest": { "type": "object", "properties": { "status": { "type": "string", "nullable": true }, "contentPublishedUrl": { "type": "string", "nullable": true }, "citationScore": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "UpdateSearchQueryRequest": { "type": "object", "properties": { "queryText": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "platforms": { "type": "array", "items": { "type": "string" }, "nullable": true }, "persona": { "type": "string", "nullable": true }, "geographicTarget": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true }, "region": { "type": "string", "nullable": true }, "language": { "type": "string", "nullable": true }, "isActive": { "type": "boolean", "nullable": true }, "executionFrequencyHours": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "UpdateTrackerSubscriptionRequest": { "type": "object", "properties": { "status": { "type": "string", "nullable": true }, "currentPeriodEnd": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "UpdateTrackerTenantRequest": { "type": "object", "properties": { "businessName": { "type": "string", "nullable": true }, "industry": { "type": "string", "nullable": true }, "isActive": { "type": "boolean" } }, "additionalProperties": false }, "UpdateWebhookSubscriptionRequest": { "type": "object", "properties": { "url": { "type": "string", "nullable": true }, "events": { "type": "array", "items": { "type": "string" }, "nullable": true }, "isActive": { "type": "boolean", "nullable": true } }, "additionalProperties": false }, "VisibilityPulseResponse": { "type": "object", "properties": { "timeline": { "type": "array", "items": { "$ref": "#/components/schemas/DailyPulsePoint" }, "nullable": true }, "currentStatus": { "type": "string", "nullable": true }, "trendPercentage": { "type": "number", "format": "double" }, "lastUpdated": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "VisibilityResultDto": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "userId": { "type": "integer", "format": "int32" }, "brandProfileId": { "type": "integer", "format": "int32" }, "brandName": { "type": "string", "nullable": true }, "searchQueryId": { "type": "integer", "format": "int32" }, "queryText": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "platformVersion": { "type": "string", "nullable": true }, "visibilityScore": { "type": "integer", "format": "int32" }, "confidenceScore": { "type": "number", "format": "double" }, "totalMentions": { "type": "integer", "format": "int32" }, "exactMatches": { "type": "integer", "format": "int32" }, "semanticMatches": { "type": "integer", "format": "int32" }, "mentionType": { "type": "string", "nullable": true }, "brandMentions": { "type": "array", "items": { "$ref": "#/components/schemas/BrandMentionDto" }, "nullable": true }, "processedResponse": { "type": "string", "nullable": true }, "responseLength": { "type": "integer", "format": "int32" }, "executedAt": { "type": "string", "format": "date-time" }, "executionDurationMs": { "type": "integer", "format": "int32" }, "executionStatus": { "type": "string", "nullable": true }, "errorMessage": { "type": "string", "nullable": true }, "creditsUsed": { "type": "integer", "format": "int32" }, "modelUsed": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "aiOverviewDetected": { "type": "boolean" }, "aiOverviewState": { "type": "string", "nullable": true }, "inlineCitationCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "VisibilityTrendPointDto": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "platform": { "type": "string", "nullable": true }, "avgVisibilityScore": { "type": "number", "format": "double" }, "queryCount": { "type": "integer", "format": "int32" }, "brandFoundCount": { "type": "integer", "format": "int32" }, "visibilityRate": { "type": "number", "format": "double" } }, "additionalProperties": false }, "WebMentionItem": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "platform": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "snippet": { "type": "string", "nullable": true }, "source": { "type": "string", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "searchQueryText": { "type": "string", "nullable": true }, "relevanceScore": { "type": "number", "format": "double" }, "sentiment": { "type": "string", "nullable": true } }, "additionalProperties": false }, "WebsiteIntelligenceResponse": { "type": "object", "properties": { "websiteUrl": { "type": "string", "nullable": true }, "brandName": { "type": "string", "nullable": true }, "services": { "type": "array", "items": { "type": "string" }, "nullable": true, "deprecated": true }, "keywords": { "type": "array", "items": { "type": "string" }, "nullable": true }, "location": { "type": "string", "nullable": true, "deprecated": true }, "intelligenceLog": { "type": "array", "items": { "type": "string" }, "nullable": true }, "signalStrength": { "type": "integer", "format": "int32", "deprecated": true }, "analysisTimestamp": { "type": "string", "format": "date-time" }, "status": { "type": "string", "nullable": true }, "errorMessage": { "type": "string", "nullable": true } }, "additionalProperties": false } } } }