Extendify API

https://ai.extendify.com/api/design

Generate full WordPress website previews from a text description, or by pointing the API at an existing site URL that will be scraped and redesigned.

Typical flow

1. Client calls GET /api/design?description=A+bakery+in+Paris&language=fr_FR
   (or GET /api/design?url=https://www.customer-site.com to redesign an existing site)
   with header: Authorization: Bearer YOUR_TOKEN
2. Gets back { "id": "abc123" }
3. Loads <iframe src="/api/design/abc123/iframe">
4. Iframe shows spinner, then streams final HTML when ready
5. Optionally poll GET /api/design/abc123 for structured data
6. Redirect user to WordPress: /wp-admin/?auto-launch=true&build-id=abc123

Authentication

All requests to GET /api/design require an authentication token sent as a Bearer header:

Authorization: Bearer YOUR_TOKEN

Getting a token: tokens are issued manually by the Extendify team. Reach out to us to get one for your integration.

The token identifies the partner and is used for usage tracking. Read endpoints (GET /api/design/{id}, GET /api/design/{id}/iframe) are unauthenticated — the build ID itself acts as the access credential.

Errors

• 401 Unauthorized — missing, invalid, or revoked token
• 403 url-input-not-permitted — token is not allowed to use Redesign. Email Extendify to enable this feature for your token.

Endpoints

GET /api/design?description=...&language=...

Starts a new design preview generation. Send either description or url.

A redesign always generates the entire homepage (so it is always a full-page preview); description and view are ignored when url is set.

Response 200

{ "id": "abc123" }

Errors

• 400 invalid-input — neither description nor url provided
• 400 — Unsupported language (returns { error, supported })
• 400 invalid-structure — structure is not single-page or multi-page (returns { error, message })
• 400 url-blocked — URL could not be parsed, used a disallowed scheme, or pointed at a private/loopback host
• 403 url-input-not-permitted — token is not allowed to use Redesign. Email Extendify to enable this feature for your token.
• 429 — Rate limited

Generation runs asynchronously. Use the ID to poll status or load the iframe.

GET /api/design/{id}/iframe

Renders the preview as a streamable HTML page. Designed to be loaded in an <iframe>.

• Shows an animated loader while generation is in progress
• Streams the final HTML once complete
• Times out after ~5 minutes
• Posts message events to the parent window (works cross-origin)
• Returns 404 for an unknown ID, 410 once a full-page preview has expired, or 500 if generation already failed

Parent window events — listen with window.addEventListener('message', handler):

All messages have { type: 'extendify-design-preview', event, height? }.

GET /api/design/{id}

Returns the current state of a design preview.

Response 200

{
	"id": "abc123",
	"status": "complete",
	"html": "<!DOCTYPE html>...",
	"screenshots": [
		{
			"slug": "home",
			"raw": "https://...",
			"regular": "https://...",
			"small": "https://...",
			"thumb": "https://..."
		}
	],
	"error": null
}

status is complete when the preview is ready, error on failure, or one of these in-flight values, in order:

starting, fetching-url, processing-logo, generating-profile, generating-content, generating-images, capturing-screenshot

fetching-url and processing-logo are only seen on a redesign, and processing-logo is skipped when the page has neither a logo nor images to use. capturing-screenshot is only seen when screenshot=true.

Errors

• 404 — Unknown ID
• 410 preview-expired — A full-page preview has expired and is no longer available

Error codes

A failed preview's last line in error is unexpected, followed by the underlying error. A redesign can also fail with one of the codes listed under Redesign below.

Soft failures are appended to the error field but the preview still completes:

error may carry several lines — soft fallbacks plus, eventually, a hard error. Each line starts with its code so you can branch on it.

Screenshots

screenshots has one entry per page, each carrying the same PNG in four widths:

Important: every screenshot URL is signed and expires within approximately 30 minutes. We recommend downloading the image and hosting it yourself rather than hot-linking to it.

The response also includes additional fields consumed server-side by the WordPress redirect flow. Their shape is internal — don't rely on it.

WordPress redirect

Once the user is happy with the preview, redirect them to their WordPress admin to apply the design:

https://{user-site}/wp-admin/?auto-launch=true&build-id={id}

Supported languages

See extendify.com/documentation/supported-languages

Redesign

Send url instead of description to generate the preview from an existing site. Redesign must be enabled for your token; otherwise GET /api/design returns 403 url-input-not-permitted. Email Extendify to enable this feature for your token.

What we extract from a URL

We extract data like site title, logo, description, menu items, contact information, and more.

In the current version, only a single provided page URL is used to retrieve the information, and only data visible within the page render is used.

Failure modes

These all set status: "error" on the preview row and surface a code in the error field:

All codes in the error codes table above can appear on a redesign; those marked Redesign only never appear on a description preview.

Credit usage