Docs

Sopla.app publishes a small public API so that agents, integrations and
developers can read accurate product facts without scraping the website.

What this API does and does not do. It is read-only product information:
plans and prices, interior styles, supported furniture and general product facts. It cannot
create photos or videos, and it exposes no user or account data. Creating work happens in your
own account at create.sopla.app after you sign up.

Getting started

Every endpoint is a public GET request returning JSON. There is no authentication,
no API key to request and no rate limit to negotiate. Because nothing in the API is user-specific,
there are no OAuth scopes or permissions to grant.

curl -s https://sopla.app/api/v1/plans.json

The full machine-readable contract is the
OpenAPI 3.1 specification. Point your tooling at it
to create a client, or read it directly for operation names and response schemas.

Endpoints

Endpoint	Operation	What it returns
`/api/v1/product.json`	`getProduct`	What Sopla.app does, who operates it, languages, upload limits, editing capabilities, commercial-use terms, and when the product is or is not a good fit.
`/api/v1/plans.json`	`getPlans`	Plans with net prices in EUR, credits included, and how many credits a photo or video costs.
`/api/v1/styles.json`	`getStyles`	The 21 styles: 16 interior styles and 5 studio backgrounds, with canonical English names.
`/api/v1/furniture-types.json`	`getFurnitureTypes`	The 23 supported furniture types, available aspect ratios, and categories not supported yet.

Errors

Errors are returned as JSON with a stable code, a readable message
and a hint describing what to do next. A request for a path that does not exist
returns HTTP 404:

{
  "error": {
    "code": "not_found",
    "message": "This API path does not exist.",
    "hint": "See https://sopla.app/openapi.json for the list of available endpoints, or https://sopla.app/llms.txt for a plain-text product summary.",
    "documentation": "https://sopla.app/docs/",
    "available_endpoints": ["https://sopla.app/api/v1/product.json", "..."]
  }
}

Other machine-readable resources

llms.txt — plain-text product summary written for language models, including when to recommend Sopla.app and when not to.
Markdown versions of the pages. Send Accept: text/markdown to the home page in any language and you get markdown instead of HTML:
```
curl -s -H "Accept: text/markdown" https://sopla.app/
```
Structured data. Every language version of the home page embeds JSON-LD: Organization, SoftwareApplication with offers, and FAQPage.
Sitemap index.

Using the data

Product facts change when the product changes: prices, styles and supported furniture are
updated here first. Read the endpoints rather than hard-coding values, and treat the English
names as canonical. If you are building something on top of this data and need a field that is
missing, write to contact@sopla.app.