← Photoshoots
Endpoint: GET https://makelocalads.com/api/v1/photoshoots/{photoshoot_id}
Permission: photoshoots:read
Every photoshoot answers with its current progress and its completed shot
outputs. Poll it until it is done, or list every finished photo for a product
without tracking individual photoshoot IDs.
Poll the photoshoot
Finished images appear on their outputs while the rest continue:
Stop polling when status is completed, failed, or canceled. Use
backoff between requests rather than polling continuously; see
Polling. Reads have their own rate budget, so polling
never uses up the budget for starting new shoots; see
Rate limits.
Individual outputs can fail while the rest of the shoot succeeds, so check
each output’s own status.
caption is the line printed in italics under the artwork. The retro look
writes a different one for every output, tied to what that specific card
shows; every other look returns null. If a caption is present it is part of
the card, so take it with the image.
List a product’s photoshoot creatives
Every completed photo for a product stays retrievable without tracking
individual photoshoot IDs. This returns only completed, customer-facing
photoshoot outputs; it does not return templates, moodboards, failed attempts,
or intermediate assets:
type defaults to photoshoot and is the only workflow supported today. Use
next_cursor unchanged to retrieve the next page. The same list is available
across every creative type with GET /creatives; see
Creatives.
List photoshoots
GET /photoshoots lists photoshoot summaries newest first, filterable by
product_id, with the same cursor pagination. A summary shows progress
(output_count, completed_output_count); retrieve a photoshoot for its
outputs. Last modified on September 30, 2026
