> For the complete documentation index, see [llms.txt](https://docs.junkipedia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.junkipedia.org/reference-material/api/query-string-parameters/engagement-filters.md).

# Engagement Filters

The following API entry points provide the ability to search for records based on when they were created:

* GET /posts
* GET /posts/stats

With each of these endpoints, two parameters work together to specify a range of engagement metrics for records to be included in the results:

* **engagement\_from** – low end of engagement range
* **engagement\_to** – high end of engagement range

These values must be expressed as integers with a ".00" suffix.

If either or both of these parameters is omitted, the following defaults will be implied:

* When omitted, a default value of zero will be implied for the **engagement\_from** parameter.
* When omitted, an infinitely large default value will be implied for the **engagement\_to** parameter.

## Explicit Range

The following request will retrieve posts with engagement metrics of at least 100 and not greater than 5000:

GET /posts?engagement\_from=100.00\&engagement\_to=5000.00

## Implicit Low Or High Values

The following requests imply default low or high bounds for the range:

GET /posts?engagement\_from=100.00

GET /posts?engagement\_to=5000.00

## No Engagement Filtering

Without engagement parameters, the following request will apply no engagement filtering:

GET /post


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.junkipedia.org/reference-material/api/query-string-parameters/engagement-filters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.