Start Research
start_researchStarts a niche research from a short search phrase or a plain-language description of an app or service idea. A phrase is scanned directly (demand, sub-topics, competitors, signals); a description is first turned into real search queries, the best one is then scanned automatically. Demand is measured in one country and one language: country and language when given, otherwise the country and the language of the phrase (English: United States, Spanish: Spain, Portuguese: Brazil); write the phrase in the language people search in there. country and language of the answer tell how the numbers were measured. Returns the research id to poll with get_research. Counts as one research of the plan allowance, whether the data comes from the sources or from the shared cache.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deep | No | Deeper scan with more sub-topics and competitor checks. Available on plans that include it (Pro) and to administrators; counted as two researches. | |
| text | Yes | Search phrase (e.g. "expense tracker") or a description of the idea in your own words, up to 400 characters. | |
| locale | No | Language of the conclusions and the final report. Defaults to the interface language of the account. Texts meant for the site and the stores are always written in the language of the market. | |
| country | No | Country to measure demand in, as an ISO 3166-1 alpha-2 code (BR, MX, PT, AR, CO, US, GB, DE, KZ, RU, BY…). App Store apps are looked up in the same country, the report writes prices, channels and copy for it, and sub-topics are measured there too. Omit it to use the country of the phrase's language. The phrase is measured in its own language when the country has it (Spanish in the United States), otherwise in the country's main language, so write it the way people search in that country. | |
| language | No | Language the demand is measured in, when the guess from the phrase is not enough: French in Canada (CA + fr), Italian in Switzerland (CH + it), Spanish in the United States (US + es). It must be one of the languages of `country`; given without `country` it picks the main country of the language (pt: Brazil, nl: Netherlands). Omit it to use the language of the phrase. |