Lists

The following API entry points provide the ability to search for records based on monitoring lists that would pull them into the monitoring system using the lists query string parameter.

• GET /posts

• GET /posts/stats

With each of these endpoints, one or more comma separated list ID values may be specified.

For example, the following request will retrieve posts selected by list ID 1911 or list ID 4224:

GET /posts?lists=1911,4224

List Names Corresponding To List IDs

Since list ID values are just numeric codes, it is difficult to distinguish them without being able to refer to the names assigned to these lists. You can relate list names to list ID values either through the Junkipedia Web UI or by using API requests to view your lists.

• Junkipedia Web UI – From the Monitoring tab, navigate to the Manage Lists option. When you select a specific list, its list ID value will appear as the numeric URL path segment showing in the address bar of your browser and its name will appear on the content of the page.

• API Request To Retrieve All Lists - You can use the GET /lists request to retrieve all of your lists in a JSON array. Each element of the array represents one of your lists including its name, ID, and various other properties.

• API Request To Retrieve A Specific List - You can use the GET /lists/{id} request to retrieve all properties for one specific list. The {id} is the list ID supplied as a path parameter.