> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomwize.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> Use the EcomWize API to fill, duplicate, and manage your landing pages programmatically.

The EcomWize API lets you integrate your page builder workflow with automation tools and custom scripts. Build a page template once in the visual editor, then use the API to fill it with content at scale.

## What you can do

<CardGroup cols={2}>
  <Card title="Retrieve pages" icon="list">
    List all your pages and get the content structure of any page.
  </Card>

  <Card title="Fill pages" icon="pen-to-square">
    Update text, images, and links in your page sections via API.
  </Card>

  <Card title="Duplicate and fill" icon="copy">
    Clone a template page and fill it with new content in one request.
  </Card>

  <Card title="Automation ready" icon="bolt">
    Works with any HTTP client, automation platform, or custom code.
  </Card>
</CardGroup>

## Typical workflow

<Steps>
  <Step title="Build a template page">
    Use the EcomWize visual editor to design your landing page with sections, brand styles, and layout. This page becomes your template.
  </Step>

  <Step title="Create an API key">
    Go to **API Keys** in your dashboard and create a new key. Copy it immediately -- you will not be able to see it again.
  </Step>

  <Step title="Get the page structure">
    Call `GET /api/v1/pages/{page_id}` to see all section types and their content fields. This tells you exactly which fields you can fill.
  </Step>

  <Step title="Fill or duplicate">
    Use `POST /api/v1/pages/{page_id}/fill` to update the template in place, or `POST /api/v1/pages/{page_id}/duplicate-and-fill` to create a new page with your content.
  </Step>
</Steps>

## Base URL

All API requests use the following base URL:

```
https://app.ecomwize.io/api/v1
```

## Content only

The API only exposes and accepts **content fields** -- text, media URLs, and button links. Style and layout fields like colors, font sizes, alignment, and spacing are not exposed. This means your design stays intact no matter what content you send through the API.

## Rate limits

| Endpoint type            | Limit                              |
| ------------------------ | ---------------------------------- |
| Read endpoints (`GET`)   | 60 requests per minute per API key |
| Write endpoints (`POST`) | 20 requests per minute per API key |
| API key creation         | 5 keys per hour                    |

When you exceed the limit, the API returns a `429` status code with a `Retry-After` header.

<Note>
  The API is currently in **Beta**. Endpoints and response formats may change as we improve the product. We will notify you before making breaking changes.
</Note>