Creative Intelligence - AI Ad Creative Analysis

The deployed schema requires provider. Analysis also needs a matching provider key or configured provider environment credentials, plus creative assets. Replace the example asset URL and key; example.com is a placeholder, not a working creative.

{
  "provider": "openai",
  "apiKey": "YOUR_OPENAI_API_KEY",
  "creatives": [
    {
      "id": "creative-1",
      "brand": "Example Brand",
      "body": "Turn ad creatives into measurable insights.",
      "cta": "Learn More",
      "assetUrl": "https://example.com/ad.jpg",
      "assetType": "image"
    }
  ]
}

• Rows include analysis_status, provider/model context, observed creative attributes, scores, and suggestions. Failed rows are saved with an error.
• A successful run can contain failed creatives. Exclude failed rows from ranking, and treat scores as model judgments rather than measured campaign performance.

{
  "analysis_status": "failed",
  "provider": "openai",
  "libraryID": "example-creative",
  "error": "Illustrative asset or provider error"
}

Fields in the documented output view

Output views select columns. They do not necessarily filter record types or exhaust the full JSON payload. Use structured JSON when you need nested arrays or objects.

These are the active public event prices checked on 2026-10-29, in USD. They describe each event, not a universal flat price for a run. Confirm your current Apify plan and run budget before starting.

A result limit and a spending cap are different controls. Account charges, applicable taxes, and separately billed providers or proxies must be considered where relevant. A cap setting is not a minimum invoice charge.

Test a small run in Apify Console, inspect its records and charges, then save a task or call the actor from your own application. Keep your Apify token in an environment variable. Source-specific credentials, if required, are separate from the Apify API token.

# Save the input example as input.json and set APIFY_TOKEN.
# This request starts an asynchronous, potentially billable run.
curl --request POST \
  'https://api.apify.com/v2/acts/whoareyouanas~creative-intelligence/runs' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data @input.json

The response identifies the run. Wait for it to finish, inspect its status, and use its default dataset and key-value store to retrieve results. A successful run can still contain partial or failed records; check the output contract above before continuing downstream.