Skip to content

Data api blogs listbyuser

Yuji Takayama edited this page Jul 10, 2013 · 2 revisions

Blogs: listByUser

Retrieve a list of blogs by user.

Request

HTTP Request

This method accepts GET only.

GET https://your-host/your-mt-api.cgi/v1/users/{user_id}/sites

Parameters

Method Parameters

Parameter Type Description
user_id unsigned integer / 'me' The blog ID or the word 'me'

Query Parameters

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.

Request Body

Do not supply a request body.

Response

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.

Status Code

Code Description
200 no error
403 Do not have permission to retrieve the list of blogs.
404 User not found
Clone this wiki locally