Produkte und Dateien

Product details

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

GET / v1 / products / {product_id}

One product in full:

sales page texts (HTML), prices and installment plans, limited offer, variants and images
content blocks: texts, images, videos, audio, files (with file_id and name, but no download links), video links and buttons
linked course, bundle contents, checkout fields, stock and availability
sales page URL, checkout URL (live products only) and admin link

A buyer of a variant gets the files of that variant. The files of the product itself then only reach buyers from before the variants existed.

Times are UTC. link_url and access_text_html are not shown. The fields have the same names and formats as in PATCH /v1/products/{product_id}.

Liest nur MCP-Werkzeug get_product

curl "https://api.tentary.com/v1/products/101" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/products/101", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/products/101",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/products/101');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "id": 101,
  "name": "Yoga Basics E-Book",
  "type": "download",
  "status": "live",
  "price": "19.00",
  "current_price": "19.00",
  "price_is_from": false,
  "billing": "one_time",
  "billing_interval_months": null,
  "hide_in_shop": false,
  "sales": 1,
  "paid_sales": 1,
  "url": "https://lena-yoga.mytentary.com/p/yoga-basics",
  "checkout_url": "https://lena-yoga.mytentary.com/p/yoga-basics/checkout",
  "admin_url": "https://app.tentary.com/products/edit/101",
  "description_html": "<p>Learn the 20 most important poses, step by step.</p>",
  "checkout_description_html": "",
  "checkout_banner_url": null,
  "buy_button_text": "",
  "images": [
    "https://img.tentary.com/demo-ebook-cover.jpg"
  ],
  "currency": "EUR",
  "compare_at_price": null,
  "intro_price": null,
  "installment_plans": [
    {
      "count": 2,
      "amount": "9.50"
    }
  ],
  "limited_offer": null,
  "variants": [],
  "content": [
    {
      "type": "file",
      "file_id": 501,
      "name": "Yoga Basics",
      "description": "The e-book as PDF, 84 pages.",
      "file_type": "pdf",
      "size_bytes": 4812330,
      "folder": null
    },
    {
      "type": "video",
      "file_id": 502,
      "name": "Welcome",
      "file_type": "mp4",
      "size_bytes": 91204117,
      "folder": null
    }
  ],
  "course": null,
  "bundle_items": [],
  "custom_fields": [
    {
      "label": "Your yoga level",
      "type": "text",
      "required": false
    }
  ],
  "stock_limit": null,
  "available_from": null,
  "available_until": null,
  "access_days": null,
  "access_starts_on": null,
  "lead_magnet": false,
  "withdrawal_days": 14,
  "url_slug": "yoga-basics",
  "marketing_emails": true,
  "ebook": true,
  "pdf_stamp": true,
  "login_protection": false,
  "show_in_search": true,
  "coupon_field": true
}

Autorisierung

Authorization string Header erforderlich

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Einführung

Pfad-Parameter

product_id integer erforderlich

The id from list_products.

min. 1 Beispiel: 101

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

id integer

The ID.
name string

Product name.
type string

The type.

Mögliche Werte: downloadlinknewsletterbookingcoursebundleexternal
status string

archived = deleted.

Mögliche Werte: livedraftarchived
price string

Decimal string, like "19.90". Normal price.
current_price string

Decimal string, like "19.90". What buyers pay now: a running limited offer replaces the price.
price_is_from boolean

true = the product has variants and price is the lowest variant price.
billing string

How the buyer pays: one_time, subscription or installments.

Mögliche Werte: one_timesubscription
billing_interval_months integer kann null sein

Subscription: months between payments.
hide_in_shop boolean

true = not shown on the shop page.
sales integer

Paid orders and orders in payment of all time, refunded and free orders included.
paid_sales integer

Orders with an amount above 0.
url string<uri>

Sales page.
checkout_url string<uri> kann null sein

Checkout page. Only for live products.
admin_url string<uri>

The product in the Tentary app.
description_html string

Sales page text.
checkout_description_html string

Extra text on the checkout page.
checkout_banner_url string kann null sein

Banner image on the checkout page.
buy_button_text string

Empty = default text.
images array of string

The first is the cover.
currency string

Currency code, like EUR.
compare_at_price string kann null sein

Decimal string, like "19.90". Crossed-out old price.
intro_price string kann null sein

Decimal string, like "19.90". Subscription: price of the first period.
installment_plans array of object

Payment plans that buyers can choose.
2 Felder anzeigen Felder ausblenden
- count integer
  
  Number of payments.
- amount string
  
  Decimal string, like "19.90". Per payment.
limited_offer object kann null sein

A lower price for a time. null = none.
5 Felder anzeigen Felder ausblenden
- price string kann null sein
  
  Decimal string, like "19.90".
- starts_at string<date-time> kann null sein
  
  UTC, like 2026-01-31T14:05:00Z.
- ends_at string<date-time> kann null sein
  
  UTC, like 2026-01-31T14:05:00Z.
- running boolean
  
  true = the offer price applies now.
- countdown object kann null sein
  
  Countdown to the end of the offer. null = none.
  4 Felder anzeigen Felder ausblenden
  
  style string
  
  classic, classic_sticky, slim, slim_sticky, card_classic, card_slim or card_special_1.
  
  text string kann null sein
  
  The text.
  
  color string
  
  Background color, hex.
  
  secondary_color string kann null sein
  
  Text or card color, hex.
variants array of object

Options that buyers choose at checkout.
7 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string
  
  The name.
- price string kann null sein
  
  Decimal string, like "19.90".
- stock_limit integer kann null sein
  
  null = no limit.
- course object kann fehlen kann null sein
  
  course products only.
  2 Felder anzeigen Felder ausblenden
  
  id integer
  
  The ID.
  
  name string
  
  The name.
- course_id integer kann fehlen kann null sein
  
  course products only.
- content array of object kann fehlen
  
  download products only.
  Eine dieser Varianten:
  
  type: text · 3 Felder
  
  Formatted text.
  
  type string
  
  The block type.
  
  Mögliche Werte: text
  
  html string
  
  The text as HTML.
  
  folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
  
  type: image, video · 6 Felder
  
  An uploaded image or video.
  
  type string
  
  The block type.
  
  Mögliche Werte: imagevideo
  
  file_id integer
  
  The file ID (from upload_file).
  
  name string
  
  The name.
  
  file_type string
  
  File extension, like pdf.
  
  size_bytes integer kann null sein
  
  File size in bytes.
  
  folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
  
  type: audio, file · 7 Felder
  
  An audio player or a download.
  
  type string
  
  The block type.
  
  Mögliche Werte: audiofile
  
  file_id integer
  
  The file ID (from upload_file).
  
  name string
  
  The name.
  
  description string
  
  file: text under the download. audio: title above the player.
  
  file_type string
  
  File extension, like pdf.
  
  size_bytes integer kann null sein
  
  File size in bytes.
  
  folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
  
  type: video_embed · 3 Felder
  
  type string
  
  The block type.
  
  Mögliche Werte: video_embed
  
  url string
  
  YouTube, Vimeo or Loom link.
  
  folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
  
  type: button · 4 Felder
  
  A link button.
  
  type string
  
  The block type.
  
  Mögliche Werte: button
  
  label string
  
  The text that buyers see.
  
  url string
  
  The link.
  
  folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
content array of object

download, link and booking: what buyers get, in order.
Eine dieser Varianten:
type: text · 3 Felder
Formatted text.
- type string
  
  The block type.
  
  Mögliche Werte: text
- html string
  
  The text as HTML.
- folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
type: image, video · 6 Felder
An uploaded image or video.
- type string
  
  The block type.
  
  Mögliche Werte: imagevideo
- file_id integer
  
  The file ID (from upload_file).
- name string
  
  The name.
- file_type string
  
  File extension, like pdf.
- size_bytes integer kann null sein
  
  File size in bytes.
- folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
type: audio, file · 7 Felder
An audio player or a download.
- type string
  
  The block type.
  
  Mögliche Werte: audiofile
- file_id integer
  
  The file ID (from upload_file).
- name string
  
  The name.
- description string
  
  file: text under the download. audio: title above the player.
- file_type string
  
  File extension, like pdf.
- size_bytes integer kann null sein
  
  File size in bytes.
- folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
type: video_embed · 3 Felder
- type string
  
  The block type.
  
  Mögliche Werte: video_embed
- url string
  
  YouTube, Vimeo or Loom link.
- folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
type: button · 4 Felder
A link button.
- type string
  
  The block type.
  
  Mögliche Werte: button
- label string
  
  The text that buyers see.
- url string
  
  The link.
- folder string kann null sein
  
  Folder name. Blocks with the same folder show together.
course object kann null sein

The course that buyers get.
2 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string
  
  The name.
bundle_items array of object

bundle products only.
4 Felder anzeigen Felder ausblenden
- product_id integer
  
  The product ID.
- variant_id integer kann null sein
  
  The variant ID, if any.
- name string
  
  The name.
- variant string kann null sein
  
  The variant name, if any.
custom_fields array of object

Extra fields at checkout.
3 Felder anzeigen Felder ausblenden
- label string
  
  The text that buyers see.
- type string
  
  The type.
- required boolean
  
  true = buyers must fill it.
stock_limit integer kann null sein

null = no limit.
available_from string<date> kann null sein

Like 2026-01-31.
available_until string<date> kann null sein

Like 2026-01-31.
access_days integer kann null sein

Access ends this many days after purchase. null = no end.
access_starts_on string<date> kann null sein

Like 2026-01-31. Buyers get access from this day at the earliest.
lead_magnet boolean

true = a free product that grows the e-mail list.
withdrawal_days integer

Withdrawal period shown at checkout, in days.
url_slug string kann null sein

The address part of the URL.
marketing_emails boolean

true = buyers are subscribed to the marketing e-mails.
ebook boolean

true = taxed as an e-publication.
pdf_stamp boolean

true = PDFs are stamped with the buyer's e-mail address.
login_protection boolean

true = buyers must log in to open the product.
show_in_search boolean

true = search engines can show the sales page.
coupon_field boolean

true = checkout shows the coupon field.
external_url string kann fehlen

external products only.
course_id integer kann fehlen kann null sein

course products only.