LoveLive! School Idol API

If you're a developer and you would like to get the cards of the game in a convenient format, we provide a public REST API to get the cards, events, idols, and more!

We'd love to talk to you! If you're creating or you plan to create something that uses our API, contact us so we can help you, give you feedback, ideas, and even promote it when you're ready.

If you would like to get more data that is not available in the current API, contact us and we will see what we can do for you ;)

If you would like to contribute, see the contribute page.

Note that since we provide this service for free, unfortunately, we cannot 100% guarantee its uptime. However, we believe our architecture is reliable enough to be used in a production environment.

Technical Notes

It returns JSON objects that you can easily parse and use in your own tools or services, using any programming language or library. It enables CORS, so you can use it in Javascript as well.

The guaranteed JSON fields are marked with ✅. You can consider that any other field might be null. The site is purposely very permissive in that matter, since we might not have all the information or users might not want to fill everything. We recommend you to make sure that your service works no matter what's missing.

Paginated endpoints give you the total number of elements in count. If you want to know the total number of pages, you can just divide it by the page size, which is 10 by default and can be specified with the page_size parameter.

When you use the ordering parameter, you can specify multiple ordering fields using commas: ?ordering=rarity,attribute, and you can reverse the order using -: ?ordering=-rarity. Most endpoints allow to order by any field. Some endpoints also allow you to randomize the results with ?ordering=random.

Note regarding types

• String may contain unicode characters, such as Japanese characters but not only.
• URL are strings that always start with http://
• Date may be formatted differently, see each field and parameter individually.
• Boolean values in JSON are represented using true and false, but boolean values given as parameters in your requests are expected to be True or False.
• Localized string will return different strings depending on the HTTP header Accept-Language. The list of accepted languages is here. Default language is en.

Endpoints & Methods

School Idol Festival Game

1. Cards
2. Objects
3. Get the list of cards
4. Get a card by id
5. Get only card ids
6. Idols
7. Objects
8. Get the list of idols
9. Get an idol by name
10. Events
11. Objects
12. Get the list of events
13. Get an event by Japanese name
14. Songs
15. Objects
16. Get the list of songs
17. Get a song by name
18. Use itunes ID to play a preview of the songs
19. Cached data

School Idol Tomodachi Community

1. Users
2. Objects
3. Get the list of users
4. Get a user by username
5. Get the authenticated user
6. Follow a user
7. Unfollow a user
8. Accounts
9. Objects
10. Get the list of accounts
11. Get an account by id
12. Owned Cards
13. Objects
14. Get the list of owned cards
15. Get an owned card by id
16. Add an owned card
17. Edit an owned card
18. Note regarding adding/editing owned cards
19. Delete an owned card
20. Activities
21. Objects
22. Get the list of activities
23. Get an activity by id
24. Mobile Apps
25. Objects
26. Get Android app information

Authentication

1. Get your access
2. Learn more about authentication

API Updates

• On Twitter: @schoolidolapi
• Mailing list: schoolidolapi@googlegroups.com

Both get the exact same updates every time something changes on the API. I reply to replies/DMs/emails on both.

If you use the API, please follow one of them to make sure your service doesn't break when we change something.

If you want to follow every single thing about the development behind the API and School Idol Tomodachi, you can also follow the GitHub repository to see all the commits. I also keep the bug tracker updated with the upcoming features and bugs.

See also: API Changelog

General advice when using the API

• Add slashes / at the end of all your API calls to avoid a redirection every time

• Don't ask to expand data if you don't need it, it makes everything much slower

• Don't ask for a big page_size hoping you'll get all you need. Big pages take a lot of time to generate and the server just kinds of stops to generate your page which makes the site very slow for everybody else. Instead, get pages one at a time and try to find a number of elements per page that suits your needs. In general, a good number of elements is 1.5 x what you can see in one view of your application. For instance, if most users see 10 cards when they load the list, ask for 15 every time.

• If you have to get a very long long list of elements and then manually search through it in your code, you're doing it wrong. We provide lots of filters, so use them! If you need to filter/search through something very specific and can't find how to do it, contact me, I might update the API for you.

• In general, if you have to do a for or a while in which you get data from the API (except for pagination), you're doing it wrong. There's probably a way to get the data you need without spamming with queries (and you'll just get kicked out at some point). Example:

• If you do something like: 1/ get all the owned cards in the API 2/ for each owned card, get the card in the API

• You should do something like: get all the owned cards with the parameter expand_card

• If there's anything you're not sure about, or if you just want to know if everything is fine before publishing your code, talk to me! I'll always take the time to help.

Apps that use this API

App	Author
School Idol Tomodachi Team Builder	765PRO
Sukutomo Android app	Arukantara
Sukutomo iOs app coming soon	db0
SIF Cards Tier List	artonico
LoveLive+ Android app	Kevin170113664