Quick Answer
Install the Realie CLI with curl -fsSL https://app.realie.ai/api/cli/install | bash (Node.js 18 or later). Sign in with realie login (it opens a browser), or realie login --api-key YOUR_API_KEY for agents and CI, then run realie lookup --address "504 LAVACA ST" --state TX --county TRAVIS --json. Every command accepts --json, and each property command mirrors a REST endpoint.
Get an API keySummary
The Realie CLI is a first-party command-line client for the Realie property data API, built for developers and AI coding agents such as Claude Code, Cursor, and Copilot. Its property commands are generated from the same parameter catalog as the MCP server, so flags map one-to-one to REST query parameters, and calls use the same API plan as REST and MCP. Each result is the county-sourced record with parcel, assessor, and recorder fields that the API returns across all 50 states and 180M+ addresses.
Step by step
- 1
Install the CLI
Run curl -fsSL https://app.realie.ai/api/cli/install | bash. The installer puts a single-file bundle in ~/.realie/bin/ and adds it to your PATH. It requires Node.js 18 or later.
- 2
Sign in
For agents, scripts, and CI, run realie login --api-key YOUR_API_KEY or set the REALIE_API_KEY environment variable. In an interactive terminal, realie login opens a browser sign-in and then stores your existing API key. New accounts add a payment method in Billing before property calls succeed.
- 3
Look up a property
Run realie lookup --address "504 LAVACA ST" --state TX --county TRAVIS --json. The --json flag prints the raw JSON response, in the same shape as a REST call.
- 4
Check your usage
Run realie usage to see usage for the current billing period, or realie whoami to confirm the signed-in user and plan.
Which property commands does the Realie CLI include?
Each property command mirrors one REST endpoint, with kebab-case flags for the API’s query parameters (for example, --zip-code maps to zipCode). Search and location return up to 100 properties per page, set with --limit. Comparables also accepts filters such as --time-frame, --beds-min, --beds-max, --price-min, and --price-max.
| Command | What it does | REST endpoint |
|---|---|---|
| realie lookup --address "504 LAVACA ST" --state TX --county TRAVIS | Looks up one property by street address | GET /api/public/property/address |
| realie search --state TX --county DENTON --limit 10 | Searches properties with the full search filter set, such as city, ZIP code, and address | GET /api/public/property/search |
| realie parcel --parcel-id "R12345" --state TX --county TRAVIS | Looks up a property by assessor parcel ID | GET /api/public/property/parcelId |
| realie location --latitude 30.2672 --longitude -97.7431 --radius 0.05 --limit 10 | Finds properties near a point | GET /api/public/property/location |
| realie comparables --latitude 30.2672 --longitude -97.7431 --time-frame 12 | Finds comparable properties near a location | GET /api/public/premium/comparables |
How do AI coding agents use the Realie CLI?
Tell the agent to pass --json. With it, every command prints the raw JSON response body, the same shape as a direct API call; without it, output is formatted for people. Errors print as JSON with an error message and a code, and the command exits with code 1, so an agent can branch on the failure instead of parsing text.
For Claude Code, add a short note to CLAUDE.md or your agent instructions: use the realie CLI for property data, always pass --json, and authenticate with realie login --api-key. Cursor users can put the same note in .cursorrules. In CI or a sandboxed agent, set REALIE_API_KEY instead of running login.
realie upgrade installs the latest CLI version, and realie docs searches the Realie documentation from the terminal.
Does the CLI return the same data as the REST API and MCP server?
Yes. The CLI calls the public REST API, and its property flags are generated from the same parameter catalog the MCP server uses for its tool schemas, so a parameter added to the API reaches the CLI and MCP together. Requests are tagged as CLI traffic (x-realie-source: cli) and count against the same API plan as REST and MCP calls. There is no separate CLI plan.
Each record is the county-sourced public record the API serves: parcel, assessor, and recorder fields in one response across all 50 states, ~3,000 counties, and 180M+ addresses, with ~20 ms average API response time. Its scope is county public records, so MLS listings, rent estimates, and owner contact details are not part of the response.
Should I use the CLI or the MCP server?
Use the CLI when the agent runs shell commands, needs 100-property pages, or runs in CI. Use the MCP server when the agent lives in an MCP host such as Claude or Cursor and you want typed tools with OAuth sign-in. Both reach the same records on the same plan. The full comparison, including REST, is in Should my AI agent use an MCP server, a REST API, or a CLI for property data?
How do I check usage, API keys, and API status?
realie usage shows usage for the current billing period. realie keys list shows your current API key, and realie keys regenerate issues a new one. realie status checks API health and latency, and realie whoami shows the signed-in user and plan.
CLI calls use your API plan’s included calls: Free includes 25 calls a month, $50/mo includes 1,250, $150/mo includes 6,000, $350/mo includes 30,000, and enterprise pricing at $600/mo includes 100,000. See Realie pricing.
Sources
Frequently asked questions
- Is there a CLI for property data?
- Yes. Realie publishes a first-party CLI for its property data API. It looks up properties by address or parcel ID, searches by state, county, city, or ZIP code, finds nearby properties and comparables, and reports account usage, with --json output on every command.
- How do I use Realie from Claude Code or a terminal?
- Install the CLI, run realie login --api-key YOUR_API_KEY (or set REALIE_API_KEY), and tell Claude Code to call realie with --json. If you prefer MCP tools, register the server instead with claude mcp add --transport http realie https://app.realie.ai/api/mcp; the Connect Realie to Claude guide covers that setup.
- Does the Realie CLI cost extra?
- No. There is no separate CLI plan. CLI calls count against the same API plan as REST and MCP: Free includes 25 calls a month, $50/mo includes 1,250, $150/mo includes 6,000, $350/mo includes 30,000, and enterprise pricing at $600/mo includes 100,000.
- What does the Realie CLI need to run?
- Node.js 18 or later. The shell installer downloads a single-file bundle of about 150 KB to ~/.realie/bin/ and adds it to your PATH. Settings, including the stored API key, live in ~/.realie/config.json.
- Can I run the Realie CLI in CI without a browser?
- Yes. Use realie login --api-key YOUR_API_KEY, or set REALIE_API_KEY in the job environment. Both skip the browser sign-in that plain realie login opens.