Description Generator Endpoint

Introduction

This endpoint allows you to generate up to 10 tailored ad descriptions for a product or service.

Endpoint URL

The endpoint URL is a GET request, with the following structure:
/v1/seo/adsGenerator/descriptions/

Input

The input parameters are passed as query parameters, which are the following:

subject: A string of 10 to 60 characters representing the “value proposition” of the product being advertised. The string should contain keywords, separated by a comma. This field is required.
url: A URL of a page that describes the product or service being advertised. The API will extract relevant keywords and phrases from the content of the page to help generate quality ads. This field is required.
mostImportantKeywords: An optional string of up to 100 characters that represents the most important keywords about the ad group. These keywords will be used in the * ad description but it’s not guaranteed that they will be present in the result.
language: An optional 2-letter string that represents the language of the target audience. The ads will be returned in the requested language but results are not guaranteed to be in that language.
country: An optional 2-letter string that represents the country of the target audience. The ads will be returned targeting the country but results are not guaranteed to be country-specific.
exampleDescriptions: An optional string of up to 200 characters that represents example descriptions. These descriptions can be used to fine-tune the results received.

Output

The output is an array of 10 strings, each representing a different ad description.

Example

Here’s an example of a request to the Description generator endpoint:

[
    {
        "adId": 0,
        "data": {
            "headline": {
                "data": [
                    {
                        "data": "Free Facebook Ads Trial: Get Started Now!",
                        "length": 41
                    },
                    {
                        "data": "Let US Help You Improve Performance!",
                        "length": 36
                    },
                    {
                        "data": "Start Tracking Ad Performance Now!",
                        "length": 34
                    },
                    {
                        "data": "Creative Results, Insights & Reports!",
                        "length": 37
                    },
                    {
                        "data": "Free Account Management on Google Ads!",
                        "length": 38
                    },
                    {
                        "data": "Attribute Your YouTube & FB Ads!",
                        "length": 32
                    },
                    {
                        "data": "Get madgicx.com – Beyond Human Limits!",
                        "length": 38
                    },
                    {
                        "data": "Start Free Trial – Perform at Maximum Capacity!",
                        "length": 47
                    }
                ],
                "length": 8
            },
            "desc": {
                "data": [
                    {
                        "data": "a Super Afforable and Powerfull Team. Try it Now for Free!",
                        "length": 58
                    },
                    {
                        "data": "Grow Your Business with Facebook & Google Ads. Start Your Free Trial Today!",
                        "length": 75
                    },
                    {
                        "data": "Get All the Creative Ideas, Reports and Insights You Need with Adwords. Try it Now For Free!",
                        "length": 92
                    },
                    {
                        "data": "Boost Ad Performance with the Best Platforms. Let Us Help You Get Started Today!",
                        "length": 80
                    },
                    {
                        "data": "Take Control of Ad Performance - Madgicx Enhances Your Account Attribution. Try it for Free Now",
                        "length": 95
                    },
                    {
                        "data": "Get Hands On with Tracking! Manage Your Youtube & FB Ads with Our Report Tool. Sign Up Now!",
                        "length": 91
                    },
                    {
                        "data": "Get the Most out of Your Ads - https://us.madgicx.com/get-started - Get Started Now For Free!",
                        "length": 93
                    }
                ],
                "length": 7
            }
        }
    }
]