GET https://api.slide-tailor.com/placeholders

Scan a PowerPoint (.pptx) template to identify placeholders, such as {Name} or {Date}, and the context in which each appears.

A placeholder is a marker the user puts in the template to indicate where dynamic data should be inserted. By default this endpoint takes text marked with braces as a placeholder, but you can follow any convention you like and use the placeholderPattern parameter to override the default.

Query Parameters

template
The URL of the PowerPoint (.pptx) template to analyze. This parameter is required.
placeholderPattern
A regular expression to match placeholders in the template. Optional. Defaults to \{[\w ]+}.

Response

On success, the response will be a JSON array of objects, each representing a placeholder found in the template.

[
  {
    "placeholder": "{askingPrice}",
    "type": "shapeText"
  },
  {
    "placeholder": "{customerLogo}",
    "type": "image"
  }
]

Each object contains:

  • placeholder: The matched placeholder text.
  • type: The type of placeholder. Possible values are:
    • inline: Found within text content.
    • shapeText: Found in the name of a shape.
    • image: Found in the name of an image or picture shape.

On failure, the response will be a JSON object with an errors array containing one or more error messages.

{
  "errors": [
    "Missing 'template' query parameter"
  ]
}