AI Headlines Generator Endpoint

Introduction

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

Endpoint URL

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

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 headlines 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.
exampleHeadlines: An optional string of up to 200 characters that represents example headlines. These headlines can be used to fine-tune the results received.

Output

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

Example

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

[
	{
		"adId": 0,
		"data": {
			"headline": {
				"data": [
					{
						"data": "Start free Facebook Ads trial",
						"length": 29
					},
					{
						"data": "Let us help - Facebook Ads",
						"length": 26
					},
					{
						"data": "Try Google Adwords Now",
						"length": 22
					},
					{
						"data": "Madgicx Analytics for Ads",
						"length": 25
					},
					{
						"data": "Get Creative w/ Ads Reports",
						"length": 27
					},
					{
						"data": "Youtube & Ad Performance",
						"length": 24
					},
					{
						"data": "Start a Free Ad Account",
						"length": 23
					},
					{
						"data": "Adwords Success Starts Here",
						"length": 27
					},
					{
						"data": "Manage Ad Attribution Easily",
						"length": 28
					},
					{
						"data": "Get Insights into Ads Now",
						"length": 25
					},
					{
						"data": "Start & Track Ads for Results",
						"length": 29
					}
				],
				"length": 11
			}
		}
	}
]