find_listing
Turn an extension's NAME into the store id every other tool asks for.
Start here whenever you were handed a name rather than an id or a store URL, which is what a person will normally give you. Matching is approximate: case, punctuation, word order and a missing word are all tolerated, so "image search anywhere" finds "Reverse Image Search Anywhere".
This reads names already stored here. It is not a store search and reports no ranking -- for where an extension actually places on a term, use search_store. It starts no fetch, so it never returns "pending" and spends none of the store-egress budget; like every call here it is logged and counts against the rate limit.
Every match carries cached. true means get_store_listing can serve
that extension's page from cache right now, with no account.
false says one thing only: this locale has no fresh guest-readable cache. For a guest that is a refusal. Signed in, the next call may answer "pending" while it fetches, or hand back older data marked stale while it refreshes, or report a recent fetch failure with no listing at all -- so read the status you get rather than assuming which of those it will be.
cached is a promise about ONE locale -- the one you pass here, "en" by
default -- because a Chrome listing read in German needs two fetches,
English structure plus German copy. Ask with the locale you intend to
read in, or the answer is about a different call than the one you make.
Two extensions can share a name, so matches carry publisher to tell
them apart when the store recorded one.
A name too long to match in full is refused rather than trimmed, because trimming would report the words it dropped as matched.
No match means this app has never seen that name -- guessing another spelling will not help. Use search_store if what you have is really a search phrase; otherwise ask the person you are working for for the extension's store URL or id, and pass that to get_store_listing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The extension's name as you were given it, e.g. "Reverse Image Search Anywhere". | |
| limit | No | Most matches to return, best first. Defaults to 10. | |
| store | No | Restrict to one store. Both are searched when omitted. | |
| locale | No | Which locale `cached` should answer for. Defaults to "en". Does not change which names match. |