ProfitTree

Read one of the shop's own listings over a window. This is the seller's own sales and profit for the listing. For a listing on Etsy's public market, whoever owns it, use `listing_detail`.

listing_report

Read one of the shop's own products as a series over a window.

product_timeseries_report

Read one of the shop's own products over a window. `product_id` is a product in this shop; call `products_report` to find one.

product_report

List the shop's own orders over a window. Defaults to the order the seller's own orders page shows.

orders_report

Report this connection's ProfitTree plan, its AI-credit allowance, and what is spent. Every tool call but this one and `connected_shops` costs `credit_cost_per_call` credits from the weekly allowance this account shares with Rupert's own chat. `credits_included` is what the plan includes a week and `credits_used` is what is spent of it, so the credits remaining are `credits_included - credits_used`; they all reset at `credits_reset_at`. A call that fails costs nothing: its credits are given back. While `unlimited` is true, tool calls cost this account nothing at all and `promo_ends_on` is the last day that holds. The allowance is still reported, because it is the same one the account's Rupert chat keeps spending. `rate_ceiling` is the calls this connection may make in one minute and `calls_this_minute` is what it has spent of that. Every tool but this one counts against it, including `connected_shops`. `counting` is false when call counting is unavailable, and `calls_this_minute` is then absent — the ceiling is not being enforced rather than at zero. Calling this tool is free and counts against neither allowance, so call it to check what is left before starting a long sequence of calls.

usage

List the shop's own products over a window, with each product's sales and profit. Defaults to the order the seller's own products page shows.

products_report

Read the shop's own metrics as a series over a window.

shop_timeseries_report

Read the shop's own profit and loss over a window: revenue, costs, fees and margin. `shop_id` must be a shop connected to this account; call `connected_shops` for the ids, as any other id answers not-found.

profit_tracking_report

List the Etsy shops connected to this ProfitTree account — call this first. Every other owner tool takes a `shop_id`, and a shop id is not something that can be guessed. Each row carries the shop's currency, which denominates every money figure those tools answer with, and the day its reports were last pulled: a window that runs past that day is answered from data never fetched, not from a drop in sales. This is the seller's own connected shops, not a search of Etsy — use `shop_finder` for that. `shop_id` narrows the answer to one shop, for re-reading a row without listing the account again. A shop the seller does not own is simply not among their shops, so it answers an empty list rather than a refusal — the same reason the other owner tools answer not-found. This tool is free: it costs no AI credits, because every other owner tool depends on it.

connected_shops

List the seller's tracking collections, or read one collection's tracked metrics. With no `collection_id`, returns the seller's collections of that `kind` — call this first, since a collection id is not something that can be guessed. With one, returns that collection's listing, shop or keyword metrics, again decided by `kind`. `days` is the metrics window in whole UTC days, ending tonight, compared against the same length immediately before it. It does not apply to keyword metrics, which are the market's monthly averages.

tracking