API / Includes

Includes let you specify which fields you want to retreive for a given API request. Use them by appending ?include=fieldgroup to your query params. Including any of these named "field groups" will add data to the response. You can join multiple field groups in a list with commas or plus signs (, or +).

curl http://8tracks.com/mixes/14.json?include=likes_count+length

Includes can be nested using [square brackets], to specify which properties should be returned for child objects. For example, it may interest you to know about the users for each mix in a set:

curl http://8tracks.com/mix_sets/all.json?include=mixes[user]
- or -
curl http://8tracks.com/mix_sets/all.json?include=mixes[user+length]+details


The following auto-generated object documentation shows all of the available field groups and the objects or properties they will return for different endpoints. The base field group is always included; you do not need to explicitly request it.



Mix

http://8tracks.com/mixes/123.json
base
cover_image
likes_count
liked (dependent on current user)
listened (dependent on current user)
user
user_with_followed
description_html
nsfw
length
v2


User

http://8tracks.com/users/123.json
base
followed (dependent on current user)
owner (owner)
web_preferences (owner)
recent_mixes (owner)
top_tags
location
location_summary
designation
profile
collections
follows_users
followed_by_users
timeline
profile_counts
presets
v2
v2_1


Mix Set

http://8tracks.com/mix_sets/smart_id.json (see smart id docs)
base
pages
pagination
mixes
mixes_details
mixes_with_users
search_params
details
user
relative_name (dependent on current user)


Review

http://8tracks.com/mixes/123/reviews.json
base
user
mix


Collection

http://8tracks.com/collections/123.json
base
length
user
mixes

 
Quantcast