# AdsCreator

> AI-powered ad creative generator. Paste any URL, extract brand DNA, and generate on-brand ad creatives in seconds. No design skills required.

## API

- [OpenAPI Spec](https://www.adscreator.com/openapi.json): Machine-readable API specification (OpenAPI 3.1)
- [Full Documentation](https://www.adscreator.com/llms-full.txt): Complete API reference with all parameters, enums, and examples
- [Developer Docs](https://www.adscreator.com/developers): Interactive API documentation

## Capabilities

- Extract brand identity (colors, logos, fonts, tone, description) from any URL
- Generate multiple ad creatives across formats: square (1:1), landscape (16:9), portrait (9:16), portrait_meta (4:5), story (9:16)
- Target specific ad networks: Meta, Google, LinkedIn, X, TikTok
- Optimize for campaign objectives: awareness, leads, sales, launch, retargeting, event
- 7 ad styles: product-hero, text-overlay, offer-promo, testimonial-proof, feature-explainer, lifestyle-scene, stat-callout
- Edit existing ads with text prompts
- Resize ads to different formats

## Authentication

API key via Bearer token in the Authorization header.
Obtain an API key from the AdsCreator dashboard at Settings > API Keys.

```
Authorization: Bearer ac_sk_your_api_key_here
```

## Quickstart

1. Extract brand: `POST /api/brands` with `{"domain": "example.com"}`
2. Generate ads: `POST /api/generate?sync=true` with `{"brandId": "...", "count": 3}`
3. List creatives: `GET /api/creatives`

## Pricing

Credits-based. Each generated ad output costs 1 credit. Generating 3 ads across 2 formats = 6 credits.
Check balance: `GET /api/credits`