Skip to main content
POST
/
api
/
v1
/
ads
/
compare
Compare Ads Endpoint
curl --request POST \
  --url https://api.example.com/api/v1/ads/compare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "variants": [
    {
      "headline": "",
      "primary_text": "<string>",
      "body": "<string>",
      "cta": "<string>",
      "description": "<string>",
      "image_url": "<string>"
    }
  ],
  "platform": "<string>"
}
'
{
  "rankings": [
    {}
  ],
  "winner_index": 123,
  "rationale": "<string>",
  "per_variant_scores": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.aitasker.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
variants
AdVariant · object[]
required
Required array length: 2 - 10 elements
​
platform
string
required

Target ad platform (e.g. meta, google, linkedin)

Response

Successful Response

​
rankings
Rankings · object[]
required
​
winner_index
integer
required
​
rationale
string
required
​
per_variant_scores
Per Variant Scores · object[]
required