Research
Research Market
Research an Amazon market that is not in the Launch Fast catalog, or refresh a market with old data.
| Field | Value |
|---|---|
| MCP tool | research_ |
| Behavior | Starts research work. It does not change your Amazon account. |
| Cost | 1 credit. Free when the market has fresh data, or when the same research runs at that time. |
| Permission | Research and insights (Launch Fast tools) |
| Amazon connection | Not necessary |
| App view | ui://launchfast/v2/market |
What It Does
research_market starts research on one Amazon market. It does one of three things:
- If you give a phrase for a market that is not in the catalog, it researches a new market.
- If you give the slug of a market that you can see, it refreshes the data of that market.
- If you give a phrase for a market that is already in the catalog, it opens that market. It also refreshes the data when the last research or refresh is more than 7 days old.
A new market takes 4 to 9 minutes. The tool waits up to 40 seconds. If the research does not finish in that time, the answer gives a job id. The assistant then checks the job with get_job.
When To Use It
Use research_market only when find_markets finds no market, or when the market data is too old. To read a market that is in the catalog, use get_market. It is free.
Inputs
| Input | Required | Values | Example |
|---|---|---|---|
market | Yes | A phrase for a new market, or the slug of a market to refresh. 2 to 120 characters. | silicone spatula |
What The Answer Contains
- When the research finishes in 40 seconds, the answer is the market brief. It is the same brief that
get_marketgives. - A notice says if the call spent 1 credit, or if it was free because you joined a research of this market that was already running.
- When the research takes longer, the answer shows that the job runs, how long it takes as usual, and the job id. The next call is
get_jobwith that job id, about 60 seconds later. If you joined a research of this market that someone else started, the answer says to callresearch_marketagain instead. - When the market has fresh data, the answer is the brief, free of charge. For a slug, it also gives the date of the data and the first date for a new refresh.
- When a phrase names a market that is in the catalog but the refresh cannot start, for example because you have no credits left, the answer is still the brief. A notice says the data may be out of date.
- If the research fails, the answer shows the failed job.
Limits
| Limit | Value |
|---|---|
| New market researches that run at the same time (ones you started or joined) | 3 |
| Market runs in 24 hours (new markets and refreshes together) | 30 |
| Refresh of one market | One time in 7 days |
| Marketplace | Amazon US |
App View
When the research finishes and your AI app supports MCP Apps, it shows the result in this view. The image shows example data.
Example Prompts
Launch Fast has no market for bamboo cutting boards. Research it.The silicone spatulas data looks old. Refresh that market.Common Errors
| Error | What it means | What to do |
|---|---|---|
credit_ | You used all your credits for this billing period. | See credits used and left on the usage page. Catalog reads stay free. |
daily_ | You started 30 market runs (new markets and refreshes) in the last 24 hours. | Start more tomorrow. Reads of catalog markets are free now. |
cap_ | 3 new market researches that you started or joined run at this time. | Wait for one to finish. To see your jobs, use get_ with no job id. |
plan_ | Your plan does not include market research. | Check your plan on the usage page. |
invalid_ | The market value is shorter than 2 or longer than 120 characters, or has no words. | Give a phrase such as silicone spatula, or a market slug. |
upstream_ | Launch Fast could not complete the request, or market research is not available at this time. | Try the same call again in a minute. |
Related Tools
get_jobchecks a research that takes more than 40 seconds.get_marketreads the market when the research finishes.find_marketssearches the catalog first.