--- updatedAt: 2025-09-04T22:34:25.000Z agentTools: projectIndex: https://docs.writesonic.com/llms.txt --- # Content Citations # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Geo Presence API V2 - Citations & Keywords Exports", "version": "2.0.0", "description": "JSON performance export endpoints for Geo Presence. CSV/XML support coming soon.\n\nExports:\n- Content Citations\n- Content Keywords" }, "servers": [ { "url": "https://api.writesonic.com", "description": "Production server" } ], "security": [ { "APIKeyHeader": [] } ], "tags": [ { "name": "Geo Presence Export", "description": "Content export endpoints for Geo Presence data" } ], "paths": { "/v2/geo/presence/business/export/content/citations": { "get": { "tags": [ "Geo Presence Export" ], "summary": "Content Citations", "operationId": "content_citations_v2_geo_presence_business_export_content_citations_get", "parameters": [ { "$ref": "#/components/parameters/FormatParam" }, { "$ref": "#/components/parameters/DateParam" }, { "$ref": "#/components/parameters/CompareDateParam" }, { "$ref": "#/components/parameters/TopicIdParam" }, { "$ref": "#/components/parameters/PlatformIdParam" }, { "$ref": "#/components/parameters/PromptIdParam" }, { "$ref": "#/components/parameters/CitationIdParam" }, { "$ref": "#/components/parameters/UrlParam" }, { "$ref": "#/components/parameters/ProjectIdParam" }, { "$ref": "#/components/parameters/PageParam" }, { "$ref": "#/components/parameters/SizeParam" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CitationExportItem" } }, "page": { "type": "integer" }, "size": { "type": "integer" }, "total": { "type": "integer" }, "count": { "type": "integer" }, "total_pages": { "type": "integer" } }, "required": [ "items", "page", "size", "total", "count", "total_pages" ] }, "example": { "items": [ { "citation_id": "c0f3b1a4-0a21-4e1c-8e6e-0d2a9f62a111", "citation_title": "Top Tools 2024", "citation_uri": "https://techcrunch.com/tools", "citation_domain": "techcrunch.com", "created_at": "2024-01-15T10:30:00Z", "mentioned_websites_json": [ { "id": "18e08d93-8497-46aa-ab61-8629dadb7aee", "name": "AWS Compute Blog", "is_competitor": false, "is_self_website": true }, { "id": "64873786-88e9-4de0-9087-3b95c092557c", "name": "Hungry Minds", "is_competitor": true, "is_self_website": false } ], "responses_json": [ { "prompt_id": "e25f42c5-e34a-4c4c-9b93-28509d42aba8", "prompt_text": "aws lambda pricing calculator services", "model_id": "f4d0ad80-6eb1-4b7c-a5a3-2671e51b7eec", "model_name": "gpt-4", "result_id": "6c3b9df8-6f9f-4e3a-9b46-1f9c0f0c1aaa", "created_at": "2024-01-15T10:30:00Z", "topic_id": "252c2e85-9778-4e23-8efa-8dcaffc5def5", "topic_name": "AWS Lambda Development" } ], "mentioned_websites_json_compare": [], "responses_json_compare": [] } ], "page": 1, "size": 50, "total": 250, "count": 50, "total_pages": 5 } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "APIKeyHeader": [] } ] } } }, "components": { "parameters": { "FormatParam": { "name": "format", "in": "query", "required": false, "description": "Response format. Only json is supported currently. CSV/XML support coming soon.", "schema": { "type": "string", "enum": [ "json" ], "default": "json" } }, "DateParam": { "name": "date", "in": "query", "required": true, "description": "Date to export (UTC)", "schema": { "type": "string", "format": "date" } }, "CompareDateParam": { "name": "compare_date", "in": "query", "required": false, "description": "Optional comparison date (UTC) for deltas", "schema": { "type": "string", "format": "date" } }, "TopicIdParam": { "name": "topic_id", "in": "query", "required": false, "description": "Filter by Topic ID", "schema": { "type": "string", "format": "uuid" } }, "PlatformIdParam": { "name": "platform_id", "in": "query", "required": false, "description": "Filter by Platform/Model ID", "schema": { "type": "string", "format": "uuid" } }, "PromptIdParam": { "name": "prompt_id", "in": "query", "required": false, "description": "Filter by Prompt ID", "schema": { "type": "string", "format": "uuid" } }, "CitationIdParam": { "name": "citation_id", "in": "query", "required": false, "description": "Filter by Citation ID", "schema": { "type": "string", "format": "uuid" } }, "UrlParam": { "name": "url", "in": "query", "required": true, "description": "The URL of the site to query", "schema": { "type": "string", "example": "https://example.com" } }, "ProjectIdParam": { "name": "project_id", "in": "query", "required": false, "description": "Optional Project ID to filter the site", "schema": { "type": "string", "example": "bb2baeaa-a48c-482b-af00-67df964b5d2b" } }, "PageParam": { "name": "page", "in": "query", "required": false, "description": "Page number for pagination", "schema": { "type": "integer", "minimum": 1, "default": 1 } }, "SizeParam": { "name": "size", "in": "query", "required": false, "description": "Number of items per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } }, "schemas": { "CitationResponseItem": { "type": "object", "properties": { "prompt_id": { "type": "string", "format": "uuid" }, "prompt_text": { "type": "string" }, "model_id": { "type": "string", "format": "uuid" }, "model_name": { "type": "string" }, "result_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "topic_id": { "type": "string", "format": "uuid" }, "topic_name": { "type": "string" } }, "required": [ "prompt_id", "prompt_text", "model_id", "model_name", "result_id", "created_at" ] }, "MentionedWebsite": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_competitor": { "type": "boolean" }, "is_self_website": { "type": "boolean" } }, "required": [ "id", "name" ] }, "CitationExportItem": { "type": "object", "properties": { "citation_id": { "type": "string", "format": "uuid" }, "citation_title": { "type": "string" }, "citation_uri": { "type": "string" }, "citation_domain": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "mentioned_websites_json": { "type": "array", "items": { "$ref": "#/components/schemas/MentionedWebsite" } }, "responses_json": { "type": "array", "items": { "$ref": "#/components/schemas/CitationResponseItem" } }, "mentioned_websites_json_compare": { "type": "array", "items": { "$ref": "#/components/schemas/MentionedWebsite" } }, "responses_json_compare": { "type": "array", "items": { "$ref": "#/components/schemas/CitationResponseItem" } } }, "required": [ "citation_id", "citation_uri", "citation_domain", "created_at" ] }, "HTTPValidationError": { "type": "object", "properties": { "detail": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationError" } } } }, "ValidationError": { "type": "object", "properties": { "loc": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "msg": { "type": "string" }, "type": { "type": "string" } } } }, "securitySchemes": { "APIKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "API key for authentication" } } } } ```