Skip to content

Why a search times out

Some query shapes are expensive for the archive.

A timeout usually means the query shape was expensive rather than that the service is down.

Common causes

Comment keyword search. Comment bodies are searched with a full-text query, which is much slower than searching post titles.

Very active accounts or subreddits. Aggregations over accounts with enormous histories frequently time out. The archive documents this.

Unbounded searches. A query with no date range asks the archive to consider everything.

Fixes, in order of effectiveness

  1. Add a date range. This helps more than anything else.
  2. Add a subreddit or author to narrow the scope.
  3. Reduce the result limit.
  4. Try again. Some timeouts are transient, and a repeat query sometimes succeeds where the first failed.

Subdex treats a timeout as distinct from an outage and suggests narrowing rather than reporting the service as down.

Related