create_keywords

Create one or more positive keywords in the Metadata platform library.

                PURPOSE:
                Batch create positive keywords that can be used in advertising campaigns. Use this tool to
                expand your keyword library by adding new terms, variations, or related keywords for targeting
                and campaign optimization.

                WHEN TO USE:
                - Add new keywords to your campaign library
                - Build keyword lists for new product lines or services
                - Create variations of existing keywords
                - Expand keyword coverage for targeted advertising
                - Create keyword groups for seasonal campaigns
                - Add long-tail keywords for niche targeting
                - Build negative keyword lists (blocked keywords)
                - Bulk import keyword lists from external sources

                KEY FEATURES:
                ✓ BATCH CREATION: Create multiple keywords in a single API request
                ✓ SIMPLE FORMAT: Each keyword is simply a string
                ✓ FLEXIBLE: Create 1 or 100+ keywords at once
                ✓ LIBRARY INTEGRATION: Keywords are added to your keyword library and available for campaigns

                KEYWORD FORMAT:
                Each keyword in the batch should be a simple string:
                - "digital marketing"
                - "seo services"
                - "ppc advertising"

                BATCH SIZE RECOMMENDATIONS:
                - Small batches (5-50 keywords): Ideal for testing and quick additions
                - Medium batches (50-500 keywords): Good for standard imports
                - Large batches (500+ keywords): Use for bulk library imports
                - Maximum recommended: 1000 keywords per request for optimal performance

                KEYWORD NAMING CONVENTIONS:
                - Use lowercase for consistency with platform standards
                - Separate multi-word phrases (e.g., "digital marketing" not "DigitalMarketing")
                - Avoid special characters unless necessary for the keyword
                - Remove leading/trailing whitespace - the API will normalize
                - Empty strings are allowed but won't create keywords
                - Duplicate names in the batch will be deduplicated by the API

                COMMON USE CASES:
                1. Create a single keyword:
                   create_keywords(keywords=["marketing"])

                2. Create multiple related keywords:
                   create_keywords(keywords=[
                     "digital marketing",
                     "marketing automation",
                     "email marketing"
                   ])

                3. Create keyword variations:
                   create_keywords(keywords=[
                     "seo",
                     "seo services",
                     "seo tools",
                     "seo optimization"
                   ])

                4. Create long-tail keywords:
                   create_keywords(keywords=[
                     "best digital marketing agency in new york",
                     "affordable seo services for small business",
                     "enterprise marketing automation platform"
                   ])

                5. Bulk import from external list:
                   create_keywords(keywords=[
                     "keyword1",
                     "keyword2",
                     "keyword3",
                     ... (repeat for all keywords)
                   ])

                6. Create campaign-specific keywords:
                   create_keywords(keywords=[
                     "black friday deals",
                     "cyber monday sales",
                     "holiday promotions"
                   ])

                7. Create product-related keywords:
                   create_keywords(keywords=[
                     "product a",
                     "product a review",
                     "buy product a",
                     "product a price"
                   ])

                PARAMETERS:
                - keywords: Required. Array of keyword strings to create.
                           Example: ["goku", "ssj", "ssj1"]
                           - Each keyword is a string
                           - Minimum: 1 keyword
                           - Recommended maximum: 1000 keywords per request
                           - Empty strings are allowed but won't create keywords
                           - Duplicates will be deduplicated

                RESPONSE FORMAT:
                Returns a response containing:
                - Created keywords with their IDs and metadata
                - Success/failure status for each keyword
                - Any validation errors for invalid entries
                - Confirmation of keywords added to the library

                VALIDATION NOTES:
                - Empty strings or null values in the batch are skipped
                - Platform automatically removes duplicate names in the batch
                - Keywords are case-insensitive for deduplication
                - Special characters are preserved as provided
                - Platform validates keyword length (typically 2-100 characters recommended)

                PERFORMANCE TIPS:
                - Keep batch sizes under 1000 keywords for faster processing
                - Group related keywords together for better organization
                - Review the response to confirm all keywords were created successfully
                - Check your keyword library after creation to verify the additions

                EXAMPLES:
                - create_keywords(keywords=["marketing"]) - Create single keyword
                - create_keywords(keywords=["seo", "sem", "ppc"]) - Create multiple keywords
                - create_keywords(keywords=["digital marketing", "online marketing", "internet marketing"]) - Variations
                - create_keywords(keywords=["goku", "ssj", "ssj1", "ssj2"]) - Batch creation