Get content queue items¶
Get a list of queued content items for a specific collection. Queued content items are both published and unpublished content items.
Endpoint¶
GET https://q.crowdynews.com/v1/queue/{contract}
Request Parameters¶
| URL PARAMETER | VALUE DESCRIPTION |
|---|---|
| contract | The slugified name of the contract. This is the slug property of your contract. The consumer that wants to retrieve the queue must have access to the contract, otherwise this action is forbidden. |
| QUERY PARAMETER | VALUE DESCRIPTION |
|---|---|
| access_token | A valid OAuth access token with the correct permission(s). |
| q | The slugified name of the collection to get content for. This is the slug property of the collection. |
| callback | Optional. When given and not empty a JSONP format is returned. |
| service | Optional. Comma separated filter on services. Supported services:
|
| type | Optional. Filter on content type. Accepts a comma separated list of types. Supported types:
|
| location | Optional. Requires three parameters (comma separated) in specific order: longitude, latitude and radius in meters. Latitude ranges from -180 to 180. Longitude ranges from -90 to 90. Radius must be between 10 and 200. Example value: 53.2216,6.4945,200 |
| language | Optional. Show the content for the specified language or languages. Multiple languages should be seperated by comma. Languages should be specified in the ISO 639-1 form. |
| since | Optional. Show results starting after this time. Unix timestamp in seconds, for example: 1466088488. Defaults to the current time minus 24 hours. |
| until | Optional. Show results until this time. Unix timestamp in seconds, for example: 1466088488. Defaults to the current time. |
| count | Optional. The amount of results to show. Minimum value: 1, maximum value: 500. Defaults to 500. |
| offset | Optional. Start position in the result set. Used for pagination. Defaults to 0. |
| sort | Optional. What to sort the content on. Can be on publish date (time) or on popularity (kudos). Defaults to time. time, kudos |
| order | Optional. What order to sort content in. Either ascending (oldest / least popular first) or descending (newest / most popular first). Defaults to descending. Supported values: asc, desc |
Response Format¶
On success, the HTTP status code in the response header is
200 OK and the response body will contain one or more content item objects in JSON
format. If there are no content items, an empty array will be returned in JSON format. On error, the header status code is an error code and
the response body contains an error object.
Example Request¶
Request:
GET https://q.crowdynews.com/v1/content/my-contract?q=my-collection&type=video&access_token={your access token}
Response:
HTTP/1.1 200
[
{
"id": "EOWcCt-leVc",
"service": "youtube",
"type": "video",
"title": "Let's Play NBA 2K16 Deutsch German [227] - MyTeam: Steve Nash & die Suns",
"text": " Führe deinen Mein Spieler durch die komplette NBA Reise, übernimm die Kontrolle über ein ganzes NBA-Franchise oder verfeinere deine Skills online.",
"url": "https://www.youtube.com/watch?v=EOWcCt-leVc",
"date": "2016-03-31T08:00:00.000Z",
"tags": [
"NBA 2K16",
"German",
"NBA 2K16 Gameplay",
"MyCareer",
"Meine Karriere"
],
"author": {
"name": "Maxx",
"userid": "UCnGS0_wUbxgW4bpMj3_yrqg",
"url": "https://youtube.com/channel/UCnGS0_wUbxgW4bpMj3_yrqg"
},
"media": [
{
"type": "embed",
"embed": "<iframe src='https://www.youtube.com/embed/EOWcCt-leVc?autoplay=1'></iframe>",
"duration": 2316
}
],
"kudos": {
"score": 1,
"youtube_score": 1,
"youtube_comments": 0,
"youtube_likes": 1,
"youtube_dislikes": 0,
"youtube_views": 14,
"youtube_favorites": 0,
"youtube_rating": 0
},
"state": "published"
}
]