Skip to main content
A seller account can read three counts about its Product marketing in one call: how many selling points are teaching the agent, how many of them your live inventory does not back, and when a result last changed. It is opt-in. A get of the seller that does not ask for it returns exactly what it returned before.

Read it

Call get with kind: "seller", no id, and include: ["teaching"]:
The include belongs to the seller account that is reading itself. It is refused on any other kind, on a seller read that names an id, and for a buyer account. lastVerdictChangeAt is a change time, not a check time. It moves only when a result changes, so it says when something last changed and nothing about how recently the counts were checked. Opening Product marketing checks every selling point against your current inventory and shows its own checked-at time. The counts here are the results on record, so they can lag what that page shows. The counts cover your whole account. To read individual selling points, use the Product marketing page.

Who can read it

Product marketing is not on for every seller yet. A seller outside the Product marketing cohort gets ACCESS_DENIED, never a count of zero, because “you have taught the agent nothing” and “this is not on for you” are different answers.

When a read fails

A refusal is an error and returns none of the seller. A read that fails is different: the call still succeeds. It leaves teaching out and names it in unavailableIncludes with a one-sentence reason. Ask again for teaching. See Sellers on the V3 tool surface. There is no “unknown” value and no partial answer: you get the counts, a refusal, or teaching listed as unavailable.