Retrieve a list of blogs by user.
This method accepts GET only.
GET https://your-host/your-mt-api.cgi/v1/users/{user_id}/sites
Parameter |
Type |
Description |
user_id |
unsigned integer / 'me' |
The blog ID or the word 'me' |
Parameter |
Type |
Description |
limit |
unsigned integer |
This is an optional parameter. Maximum number of blogs to retrieve. Default is 25. |
offset |
unsigned integer |
This is an optional parameter. 0-indexed offset. Default is 0. |
sortBy |
string |
This is an optional parameter.
- name
- (default) Sort by the name of each blogs.
- created_on
- Sort by the created time of each blogs.
|
sortOrder |
string |
This is an optional parameter.
- ascend
- (default) Return blogs in ascending order. For the date, it means from oldest to newset.
- descend
- Return blogs in descending order. For the date, it means from newest to oldest.
|
includeIds |
string |
This is an optional parameter. The comma separated ID list of blogs to include to result. |
excludeIds |
string |
This is an optional parameter. The comma separated ID list of blogs to exclude from result. |
fields |
string |
This is an optional parameter. the field list to retrieve as part of the Blogs resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned. |
Do not supply a request body.
Parameter |
Type |
Description |
totalResults |
unsigned integer |
The total number of blogs found. |
items |
ARRAY |
An array of Blogs resource. The list will sorted descending by blog name. |
Code |
Description |
200 |
no error |
403 |
Do not have permission to retrieve the list of blogs. |
404 |
User not found |