Teachers Pay Teachers API and MCP server

• POST

  list_products

  Your product listings with title, type, price, status and custom category.

  read

  Lists your listings with title, type, price, status and custom category. Filter by status, type or custom category to find a group of products. Pages hold up to 100 products; pass next_cursor back as cursor for the next page.

  POST /api/v1/teachers-pay-teachers/list_products

  Input

  Input: list_products

  Parameter	Type	Description
  status	enum	active, inactive or all. Default: all.
  type	enum	digital_download, bundle, video, google_resource or all. Default: all.
  custom_category	string	Only products in this store custom category.
  limit	integer	1 to 100. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "products": [
      {
        "product_id": "11204567",
        "title": "Fraction Task Cards, Grades 3-4",
        "type": "digital_download",
        "price_cents": 600,
        "status": "active",
        "custom_category": "Fractions"
      },
      {
        "product_id": "9873310",
        "title": "Fractions Bundle",
        "type": "bundle",
        "price_cents": 900,
        "status": "active",
        "custom_category": "Fractions"
      }
    ],
    "next_cursor": null
  }

• POST

  get_product

  Full listing: title, description, price, additional license price, grades, subjects, tags, formats and files.

  read

  Returns one listing in full: description, price, additional license price, grades, subjects, tags, formats and files. Use it before answering a buyer question or rewriting a title, so your agent works from the real listing.

  POST /api/v1/teachers-pay-teachers/get_product

  Input

  Input: get_product

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.

  Example response

  {
    "product_id": "11204567",
    "title": "Fraction Task Cards, Grades 3-4",
    "description": "20 printable task cards on comparing and adding fractions, with answer keys.",
    "price_cents": 600,
    "additional_license_price_cents": 300,
    "grades": [
      "3rd",
      "4th"
    ],
    "subjects": [
      "Fractions"
    ],
    "tags": [
      "Task Cards"
    ],
    "formats": [
      "PDF"
    ],
    "status": "active"
  }

• POST

  get_store_stats

  Seller Dashboard totals: earnings, units sold, carts, unique buyers, views and conversions.

  read

  Returns the Seller Dashboard totals for a period: earnings, units sold, carts, unique buyers, views and conversions. Set buyer_type to compare first-time and repeat buyers, or product_ids to look at part of the store. Earnings are in US cents.

  POST /api/v1/teachers-pay-teachers/get_store_stats

  Input

  Input: get_store_stats

  Parameter	Type	Description
  from required	date	First day of the period.
  to required	date	Last day of the period.
  buyer_type	enum	all, first_time or repeat. Default: all.
  product_ids	string[]	Only these products. Default: whole store.

  Example response

  {
    "from": "2026-10-05",
    "to": "2026-10-11",
    "buyer_type": "all",
    "earnings_cents": 41235,
    "units_sold": 74,
    "carts": 91,
    "unique_buyers": 58,
    "views": 3120,
    "conversion": 0.024
  }

• POST

  get_product_stats

  Per product: earnings, units sold, views, conversion, Wish Listed and Saved for Later.

  read

  Returns the numbers of one product for a period: earnings, units sold, views, conversion, Wish Listed and Saved for Later. Call it for each product from list_products to rank them.

  POST /api/v1/teachers-pay-teachers/get_product_stats

  Input

  Input: get_product_stats

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  from required	date	First day of the period.
  to required	date	Last day of the period.

  Example response

  {
    "product_id": "11204567",
    "from": "2026-10-05",
    "to": "2026-10-11",
    "earnings_cents": 7200,
    "units_sold": 12,
    "views": 410,
    "conversion": 0.029,
    "wish_listed": 5,
    "saved_for_later": 9
  }

• POST

  list_sales

  Sales Details from your Sales Reports, one line per item sold, with earnings and sales tax.

  read

  Returns Sales Details from your Sales Reports, one line per item sold, with earnings and sales tax. Filter by product to see the sales of one listing. Pass next_cursor back as cursor for the next page.

  POST /api/v1/teachers-pay-teachers/list_sales

  Input

  Input: list_sales

  Parameter	Type	Description
  from required	date	First day of the period.
  to required	date	Last day of the period.
  product_id	string	Only sales of this product.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "sales": [
      {
        "date": "2026-10-09",
        "product_id": "11204567",
        "title": "Fraction Task Cards, Grades 3-4",
        "earnings_cents": 510,
        "sales_tax_cents": 0
      },
      {
        "date": "2026-10-09",
        "product_id": "9873310",
        "title": "Fractions Bundle",
        "earnings_cents": 765,
        "sales_tax_cents": 0
      }
    ],
    "next_cursor": null
  }

• POST

  get_search_keywords

  Search Analytics: TPT search keywords that led buyers to your products, with visits, conversions and earnings.

  read

  Returns the TPT search keywords that led buyers to your products, with visits, conversions and earnings. Search Analytics starts on 1 Jan 2025. Pass product_id to see the keywords of one listing.

  POST /api/v1/teachers-pay-teachers/get_search_keywords

  Input

  Input: get_search_keywords

  Parameter	Type	Description
  from required	date	First day of the period, 1 Jan 2025 or later.
  to required	date	Last day of the period.
  product_id	string	One product only. Default: whole store.

  Example response

  {
    "keywords": [
      {
        "keyword": "fraction task cards",
        "visits": 214,
        "conversions": 9,
        "earnings_cents": 5400
      },
      {
        "keyword": "fractions 4th grade",
        "visits": 167,
        "conversions": 6,
        "earnings_cents": 3600
      }
    ]
  }

• POST

  list_buyer_questions

  Questions from the Q&A section of your store, newest first, with product and any answer.

  read

  Lists questions from the Q&A section of your store, newest first, each with its product and any answer you already gave. Set unanswered_only to see what needs a reply. Pass question_id to answer_buyer_question.

  POST /api/v1/teachers-pay-teachers/list_buyer_questions

  Input

  Input: list_buyer_questions

  Parameter	Type	Description
  unanswered_only	boolean	Skip questions you already answered. Default: false.
  limit	integer	1 to 100. Default: 50.

  Example response

  {
    "questions": [
      {
        "question_id": "q_5821",
        "product_id": "11204567",
        "question": "Does this include answer keys?",
        "asked_at": "2026-10-10T14:20:00Z",
        "answer": null
      }
    ]
  }

• POST

  create_product

  New Digital Download listing from a file. Inactive by default; an active listing is live for buyers right away.

  asks first write

  Creates a Digital Download listing from the URL of a PDF or ZIP. The listing is inactive unless active is true, and an active listing is live for buyers right away. Price is in US cents. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/create_product

  Input

  Input: create_product

  Parameter	Type	Description
  title required	string	Product title.
  description required	string	Product description.
  file_url required	string	URL of the PDF or ZIP buyers download.
  price_cents required	integer	Price in US cents, e.g. 600 for $6. 0 for a free resource.
  grades required	string[]	TPT grade levels, e.g. "1st", "2nd".
  subjects required	string[]	TPT subjects, e.g. "Fractions".
  tags	string[]	Resource type tags, e.g. "Centers".
  preview_url	string	URL of a PDF preview.
  active	boolean	Make Listing Active now. Default: false.

  Example response

  {
    "product_id": "11310482",
    "title": "Fall Math Centers, Grades 1-2",
    "status": "inactive",
    "price_cents": 600,
    "grades": [
      "1st",
      "2nd"
    ],
    "subjects": [
      "Math"
    ]
  }

• POST

  update_product

  Change title, description, price, additional license price, grades, subjects or tags of a listing.

  asks first write

  Changes the fields you pass and leaves the rest. Price changes show to buyers right away on an active listing. Price is in US cents. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/update_product

  Input

  Input: update_product

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  fields required	object	Any of title, description, price_cents, additional_license_price_cents, grades, subjects, tags.

  Example response

  {
    "product_id": "11204567",
    "status": "updated",
    "changed": {
      "price_cents": {
        "from": 600,
        "to": 700
      }
    }
  }

• POST

  set_product_status

  Make a listing active or inactive. Past buyers keep their downloads.

  asks first write

  Makes a listing active (for sale) or inactive (hidden). Past buyers keep their downloads. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/set_product_status

  Input

  Input: set_product_status

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  active required	boolean	true to sell it, false to hide it.

  Example response

  {
    "product_id": "11310482",
    "active": true,
    "status": "active"
  }

• POST

  upload_revised_file

  Replace the product file and optionally notify past buyers with a note on what changed.

  asks first write

  Replaces the file buyers download. With notify_buyers set, past buyers are notified on their My Purchases page, and change_note tells them what changed. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/upload_revised_file

  Input

  Input: upload_revised_file

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  file_url required	string	URL of the new PDF or ZIP.
  notify_buyers	boolean	Notify Buyers on their My Purchases page. Default: false.
  change_note	string	What changed, shown to buyers when notified.

  Example response

  {
    "product_id": "11204567",
    "status": "file_replaced",
    "buyers_notified": true
  }

• POST

  answer_buyer_question

  Post a public answer to a question on your product page.

  asks first write

  Posts an answer to one buyer question. The answer is public and appears under your store name. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/answer_buyer_question

  Input

  Input: answer_buyer_question

  Parameter	Type	Description
  question_id required	string	Question ID from list_buyer_questions.
  answer required	string	Answer text, shown publicly under your store name.

  Example response

  {
    "question_id": "q_5821",
    "status": "published"
  }

• POST

  schedule_sale

  Throw a sale on chosen products or your whole store for set dates.

  asks first write

  Schedules a sale of 5, 10, 15 or 20 percent off between a start and an end date. Leave product_ids empty to put the whole store on sale. Buyers see the lower prices during the sale. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/schedule_sale

  Input

  Input: schedule_sale

  Parameter	Type	Description
  discount required	enum	5, 10, 15 or 20 (percent off).
  start_date required	date	First day of the sale.
  end_date required	date	Last day of the sale.
  product_ids	string[]	Products on sale. Empty: whole store.

  Example response

  {
    "sale_id": "sale_48213",
    "status": "scheduled",
    "discount": 20,
    "start_date": "2026-10-16",
    "end_date": "2026-10-18",
    "products": 3
  }

• POST

  send_note_to_followers

  Weekly Note to Followers about new products or promotions, sent now or on a set date.

  asks first write

  Sends a Note to Followers about new products or promotions, now or on the date you set. Images go in the body by URL. The note reaches everyone who follows your store. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/teachers-pay-teachers/send_note_to_followers

  Input

  Input: send_note_to_followers

  Parameter	Type	Description
  body required	string	Note text. Images by URL.
  send_on	date	Send date. Default: now.

  Example response

  {
    "note_id": "note_3307",
    "status": "sent",
    "sent_on": "2026-10-12"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.