One workspace per client, or one shared
Credits, the monthly budget, keys, saved topics and the record of what was bought belong to a workspace. Choose by what has to be separate:
The starting credit of $5 is given once for each person. A person adds credit to each workspace, on its Billing page.
The free slot, credits and tracking
trackwithownmakes a business the workspace’s brand. Only for the person’s own business, after asking; never for a client or a rival. The first brand is free, and Parse pays for its first 20 buyer questions.- A second brand of your own is not tracked free: one brand per workspace is. Daily tracking of a brand from credits is a person’s switch on the brand’s row on Billing; an assistant never turns it on.
trackwatches any brand, topic or page for free, whoever owns it, and asks questions you name for $0.01 a check. A check is one question asked once on one AI engine or search surface from one place. A question asked daily on both counted engines is 1 question × 2 engines × 30 days = 60 checks, $0.60 a month. This is how an agency follows a client’s brand it does not own. The questions it asks are paid within the workspace’s monthly budget.- A lookup of a prospect with
resolve_idsand the other public tools creates and tracks nothing.
Compare brands
- One client’s brief:
get_briefwithbrandset to the client’sbrd_id scopes the brief to it, asks nobody which brand is theirs, and claims nothing. The event log,get_briefwithview: "events", takesbrandtoo, andsinceanduntildays, because the workspace holds other clients’ events. - Which of my brands moved most:
get_briefwithmoves: true, free. Every brand the workspace has, its own and those it watches, in its own topics, this week against the week before on matched questions. Significant moves first, then by size. A row saysno_move,not_measuredorno_topicswhen there is nothing to rank. - These four against each other:
query_metricswithby: ["brand"]andbrands, two to 25 ids, so the brands are read in the same answers. - Who leads a market: the
concentrationmeasure gives the share of answers naming the top 1, 3 and 5 brands. - Read Reading the numbers before quoting a difference to a client.
Exports and scope
exportwrites rows to a file for a client report. It needs a first card top-up and a scope: a brand, market, topic, question, page, site or subject, orfilter.scopeofownortracked.- Rows inside the workspace’s own scope (its saved, claimed and tracked brands, the markets they are in, the questions and topics it tracks, its own answers) are free, up to 1,000,000 rows a month. Rows outside it cost $0.01 a row past the free ones, quoted before the file is written.
- An assistant without a fetch tool reads the file with
read_itemand itsexp_id, page by page, free. - A file carries ids, judgments, counts, snippets and the question’s wording, never full texts or contact routes. Do not resell the rows; see What the data is for.
Local businesses: places
A business with several locations is one brand with its locations under it. Each location has its own area and numbers, and they roll up to the brand.- Place ids.
resolve_idswithkinds: ["place"]turns “Austin, TX” into aplc_id, with its level and its parent. A local brand’s row lists its locations and area. An assistant never sees a location code. filter.placeis the place a question is about:plc_ids, and the places under each (a region holds its cities)."all"reads every place.filter.countryis where a question was asked from: ISO country codes. An answer asked with no place set counts as US. Useby: ["place"]orby: ["country"]to cut by either.- A local brand’s default.
query_metricswith a local subject and no place reads the brand’s area: each location’s area, one place at a time, as the app reads it.context.scopenames the places with their ids. - The listing measure.
listing_shareis, of the answers that list local businesses (a numbered list or place cards), the share whose list includes the brand, and its mean rank there. A business no extracted mention names links to no brand, so the share can read low, never high;unlinkedsays how many. - Not measured here yet. A
filter.placethat matches no stored answer returnsdata.placeCoveragewithstatus: "not_measured_here_yet", how many answers the same filter holds one level up, and anextcall that asks the question from that place. That ask is paid and the call says so. A zero is never printed for a place with no data. - Asking from a place.
ask_ai_enginestakesplaces: up to five country codes or place names, as someone there would ask. A surface that takes no place is asked once.tracktakesplaces(up to five) andlanguage: each place is its own tracked question, priced as one, and the quote shows the monthly cost per place and in all. A baseline by place is not built yet.