PopIt provides a full-featured search API that allows you to find the documents you’re looking for within a collection. It supports wildcard queries, date ranges and more.
Find records via various criteria.
q- Your search query, you can also specify which fields to search - see below.
page- Access further pages by specifying this parameter. (Max 1000)
per_page- Number of results to return per-page. (Max 100)
q parameter can also include any valid popolo field for the collection being searched as a prefix.
If you wanted to search for people named
John then your query might look like:
In this url the
q parameter is requesting records where the
name field contains
If you want to query sub-class, such as id property of area of a post then your query might look like:
In this url
q parameter is requesting records of posts, where
Wildcard searches can be run on individual terms, using
? to replace a single character, and
* to replace zero or more characters:
If you want an exact match then you can surround your query with quotation marks:
This will only match the exact string specified.
You can match date ranges using the API, e.g. to find all memberships which started in 2013:
There is a specific end point for searching dates.
You specify the date fields as separate query parameters and it handles documents where the date you are searching for is missing. e.g to search for all memberships of an organization between 2010 and 2012:
The results for this will also include memberships with no
start_date or no
end_date. It’s possible to construct a query that does this using the normal search interface, this is just a slightly more convenient way to do so.
The underlying search engine is elasticsearch. For more details about the kinds of query you can perform, check out the query string syntax guide.