Filters API Reference
Filters
A Filter is a query for Stackla Tile content that was ingested from a particular Network, contains a particular Tag and/or is of a particular Medium. To retrieve a stream of content you can do so using the Filters endpoint.
Properties
Field | Type | Value | POST | PUT | Definition |
---|---|---|---|---|---|
id | integer | Unique id for filter | |||
name | string |
post: Required Filter name |
|||
sort | string | source_created_at_desc score_desc votes |
Sorting type | ||
networks | array | twitter facebook instagram youtube gplus flickr pinterest tumblr rss ecal sta_feed weibo |
array of network(s) for filtering rule | ||
tags | array | Array of tags’ id for filtering rule | |||
media | array | text image video html |
Array of media(s) for filtering rule |
GET filters
Retrieves all filters available in the Stack.
Resource URL
https://api.stackla.com/api/filters
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
page | No | query |
Page number. Default value is 1 |
limit | No | query |
Return limit define how many Filters will be return for each request. Default is 25. Maximum limit is 100. |
POST filters
Creates a new Filter in the Stack.
Resource URL
https://api.stackla.com/api/filters
Resource Details
Request Parameters
No additional request parameters are available.
GET filters/:filterId
Retrieves a specific Filter available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/filters/:filterId
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
filterId | Yes | Request type |
ID of the Filter |
GET filters/:filterId/content
Retrieves tile content of a specific Filter by its ID.
Resource URL
https://api.stackla.com/api/filters/:filterId
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
filterId | Yes | endpoint |
ID of the Filter |
since_id | No | query |
Return results with an ID greter than (more recent than) the specified ID |
GET filters/:filterId/summaries
Retrieves aggregated data of a specific Filter by its ID.
Resource URL
https://api.stackla.com/api/filters/:filterId
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
filterId | Yes | endpoint |
ID of the Filter |
aggregated_by | No | query |
Default or geohash (beta), geohash returns aggregated data grouped by geohashes for geotagged tiles. |
PUT filters/:filterId
Updates a specific Filter available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/filters/:filterId
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
filterId | Yes | endpoint |
ID of the Filter |
DELETE filters/:filterId
Deletes a specific Filter available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/filters/:filterId
Resource Details
Request Parameters
Name | Mandatory | Request type | Description |
---|---|---|---|
filterId | Yes | endpoint |
ID of the Filter |