# `mix perplexed.searxng.instances`
[🔗](https://github.com/agoodway/perplexed/blob/v0.2.0/lib/mix/tasks/perplexed.searxng.instances.ex#L1)

Fetches today's public SearXNG instances from searx.space, probes each
start page from this machine, and prints which are up, fastest first.

    mix perplexed.searxng.instances
    mix perplexed.searxng.instances --country US --country CA --max-median 2500
    mix perplexed.searxng.instances --format elixir     # a config snippet
    mix perplexed.searxng.instances --format json --output instances.json
    mix perplexed.searxng.instances --no-probe          # searx.space only

## Options

  * `--country` - ISO code to keep, repeatable or comma-separated.
  * `--max-median` - slowest searx.space median search time (ms) to keep.
  * `--min-success` - lowest searx.space test-search success %, default 90.
  * `--no-probe` - skip checking the instances from here.
  * `--all` - also print instances that are down, walled or refusing
    (table only).
  * `--format` - `table` (default), `json` or `elixir`.
  * `--output` - write to this file instead of printing.
  * `--proxy` - probe through this proxy URL.

The probe requests each start page once (never a search). A live start
page does not promise searches will be answered, since SearXNG's limiter
acts on `/search`; for hard-coding a list, prefer `searxng_instances:
:auto`, which rediscovers daily (see `Perplexed.Search.SearXNG.Instances`).

---

*Consult [api-reference.md](api-reference.md) for complete listing*