The tools

Tool	Use it to	Charged for
capabilities	read vocabularies, band boundaries, limits, disclosure rules and the corpus date	free
usage	see balance, remaining coverage (as a range), limits, and how many projects are revealed and profile parts held	free
guide	read this guide in full	free
send_feedback	tell the Megido team about a bug, wrong or missing data, or something you need	free, within a daily limit
search_cohorts	find niches by words or by niche conditions: size, level, median index, share of growing members, leading country	base + first-seen niches
get_cohort	open one niche: distributions, hierarchy (parent, children, neighbors), a stable sample of members	base + first-seen niches and sample members
search_projects	find projects by an idea, by similarity to projects you hold, or by conditions on quality axes, scale, growth, country, type and niche	base + first-seen projects
get_project_card	open projects: index with an explanation of each axis, niches at every level, nearest neighbors	base + first-seen niches and neighbors
lookup_domain	check whether domains you already have are in the corpus	base per distinct domain
reveal_project	turn project ids into domains with year founded, team size and payment service	base + reveal per new project
get_audience	visits, uniques, engagement, devices, top countries and their changes	base + audience part per new project + exact surcharge
get_channels	traffic sources and social platforms	base + channels part per new project + exact surcharge
get_keywords	branded split, top organic queries, paid queries	base + keywords part per new project + exact surcharge

Notes that change results or cost:

• Unknown filter values are rejected with the nearest accepted values. Take values from capabilities rather than guessing.
• Text and seeds return the closest matches in meaning. Sorting then reorders only the closest results, relevance_pool projects in search_projects and relevance_pool_cohorts niches in search_cohorts (see capabilities); it does not search the whole corpus by that field. To rank a whole niche, filter by the niche instead of describing it in words.
• Set limit. Without it a call returns as many rows as your list limit allows, and every new row costs the first-seen price.
• Ask only for the parts you need. get_cohort takes parts (distributions, sample, hierarchy) and get_project_card takes parts (description, index, cohorts, neighbours); without parts both return every part. Distributions of a niche and the index of a project cost only the base price. The sample and hierarchy of a niche, and the niches and neighbors of a project, show new projects and niches, and each of them costs the first-seen price.
• lookup_domain strips a scheme, a path, a leading www and a trailing dot; other subdomains usually miss. A hit reveals the project by its domain without the reveal price (see "Anonymous and revealed"), but the payment service, year founded and team size come only from reveal_project, at the reveal price.
• Batches. Card, lookup, reveal and the three profile tools take several ids or domains per call, up to the batch limit in capabilities.