Skip to main content
Search Landbase’s database using a natural language query. Returns a run_id, session_id, dataset_id, and a content field with your results. Submit a natural language search query for companies and contacts. Usage 
landbase-cli search <query> [flags]
​
query
string
required
Natural language prompt describing the companies or people you want to find.
Flags
FlagDefaultDescription
--download[=<path>]./results.jsonlWrite results to a file. Supports .jsonl, .jsonl.gz, .csv, .parquet
--session=<label>—Continue a prior conversation with a follow-up prompt. Accepts a session label or session ID
--agent=<name>fast_dataset_creatorSelect the search agent. Use advanced_dataset_creator for custom SQL, aggregations, exact filters, and custom output columns
--format=<format>jsonOutput format: json or table
--limit=<n>—Maximum number of results to return
--no-update-check—Skip the daily update check
--verbose—Print request/response details to stderr

​
Advanced Dataset Creator

The default search agent is fast_dataset_creator, which is the fastest path for everyday natural-language audience builds. Use advanced_dataset_creator when the audience needs custom logic that is hard to express as fixed filters, such as custom SQL, aggregations, exact filtering, ratios, or output columns. Advanced Dataset Creator uses a two-step confirmation flow:
  1. Send the request with --agent=advanced_dataset_creator and a --session=<label>.
  2. Review the proposed query in the response.
  3. Confirm in the same session with a follow-up such as "yes, run it".
Examples 
# Find companies
landbase-cli search "find B2B SaaS companies in San Francisco"

# Save results to a file
landbase-cli search "find B2B SaaS companies in San Francisco" --download=results.jsonl

# Follow-up in the same session
landbase-cli search "only show ones with 50+ employees" --session=sf-saas

# Limit results and format as table
landbase-cli search "find AI engineers in London" --limit=20 --format=table

# Use Advanced Dataset Creator for a precise custom query
landbase-cli search --agent=advanced_dataset_creator --session=sales-ratio \
  "Find companies where the AE-to-SDR ratio is between 1.5 and 3.0. Return company name, website, AE count, SDR count, and ratio."
landbase-cli search --agent=advanced_dataset_creator --session=sales-ratio "yes, run it" --download=sales-ratio.jsonl

# Use Advanced Dataset Creator for aggregations
landbase-cli search --agent=advanced_dataset_creator --session=state-counts \
  "How many companies are in each US state, sorted by count? Return the top 10."
landbase-cli search --agent=advanced_dataset_creator --session=state-counts "yes, run it"