Resource Information
| Method | GET |
|---|---|
| URL | https://public-api.wordpress.com/rest/v1.2/read/trending/tags |
| Requires authentication? | No |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| context | (string) |
|
| http_envelope | (bool) |
|
| pretty | (bool) |
|
| meta | (string) | Optional. Loads data from the endpoints found in the 'meta' part of the response. Comma-separated list. Example: meta=site,likes |
| fields | (string) | Optional. Returns specified fields only. Comma-separated list. Example: fields=ID,title |
| callback | (string) | An optional JSONP callback function. |
| lang | (string) | The language code for the tags |
| count | (int) | The number of topics to fetch Default: 20. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| tags | (array) | The list of subscribed tags. |
Resource Errors
These are the possible errors returned by this endpoint.
| HTTP Code | Error Identifier | Error Message |
|---|---|---|
| 400 | invalid_tag | The tag requested does not seem to be valid. |
| 400 | not_subscribed | You are not subscribed to the specified tag. |
| 400 | already_subscribed | You are already subscribed to the specified tag. |
Example
curl \ -H 'authorization: Bearer YOUR_API_TOKEN' \ 'https://public-api.wordpress.com/rest/v1/read/trending/tags'
<?php
$options = array (
'http' =>
array (
'ignore_errors' => true,
'header' =>
array (
0 => 'authorization: Bearer YOUR_API_TOKEN',
),
),
);
$context = stream_context_create( $options );
$response = file_get_contents(
'https://public-api.wordpress.com/rest/v1/read/trending/tags',
false,
$context
);
$response = json_decode( $response );
?>
Response
{
"tags": [
{
"tag": {
"ID": "177",
"slug": "art",
"title": "Art",
"display_name": "art",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/art\/posts"
},
"count": 1888073
},
{
"tag": {
"ID": "436",
"slug": "photography",
"title": "Photography",
"display_name": "photography",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/photography\/posts"
},
"count": 1884843
},
{
"tag": {
"ID": "200",
"slug": "travel",
"title": "Travel",
"display_name": "travel",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/travel\/posts"
},
"count": 1874952
},
{
"tag": {
"ID": "91",
"slug": "blogging",
"title": "Blogging",
"display_name": "blogging",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/blogging\/posts"
},
"count": 1661089
},
{
"tag": {
"ID": "22302",
"slug": "summer",
"title": "summer",
"display_name": "summer",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/summer\/posts"
},
"count": 1513505
},
{
"tag": {
"ID": "9625683",
"slug": "postaday",
"title": "postaday",
"display_name": "postaday",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/postaday\/posts"
},
"count": 1508742
},
{
"tag": {
"ID": "124",
"slug": "life",
"title": "Life",
"display_name": "life",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/life\/posts"
},
"count": 1445281
},
{
"tag": {
"ID": "4108488",
"slug": "long-reads",
"title": "long reads",
"display_name": "long-reads",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/long-reads\/posts"
},
"count": 1378529
},
{
"tag": {
"ID": "175459",
"slug": "memorial-day",
"title": "MEMORIAL DAY",
"display_name": "memorial-day",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/memorial-day\/posts"
},
"count": 1373451
},
{
"tag": {
"ID": "116305918",
"slug": "dailyprompt",
"title": "dailyprompt",
"display_name": "dailyprompt",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/dailyprompt\/posts"
},
"count": 758515
},
{
"tag": {
"ID": "178",
"slug": "books",
"title": "Books",
"display_name": "books",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/books\/posts"
},
"count": 426683
},
{
"tag": {
"ID": "586",
"slug": "food",
"title": "Food",
"display_name": "food",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/food\/posts"
},
"count": 335171
},
{
"tag": {
"ID": "3737",
"slug": "fashion",
"title": "Fashion",
"display_name": "fashion",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/fashion\/posts"
},
"count": 320878
},
{
"tag": {
"ID": "384",
"slug": "entertainment",
"title": "Entertainment",
"display_name": "entertainment",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/entertainment\/posts"
},
"count": 307453
},
{
"tag": {
"ID": "376",
"slug": "humor",
"title": "Humor",
"display_name": "humor",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/humor\/posts"
},
"count": 287059
},
{
"tag": {
"ID": "179",
"slug": "business",
"title": "Business",
"display_name": "business",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/business\/posts"
},
"count": 286806
},
{
"tag": {
"ID": "6",
"slug": "technology",
"title": "technology",
"display_name": "technology",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/technology\/posts"
},
"count": 280473
},
{
"tag": {
"ID": "1098",
"slug": "culture",
"title": "Culture",
"display_name": "culture",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/culture\/posts"
},
"count": 280039
},
{
"tag": {
"ID": "1099",
"slug": "nature",
"title": "Nature",
"display_name": "nature",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/nature\/posts"
},
"count": 255289
},
{
"tag": {
"ID": "406",
"slug": "family",
"title": "Family",
"display_name": "family",
"description": null,
"URL": "https:\/\/public-api.wordpress.com\/rest\/v1\/read\/tags\/family\/posts"
},
"count": 245680
}
]
}
Developer Resources 