{ "openapi": "3.0.0", "info": { "title": "Social Media Meta Tag Generator", "description": "Advanced social media meta tag generator that creates optimized Open Graph, Twitter Cards, and Schema.org tags for multiple platforms. Features AI-powered content optimization using GPT-4, intelligent platform-specific formatting, image validation, and comprehensive SEO optimization for Facebook, Twitter, LinkedIn, and WhatsApp.\n\n{\n \"description\": \"Advanced social media meta tag generator that creates optimized Open Graph, Twitter Cards, and Schema.org tags for multiple platforms. Features AI-powered content optimization using GPT-4, intelligent platform-specific formatting, image validation, and comprehensive SEO optimization for Facebook, Twitter, LinkedIn, and WhatsApp.\",\n \"features\": [\n \"🤖 AI-powered content optimization using GPT-4-turbo-preview\",\n \"📱 Multi-platform support (Facebook, Twitter, LinkedIn, WhatsApp)\",\n \"🏷️ Open Graph meta tags generation with platform-specific optimization\",\n \"🐦 Twitter Cards support with all card types (summary, large image, app, player)\",\n \"📊 Schema.org structured data for enhanced SEO and rich snippets\",\n \"🖼️ Image validation and optimization recommendations\",\n \"✅ Content length optimization per platform limits\",\n \"🎯 Content type-specific tag generation (website, article, product, video, event)\",\n \"🔧 Custom meta tags support for advanced use cases\",\n \"🔒 Enterprise-grade authentication and security validation\"\n ],\n \"codeExamples\": {\n \"curl\": \"curl -X POST \\\"https://api.example.com/api/web/social-media-meta-tag-generator/v1\\\" \\\\\\n -H \\\"Content-Type: application/json\\\" \\\\\\n -H \\\"Authorization: Bearer YOUR_API_KEY\\\" \\\\\\n -d '{\\n \\\"title\\\": \\\"Best Practices for Social Media Marketing in 2025\\\",\\n \\\"description\\\": \\\"Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques.\\\",\\n \\\"url\\\": \\\"https://example.com/blog/social-media-marketing-2025\\\",\\n \\\"image\\\": \\\"https://example.com/images/social-media-guide.jpg\\\",\\n \\\"contentType\\\": \\\"article\\\",\\n \\\"platforms\\\": [\\\"facebook\\\", \\\"twitter\\\", \\\"linkedin\\\"],\\n \\\"siteName\\\": \\\"Digital Marketing Hub\\\",\\n \\\"author\\\": \\\"Sarah Johnson\\\",\\n \\\"publishedTime\\\": \\\"2025-01-15T10:00:00Z\\\",\\n \\\"twitterCard\\\": \\\"summary_large_image\\\",\\n \\\"twitterSite\\\": \\\"@digitalmarketinghub\\\",\\n \\\"generateSchema\\\": true,\\n \\\"aiOptimization\\\": true,\\n \\\"aiPrompt\\\": \\\"Optimize for maximum engagement while maintaining professional tone\\\"\\n }'\",\n \"javascript\": \"const response = await fetch('/api/web/social-media-meta-tag-generator/v1', {\\n method: 'POST',\\n headers: {\\n 'Content-Type': 'application/json',\\n 'Authorization': 'Bearer YOUR_API_KEY'\\n },\\n body: JSON.stringify({\\n title: 'Best Practices for Social Media Marketing in 2025',\\n description: 'Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques.',\\n url: 'https://example.com/blog/social-media-marketing-2025',\\n image: 'https://example.com/images/social-media-guide.jpg',\\n contentType: 'article',\\n platforms: ['facebook', 'twitter', 'linkedin'],\\n siteName: 'Digital Marketing Hub',\\n author: 'Sarah Johnson',\\n publishedTime: '2025-01-15T10:00:00Z',\\n twitterCard: 'summary_large_image',\\n twitterSite: '@digitalmarketinghub',\\n generateSchema: true,\\n aiOptimization: true,\\n aiPrompt: 'Optimize for maximum engagement while maintaining professional tone'\\n })\\n});\\n\\nconst result = await response.json();\\nif (result.success) {\\n console.log('Meta tags generated:', result.data.htmlTags.length);\\n console.log('AI Enhanced:', result.data.aiEnhancement?.enhanced);\\n console.log('Platforms processed:', result.data.platforms);\\n \\n // Access platform-specific tags\\n const facebookTags = result.data.platforms.facebook?.tags;\\n const twitterTags = result.data.platforms.twitter?.tags;\\n \\n // Get Schema.org structured data\\n const schemaData = result.data.schemaOrg;\\n}\",\n \"python\": \"import requests\\nimport json\\n\\nurl = \\\"https://api.example.com/api/web/social-media-meta-tag-generator/v1\\\"\\nheaders = {\\n \\\"Content-Type\\\": \\\"application/json\\\",\\n \\\"Authorization\\\": \\\"Bearer YOUR_API_KEY\\\"\\n}\\n\\npayload = {\\n \\\"title\\\": \\\"Best Practices for Social Media Marketing in 2025\\\",\\n \\\"description\\\": \\\"Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques.\\\",\\n \\\"url\\\": \\\"https://example.com/blog/social-media-marketing-2025\\\",\\n \\\"image\\\": \\\"https://example.com/images/social-media-guide.jpg\\\",\\n \\\"contentType\\\": \\\"article\\\",\\n \\\"platforms\\\": [\\\"facebook\\\", \\\"twitter\\\", \\\"linkedin\\\"],\\n \\\"siteName\\\": \\\"Digital Marketing Hub\\\",\\n \\\"author\\\": \\\"Sarah Johnson\\\",\\n \\\"publishedTime\\\": \\\"2025-01-15T10:00:00Z\\\",\\n \\\"twitterCard\\\": \\\"summary_large_image\\\",\\n \\\"twitterSite\\\": \\\"@digitalmarketinghub\\\",\\n \\\"generateSchema\\\": True,\\n \\\"aiOptimization\\\": True,\\n \\\"aiPrompt\\\": \\\"Optimize for maximum engagement while maintaining professional tone\\\"\\n}\\n\\nresponse = requests.post(url, json=payload, headers=headers)\\ndata = response.json()\\n\\nif data[\\\"success\\\"]:\\n meta_tags = data[\\\"data\\\"]\\n print(f\\\"Meta tags generated: {data['metadata']['tagsGenerated']}\\\")\\n print(f\\\"AI Enhanced: {meta_tags.get('aiEnhancement', {}).get('enhanced', False)}\\\")\\n print(f\\\"Platforms processed: {meta_tags['metadata']['platforms']}\\\")\\n \\n # Access platform-specific tags\\n facebook_tags = meta_tags[\\\"platforms\\\"].get(\\\"facebook\\\", {}).get(\\\"tags\\\", [])\\n twitter_tags = meta_tags[\\\"platforms\\\"].get(\\\"twitter\\\", {}).get(\\\"tags\\\", [])\\n \\n # Print Open Graph tags for Facebook\\n for tag in facebook_tags:\\n if \\\"property\\\" in tag:\\n print(f'')\\n \\n # Print Schema.org data\\n if meta_tags.get(\\\"schemaOrg\\\"):\\n print(f'')\",\n \"nodejs\": \"const axios = require('axios');\\n\\nasync function generateSocialMetaTags(contentData, options = {}) {\\n try {\\n const response = await axios.post('https://api.example.com/api/web/social-media-meta-tag-generator/v1', {\\n title: contentData.title,\\n description: contentData.description,\\n url: contentData.url,\\n image: contentData.image,\\n contentType: options.contentType || 'website',\\n platforms: options.platforms || ['facebook', 'twitter'],\\n siteName: options.siteName,\\n author: options.author,\\n publishedTime: options.publishedTime,\\n twitterCard: options.twitterCard || 'summary_large_image',\\n twitterSite: options.twitterSite,\\n generateSchema: options.generateSchema !== false,\\n aiOptimization: options.aiOptimization || false,\\n aiPrompt: options.aiPrompt\\n }, {\\n headers: {\\n 'Content-Type': 'application/json',\\n 'Authorization': 'Bearer YOUR_API_KEY'\\n }\\n });\\n\\n const { data } = response.data;\\n \\n console.log('✅ Meta Tags Generation Complete:');\\n console.log('- Total Tags Generated:', response.data.metadata.tagsGenerated);\\n console.log('- Platforms Processed:', data.metadata.platforms.join(', '));\\n console.log('- AI Enhanced:', data.aiEnhancement?.enhanced || false);\\n console.log('- Schema.org Generated:', !!data.schemaOrg);\\n \\n // Generate HTML meta tags\\n const htmlMetaTags = [];\\n Object.values(data.platforms).forEach(platform => {\\n platform.tags.forEach(tag => {\\n if (tag.property) {\\n htmlMetaTags.push(``);\\n } else if (tag.name) {\\n htmlMetaTags.push(``);\\n }\\n });\\n });\\n \\n // Add Schema.org script tag\\n if (data.schemaOrg) {\\n htmlMetaTags.push(``);\\n }\\n \\n return {\\n htmlTags: htmlMetaTags,\\n platformData: data.platforms,\\n schemaData: data.schemaOrg,\\n metadata: data.metadata\\n };\\n \\n } catch (error) {\\n console.error('Error generating meta tags:', error.response?.data || error.message);\\n throw error;\\n }\\n}\\n\\n// Usage examples\\ngenerateSocialMetaTags({\\n title: 'Amazing Product Launch 2025',\\n description: 'Revolutionary new product that will change the industry',\\n url: 'https://company.com/product-launch',\\n image: 'https://company.com/images/product.jpg'\\n}, {\\n contentType: 'product',\\n platforms: ['facebook', 'twitter', 'linkedin'],\\n siteName: 'Company Inc',\\n aiOptimization: true\\n});\",\n \"php\": \" \\\"Best Practices for Social Media Marketing in 2025\\\",\\n \\\"description\\\" => \\\"Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques.\\\",\\n \\\"url\\\" => \\\"https://example.com/blog/social-media-marketing-2025\\\",\\n \\\"image\\\" => \\\"https://example.com/images/social-media-guide.jpg\\\",\\n \\\"contentType\\\" => \\\"article\\\",\\n \\\"platforms\\\" => [\\\"facebook\\\", \\\"twitter\\\", \\\"linkedin\\\"],\\n \\\"siteName\\\" => \\\"Digital Marketing Hub\\\",\\n \\\"author\\\" => \\\"Sarah Johnson\\\",\\n \\\"publishedTime\\\" => \\\"2025-01-15T10:00:00Z\\\",\\n \\\"twitterCard\\\" => \\\"summary_large_image\\\",\\n \\\"twitterSite\\\" => \\\"@digitalmarketinghub\\\",\\n \\\"generateSchema\\\" => true,\\n \\\"aiOptimization\\\" => true,\\n \\\"aiPrompt\\\" => \\\"Optimize for maximum engagement while maintaining professional tone\\\"\\n]);\\n\\n$ch = curl_init();\\ncurl_setopt($ch, CURLOPT_URL, $url);\\ncurl_setopt($ch, CURLOPT_POST, true);\\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $payload);\\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\\n\\n$response = curl_exec($ch);\\ncurl_close($ch);\\n\\n$data = json_decode($response, true);\\nif ($data['success']) {\\n $metaTags = $data['data'];\\n echo \\\"Meta tags generated: \\\" . $data['metadata']['tagsGenerated'] . \\\"\\\\n\\\";\\n echo \\\"AI Enhanced: \\\" . ($metaTags['aiEnhancement']['enhanced'] ?? false ? 'Yes' : 'No') . \\\"\\\\n\\\";\\n echo \\\"Platforms processed: \\\" . implode(', ', $metaTags['metadata']['platforms']) . \\\"\\\\n\\\";\\n \\n // Generate HTML meta tags\\n foreach ($metaTags['platforms'] as $platform => $platformData) {\\n echo \\\"\\\\n--- $platform Tags ---\\\\n\\\";\\n foreach ($platformData['tags'] as $tag) {\\n if (isset($tag['property'])) {\\n echo '' . \\\"\\\\n\\\";\\n } elseif (isset($tag['name'])) {\\n echo '' . \\\"\\\\n\\\";\\n }\\n }\\n }\\n \\n // Output Schema.org structured data\\n if (isset($metaTags['schemaOrg'])) {\\n echo \\\"\\\\n--- Schema.org Structured Data ---\\\\n\\\";\\n echo '' . \\\"\\\\n\\\";\\n }\\n}\\n?>\"\n },\n \"useCases\": [\n \"Social media content optimization and engagement enhancement\",\n \"SEO improvement with structured data and optimized meta tags\",\n \"E-commerce product sharing with rich product information\",\n \"Blog and news article social sharing optimization\",\n \"Brand awareness campaigns with consistent meta tag formatting\",\n \"Multi-platform content distribution with platform-specific optimization\",\n \"AI-powered content enhancement for better click-through rates\",\n \"Enterprise content management with automated meta tag generation\"\n ]\n}\n\n## Usage Notes\n\n- **Authentication Required**: All requests must include a valid API key in the Authorization header.\n- **Rate Limiting**: API calls are subject to rate limits based on your subscription plan.\n- **Response Format**: All responses include success status, timestamp, and processing time metadata.\n\n\n## Best Practices\n\n### Authentication\n- Store API keys securely and never expose them in client-side code\n- Rotate API keys regularly for enhanced security\n- Use environment variables to manage API keys in production\n\n### Error Handling\n- Always check the success field in responses before processing data\n- Implement proper retry logic with exponential backoff for rate limits\n- Log error responses for debugging and monitoring purposes\n\n### Performance\n- Cache responses when appropriate to reduce API calls\n- Use appropriate timeout values for your use case\n- Monitor your usage to optimize API call patterns\n\n", "version": "v1", "contact": { "name": "APIStack Support", "url": "https://apistack.online", "email": "support@apistack.online" }, "license": { "name": "Commercial", "url": "https://apistack.online/terms" }, "x-logo": { "url": "https://apistack.online/APIStack.svg" } }, "servers": [ { "url": "https://apistack.online", "description": "Production server" } ], "paths": { "/api/web/social-media-meta-tag-generator/v1": { "post": { "summary": "Social Media Meta Tag Generator (POST)", "description": "Generate optimized meta tags for social media platforms with AI-enhanced content optimization and multi-platform support", "operationId": "social_media_meta_tag_generator_post", "tags": [ "web" ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/socialmediametataggeneratorResponse" }, "examples": { "social_media_meta_tag_generator_request": { "summary": "Social Media Meta Tag Generator Request", "description": "Complete example showing all available parameters for Social Media Meta Tag Generator", "value": { "data": { "htmlTags": [], "metadata": { "platforms": [ "facebook", "twitter", "linkedin" ], "aiEnhanced": true, "contentType": "article", "generatedAt": "2025-01-15T10:30:45.123Z" }, "platforms": { "twitter": { "name": "Twitter", "tags": [ { "name": "twitter:card", "content": "summary_large_image" }, { "name": "twitter:title", "content": "Best Practices for Social Media Marketing in 2025" }, { "name": "twitter:description", "content": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization and cross-platform engagement techniques." }, { "name": "twitter:image", "content": "https://example.com/images/social-media-guide.jpg" }, { "name": "twitter:site", "content": "@digitalmarketinghub" }, { "name": "twitter:creator", "content": "@sarahjohnson" } ] }, "facebook": { "name": "Facebook", "tags": [ { "content": "article", "property": "og:type" }, { "content": "Best Practices for Social Media Marketing in 2025", "property": "og:title" }, { "content": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization and cross-platform engagement techniques.", "property": "og:description" }, { "content": "https://example.com/blog/social-media-marketing-2025", "property": "og:url" }, { "content": "https://example.com/images/social-media-guide.jpg", "property": "og:image" }, { "content": "Digital Marketing Hub", "property": "og:site_name" }, { "content": "Sarah Johnson", "property": "article:author" }, { "content": "2025-01-15T10:00:00Z", "property": "article:published_time" } ], "recommendations": { "titleLength": 48, "maxTitleLength": 60, "descriptionLength": 142, "maxDescriptionLength": 160 } } }, "schemaOrg": { "url": "https://example.com/blog/social-media-marketing-2025", "@type": "Article", "image": { "url": "https://example.com/images/social-media-guide.jpg", "@type": "ImageObject", "width": 1200, "height": 630 }, "author": { "name": "Sarah Johnson", "@type": "Person" }, "@context": "https://schema.org", "headline": "Best Practices for Social Media Marketing in 2025", "publisher": { "name": "Digital Marketing Hub", "@type": "Organization" }, "description": "Discover the latest strategies and trends for effective social media marketing...", "datePublished": "2025-01-15T10:00:00Z" }, "aiEnhancement": { "model": "gpt-4-turbo-preview", "enhanced": true, "tokensUsed": 287, "originalTitle": "Social Media Marketing Guide 2025", "originalDescription": "Learn about social media marketing strategies for 2025" } }, "message": "Social media meta tags generated successfully", "success": true, "metadata": { "platforms": [ "facebook", "twitter", "linkedin" ], "aiOptimized": true, "contentType": "article", "tagsGenerated": 14, "processingTime": "2025-01-15T10:30:45.123Z", "schemaGenerated": true, "platformsProcessed": 3 } } } } } } }, "400": { "description": "Bad Request - Invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized - Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests - Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/socialmediametataggeneratorRequest" }, "examples": { "social_media_meta_tag_generator_request": { "summary": "Social Media Meta Tag Generator Request", "description": "Complete example showing all available parameters for Social Media Meta Tag Generator", "value": { "url": "https://example.com/blog/social-media-marketing-2025", "tags": [ "social media", "marketing", "AI", "digital strategy" ], "image": "https://example.com/images/social-media-guide.jpg", "title": "Best Practices for Social Media Marketing in 2025", "author": "Sarah Johnson", "section": "Marketing", "aiPrompt": "Optimize for maximum engagement while maintaining professional tone for business audience", "siteName": "Digital Marketing Hub", "platforms": [ "facebook", "twitter", "linkedin" ], "contentType": "article", "description": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization and cross-platform engagement techniques.", "twitterCard": "summary_large_image", "twitterSite": "@digitalmarketinghub", "publishedTime": "2025-01-15T10:00:00Z", "aiOptimization": true, "generateSchema": true, "twitterCreator": "@sarahjohnson" } } } } } } }, "get": { "summary": "Social Media Meta Tag Generator (GET)", "description": "Generate optimized meta tags for social media platforms with AI-enhanced content optimization and multi-platform support", "operationId": "social_media_meta_tag_generator_get", "tags": [ "web" ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/socialmediametataggeneratorResponse" }, "examples": { "social_media_meta_tag_generator_request": { "summary": "Social Media Meta Tag Generator Request", "description": "Complete example showing all available parameters for Social Media Meta Tag Generator", "value": { "data": { "htmlTags": [], "metadata": { "platforms": [ "facebook", "twitter", "linkedin" ], "aiEnhanced": true, "contentType": "article", "generatedAt": "2025-01-15T10:30:45.123Z" }, "platforms": { "twitter": { "name": "Twitter", "tags": [ { "name": "twitter:card", "content": "summary_large_image" }, { "name": "twitter:title", "content": "Best Practices for Social Media Marketing in 2025" }, { "name": "twitter:description", "content": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization and cross-platform engagement techniques." }, { "name": "twitter:image", "content": "https://example.com/images/social-media-guide.jpg" }, { "name": "twitter:site", "content": "@digitalmarketinghub" }, { "name": "twitter:creator", "content": "@sarahjohnson" } ] }, "facebook": { "name": "Facebook", "tags": [ { "content": "article", "property": "og:type" }, { "content": "Best Practices for Social Media Marketing in 2025", "property": "og:title" }, { "content": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization and cross-platform engagement techniques.", "property": "og:description" }, { "content": "https://example.com/blog/social-media-marketing-2025", "property": "og:url" }, { "content": "https://example.com/images/social-media-guide.jpg", "property": "og:image" }, { "content": "Digital Marketing Hub", "property": "og:site_name" }, { "content": "Sarah Johnson", "property": "article:author" }, { "content": "2025-01-15T10:00:00Z", "property": "article:published_time" } ], "recommendations": { "titleLength": 48, "maxTitleLength": 60, "descriptionLength": 142, "maxDescriptionLength": 160 } } }, "schemaOrg": { "url": "https://example.com/blog/social-media-marketing-2025", "@type": "Article", "image": { "url": "https://example.com/images/social-media-guide.jpg", "@type": "ImageObject", "width": 1200, "height": 630 }, "author": { "name": "Sarah Johnson", "@type": "Person" }, "@context": "https://schema.org", "headline": "Best Practices for Social Media Marketing in 2025", "publisher": { "name": "Digital Marketing Hub", "@type": "Organization" }, "description": "Discover the latest strategies and trends for effective social media marketing...", "datePublished": "2025-01-15T10:00:00Z" }, "aiEnhancement": { "model": "gpt-4-turbo-preview", "enhanced": true, "tokensUsed": 287, "originalTitle": "Social Media Marketing Guide 2025", "originalDescription": "Learn about social media marketing strategies for 2025" } }, "message": "Social media meta tags generated successfully", "success": true, "metadata": { "platforms": [ "facebook", "twitter", "linkedin" ], "aiOptimized": true, "contentType": "article", "tagsGenerated": 14, "processingTime": "2025-01-15T10:30:45.123Z", "schemaGenerated": true, "platformsProcessed": 3 } } } } } } }, "400": { "description": "Bad Request - Invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized - Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests - Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "title", "in": "query", "required": true, "description": "Page title for meta tags. Must be non-empty string, max 100 characters. Will be optimized for each platform's character limits.", "schema": { "type": "string", "example": "Best Practices for Social Media Marketing in 2025" } }, { "name": "description", "in": "query", "required": true, "description": "Page description for meta tags. Must be non-empty string, max 500 characters. Optimized per platform limits.", "schema": { "type": "string", "example": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques." } }, { "name": "url", "in": "query", "required": true, "description": "Canonical URL of the page. Must be valid HTTP/HTTPS URL format for proper social sharing.", "schema": { "type": "string", "example": "https://example.com/blog/social-media-marketing-2025" } }, { "name": "image", "in": "query", "required": false, "description": "URL of the main image for social sharing. Should be valid image URL with standard extensions (jpg, png, webp).", "schema": { "type": "string", "example": "https://example.com/images/social-media-guide.jpg" } }, { "name": "contentType", "in": "query", "required": false, "description": "Type of content for optimal meta tag generation. Supported: website, article, product, video, event.", "schema": { "type": "string", "example": "article", "default": "website" } }, { "name": "platforms", "in": "query", "required": false, "description": "Social media platforms to generate tags for. Supported platforms: facebook, twitter, linkedin, whatsapp.", "schema": { "type": "array", "example": "[\"facebook\", \"twitter\", \"linkedin\", \"whatsapp\"]", "default": "[\"facebook\", \"twitter\"]" } }, { "name": "siteName", "in": "query", "required": false, "description": "Name of the website/brand for og:site_name meta tag. Helps with brand recognition in social shares.", "schema": { "type": "string", "example": "Digital Marketing Hub" } }, { "name": "author", "in": "query", "required": false, "description": "Author name for article content type. Used in article:author and Schema.org author fields.", "schema": { "type": "string", "example": "Sarah Johnson" } }, { "name": "publishedTime", "in": "query", "required": false, "description": "Publication date in ISO 8601 format for article content. Used in article:published_time and Schema.org.", "schema": { "type": "string", "example": "2025-01-15T10:00:00Z" } }, { "name": "modifiedTime", "in": "query", "required": false, "description": "Last modification date in ISO 8601 format for article content. Used in article:modified_time meta tag.", "schema": { "type": "string", "example": "2025-01-15T12:30:00Z" } }, { "name": "section", "in": "query", "required": false, "description": "Content section/category for article type. Used in article:section meta tag for content categorization.", "schema": { "type": "string", "example": "Marketing" } }, { "name": "tags", "in": "query", "required": false, "description": "Array of content tags/keywords for enhanced categorization and SEO optimization.", "schema": { "type": "array", "example": "[\"social media\", \"marketing\", \"AI\", \"digital strategy\"]", "default": "[]" } }, { "name": "locale", "in": "query", "required": false, "description": "Content locale for internationalization. Used in og:locale meta tag for proper language targeting.", "schema": { "type": "string", "example": "en_US", "default": "en_US" } }, { "name": "twitterCard", "in": "query", "required": false, "description": "Twitter card type. Supported: summary, summary_large_image, app, player. Affects Twitter display format.", "schema": { "type": "string", "example": "summary_large_image", "default": "summary_large_image" } }, { "name": "twitterSite", "in": "query", "required": false, "description": "Twitter handle for the website/brand. Used in twitter:site meta tag. @ symbol added automatically if missing.", "schema": { "type": "string", "example": "@digitalmarketinghub" } }, { "name": "twitterCreator", "in": "query", "required": false, "description": "Twitter handle for content creator/author. Used in twitter:creator meta tag. @ symbol added automatically.", "schema": { "type": "string", "example": "@sarahjohnson" } }, { "name": "customTags", "in": "query", "required": false, "description": "Custom meta tags as key-value pairs. Allows adding platform-specific or custom meta tags not covered by standard fields.", "schema": { "type": "object", "example": "{\"fb:app_id\": \"123456789\", \"theme-color\": \"#1DA1F2\"}", "default": "{}" } }, { "name": "generateSchema", "in": "query", "required": false, "description": "Whether to generate Schema.org structured data. Enhances SEO and rich snippets in search results.", "schema": { "type": "boolean", "example": "true", "default": "true" } }, { "name": "aiOptimization", "in": "query", "required": false, "description": "Enable AI-powered content optimization using GPT-4. Improves title and description for better engagement.", "schema": { "type": "boolean", "example": "true", "default": "false" } }, { "name": "aiPrompt", "in": "query", "required": false, "description": "Custom prompt for AI optimization. Guides the AI enhancement process for specific audience or tone requirements.", "schema": { "type": "string", "example": "Optimize for maximum engagement while maintaining professional tone for business audience" } } ] } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "API key for authentication. Get your key at https://apistack.online" } }, "schemas": { "socialmediametataggeneratorRequest": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title for meta tags. Must be non-empty string, max 100 characters. Will be optimized for each platform's character limits.", "example": "Best Practices for Social Media Marketing in 2025" }, "description": { "type": "string", "description": "Page description for meta tags. Must be non-empty string, max 500 characters. Optimized per platform limits.", "example": "Discover the latest strategies and trends for effective social media marketing, including AI-driven content optimization techniques." }, "url": { "type": "string", "description": "Canonical URL of the page. Must be valid HTTP/HTTPS URL format for proper social sharing.", "example": "https://example.com/blog/social-media-marketing-2025" }, "image": { "type": "string", "description": "URL of the main image for social sharing. Should be valid image URL with standard extensions (jpg, png, webp).", "example": "https://example.com/images/social-media-guide.jpg" }, "contentType": { "type": "string", "description": "Type of content for optimal meta tag generation. Supported: website, article, product, video, event.", "example": "article", "default": "website" }, "platforms": { "type": "array", "description": "Social media platforms to generate tags for. Supported platforms: facebook, twitter, linkedin, whatsapp.", "example": "[\"facebook\", \"twitter\", \"linkedin\", \"whatsapp\"]", "default": "[\"facebook\", \"twitter\"]" }, "siteName": { "type": "string", "description": "Name of the website/brand for og:site_name meta tag. Helps with brand recognition in social shares.", "example": "Digital Marketing Hub" }, "author": { "type": "string", "description": "Author name for article content type. Used in article:author and Schema.org author fields.", "example": "Sarah Johnson" }, "publishedTime": { "type": "string", "description": "Publication date in ISO 8601 format for article content. Used in article:published_time and Schema.org.", "example": "2025-01-15T10:00:00Z" }, "modifiedTime": { "type": "string", "description": "Last modification date in ISO 8601 format for article content. Used in article:modified_time meta tag.", "example": "2025-01-15T12:30:00Z" }, "section": { "type": "string", "description": "Content section/category for article type. Used in article:section meta tag for content categorization.", "example": "Marketing" }, "tags": { "type": "array", "description": "Array of content tags/keywords for enhanced categorization and SEO optimization.", "example": "[\"social media\", \"marketing\", \"AI\", \"digital strategy\"]", "default": "[]" }, "locale": { "type": "string", "description": "Content locale for internationalization. Used in og:locale meta tag for proper language targeting.", "example": "en_US", "default": "en_US" }, "twitterCard": { "type": "string", "description": "Twitter card type. Supported: summary, summary_large_image, app, player. Affects Twitter display format.", "example": "summary_large_image", "default": "summary_large_image" }, "twitterSite": { "type": "string", "description": "Twitter handle for the website/brand. Used in twitter:site meta tag. @ symbol added automatically if missing.", "example": "@digitalmarketinghub" }, "twitterCreator": { "type": "string", "description": "Twitter handle for content creator/author. Used in twitter:creator meta tag. @ symbol added automatically.", "example": "@sarahjohnson" }, "customTags": { "type": "object", "description": "Custom meta tags as key-value pairs. Allows adding platform-specific or custom meta tags not covered by standard fields.", "example": "{\"fb:app_id\": \"123456789\", \"theme-color\": \"#1DA1F2\"}", "default": "{}" }, "generateSchema": { "type": "boolean", "description": "Whether to generate Schema.org structured data. Enhances SEO and rich snippets in search results.", "example": "true", "default": "true" }, "aiOptimization": { "type": "boolean", "description": "Enable AI-powered content optimization using GPT-4. Improves title and description for better engagement.", "example": "true", "default": "false" }, "aiPrompt": { "type": "string", "description": "Custom prompt for AI optimization. Guides the AI enhancement process for specific audience or tone requirements.", "example": "Optimize for maximum engagement while maintaining professional tone for business audience" } }, "required": [ "title", "description", "url" ] }, "socialmediametataggeneratorResponse": { "type": "object", "properties": { "success": { "type": "boolean", "description": "Indicates if the operation was successful", "example": true }, "data": { "type": "object", "description": "Response data" }, "quota": { "type": "object", "description": "API usage quota information", "properties": { "used": { "type": "integer", "description": "Number of API calls used" }, "limit": { "type": "integer", "description": "Maximum API calls allowed" }, "remaining": { "type": "integer", "description": "Remaining API calls" }, "period": { "type": "string", "description": "Quota reset period" } } }, "metadata": { "type": "object", "description": "Response metadata", "properties": { "apiVersion": { "type": "string", "description": "API version" }, "service": { "type": "string", "description": "Service name" }, "processingTime": { "type": "string", "description": "Processing time" } } } }, "required": [ "success", "data" ] }, "ErrorResponse": { "type": "object", "properties": { "success": { "type": "boolean", "example": false, "description": "Always false for error responses" }, "error": { "type": "string", "description": "Error type or category" }, "message": { "type": "string", "description": "Human-readable error description" } }, "required": [ "success", "error" ] } } }, "tags": [ { "name": "web", "description": "web operations" } ] }