Finds keyword ideas for one to five seed terms. On labs, each idea contains its seed term. Every idea carries seed, the seed term it came from (null for a multi-seed google_ads run). Each call makes 1 request per seed term to the keyword provider (google_ads: 1 request in total), returning up to limit ideas in total.
Every idea has search volume, CPC and competition. labs (the default) adds difficulty and intent; google_ads, for countries labs does not cover, has neither. A SERP overview per idea comes only with includeSerpInfo, on labs.
With google_ads, close variants come back as one row listing them in closeVariants; its volume is the group's, so count it once.
Results are not saved until you call save_keywords. If this refuses because the workspace is not set up, call get_setup_status and check its rows, including skipped ones.
Related: check_keyword_audience, save_keywords, set_up_market.