close
The Wayback Machine - https://web.archive.org/web/20140813160849/https://developer.beatsmusic.com/docs/read/users/Collection

Bios

Get a list of bios associated to the user.

Endpoint URL

/api/users/:id/bios

HTTP Method

GET

Authentication

OAuth 2.0: Access token required. See Authentication for examples and details.

Parameters

Name Required Description Example
user_id required Unique ID for User. 97074088224358656
fields optional An array of object fields to include in the response. Only the given fields will be returned. Default is to return all fields.
offset optional Integer offset into results, 0 based. Defaults to 0. 0
limit optional Specifies the maximum number of records to retrieve. You are guaranteed to get at most this number of results, but you may get fewer. If set to zero or less, returns nothing. Maximum value is 200 (i.e., if greater than 200, returns only 200). If not supplied, defaults to 20. 20
order_by optional Indicates how the results set should be ordered. Defaults to "name asc".
Valid Values (default name is name asc):
name asc Order alphabetically by name
name Synonym for name asc
name desc Order reverse alphabetically by name
created_at asc Synonym for created_at
created_at desc Order reverse alphabetically by created_at
updated_at asc Order by updated_at
updated_at Synonym for updated_at asc
updated_at desc Order reverse by updated_at
duration asc Order by duration
duration Synonym for duration asc
duration desc Order reverse by duration
total_tracks asc Order by total_tracks
total_tracks Synonym for total_tracks asc
total_tracks desc Order reverse by total_tracks
name

Response Elements

ResponseDescription
code

Beats API response code. If successful, code is 'OK'. Otherwise it will be an error code.

Example Request

curl -X GET "https://partner.api.beatsmusic.com/v1/api/users/97074088224358656/bios?
    access_token=[ACCESS_TOKEN]"
 

Example Response

{
    data: [
    {
        type: "bio",
        content: "Before becoming one of the biggest genres in pop history...",
        headline: "",
        subject: {
            ref_type: "user",
            id: "97074088224358656"
        },
        length: "long"
    }
    ],
    info: {
        offset: 0,
        count: 1,
        total: 1
    },
    code: "OK"
}

version 7 as of 2 months ago by Robin

Docs Navigation