Skip to content
Pixii
Login

Changelog

Notable changes to the Pixii API. We follow semantic versioning. Breaking changes always result in a new API version.

All notable changes to the Pixii API are documented here. We follow semantic versioning. Breaking changes always result in a new API version.

2026-11-10, Walmart products

  • The product asin field of create_listing, create_anything, scale and download_visuals also accepts a Walmart item ID or a Walmart product page URL (walmart.com or walmart.ca, app share links included on create_listing, create_anything and scale). country_code is optional for a Walmart item ID: US by default, CA for walmart.ca; any other marketplace is rejected.
  • scale and download_visuals now also accept a Shopify product page URL in asin, like create_listing and create_anything, so the four endpoints take the same product forms.

2026-11-04, product URLs, session names and session_id on jobs

  • The product asin field of create_listing, create_anything and scale also accepts a product page URL: an Amazon product page of any marketplace (shortlinks included), read as its ASIN and marketplace, or a Shopify product page. Scale and download_visuals take Amazon URLs only; pass a store product by its product_id.
  • Sessions created through the API are named API - {ASIN} (or the product_id when no ASIN is known) and sessions created through the MCP server MCP - {ASIN}, so you can tell them apart in the app.
  • GET /v2/api/jobs/{job_id} now carries session_id for create_listing and create_anything jobs from the moment they are submitted, the same value the submit response returns.

2026-11-03, Brands and download compliance

  • GET /v2/api/brands is new. It lists the brands of your organization with their brand_id; the oldest one is marked is_default.
  • Every POST endpoint accepts an optional brand_id to choose the brand a job runs in. Without it, jobs keep running in your default brand. An unknown id returns 404 with the new BRAND_NOT_FOUND error.
  • Every submit response and every job carries brand_id. create_listing and create_anything submit responses now also carry session_id, so you can keep it before the job completes.
  • POST /v2/api/download_visuals accepts compliances (Amazon, New York, EU). The zip is marked only for the options you pass; omit the field for an unmarked zip.
  • POST /v2/api/create_anything is open on every plan. Only a request that includes A+ Content needs a paid plan and returns PAID_PLAN_REQUIRED otherwise.

2026-11-02, new endpoints

The base URL is now https://api.pixii.ai/v2/api. The earlier /v1/api endpoints keep working unchanged for existing integrations.

  • POST /v2/api/create_listing replaces listing_builder. The product moves into a product object (asin and country_code, or product_id), main_image and other_images accept a URL or base64 bytes, and a new optional user_prompt guides the creative direction.
  • POST /v2/api/create_anything is new. One job for any mix of deliverables: Main Image, Gallery Image, Title and Bullets, A+ Content, Video and Amazon Ads. It replaces the a_plus endpoint.
  • POST /v2/api/scale replaces the Clone endpoint. Modes are Variant, Translate, Different Product and Steal the Look; up to 50 products per run; the result is one zip plus a per-product breakdown.
  • POST /v2/api/creative_strategy is unchanged in shape.
  • POST /v2/api/download_visuals is new and free. Returns a zip of every completed visual for a product.
  • GET /v2/api/jobs/{job_id} returns an error object instead of error_code, credit_cost on every job, and generated visuals as campaign_ads with preview, video_url, platform, asset_type and status. Signed URLs are issued fresh on every read. The job list and session endpoints are retired.
  • GET /v2/api/usage is unchanged in shape.
  • Enumerated values (platforms, listing types, deliverable types, formats, effort, scale modes) are the full names, for example Amazon Listing and A+ Premium Seamless Modules.
  • New error codes: INVALID_IMAGE, UNSUPPORTED_DELIVERABLE, PLAN_LIMIT_REACHED, PRODUCT_NOT_FOUND, NO_VISUALS_FOUND.
  • Plan rules: Create listing and Creative strategy on every plan; Create anything and Scale on paid plans; Scale with more than one product on the Scale plan.

2026-09-18, Walmart, and Clone naming

  • POST /v1/api/listing_builder: walmart_listing is now documented. It has been accepted since the v1 launch and returns the same 7 visuals as the other listing types: main image plus a 6-image gallery.
  • POST /v1/api/scale: Walmart is now documented as a supported items[].platform, accepted since May 2026, and Main Image is valid for Shopify and TikTok as well.
  • Docs correction: jobs from this endpoint return job_type: "Clone", not "Scale". The API is unchanged; the docs were wrong.

2026-09-18, Listing effort

  • POST /v1/api/listing_builder: new optional effort (creative or reliable). reliable keeps every visual on an angle your product photos already show; creative is the default and lets the generator compose new angles and scenes. No extra credits.

2026-09-18, Creative Strategy

  • POST /v1/api/creative_strategy: get the creative strategy for an ASIN: personas, reviews, needs and positioning. Costs 5 credits per request. Pass force_new: true to regenerate.
  • POST /v1/api/listing_builder: new optional include_creative_strategy flag. When true, the completed job’s output also carries creative_strategy, at no extra cost.

2026-04-13, v1 launch

Initial release of the Pixii API.

  • POST /v1/api/listing_builder: generate a full platform-optimized listing from an ASIN.
  • POST /v1/api/scale: replicate a visual identity across your catalog.
  • GET /v1/api/jobs/{job_id}: poll an individual job for status and output.
  • Async job pattern, signed image URLs valid for 7 days, per-organization rate limits.