Page 1 of 1

Mod portal API

Posted: Sun May 13, 2018 2:29 pm
by Artentus
Before I start I have to say I'm not really sure if this belongs here but it's the best place I could find.
This is not about the ingame lua API but the online API over at mods.factorio.com, if you think this belongs somewhere else please move.

Now to my request. I am the developer of ModMyFactory, an external tool to download and manage mods.
I am using the URL 'mods.factorio.com/api/mods/<modname>' to query information about specific mods, for example https://mods.factorio.com/api/mods/015AdvancedRadar. Back in January the mod portal underwent a huge overhaul that sadly changed this API page. Previously this page contained the tags "license_url", "github_path", "homepage" and "description", however since the update they have all been removed. The data in question is still presented on the actual mod page so it has not been removed, the API just does not provide it anymore.

I have since then searched for this information in the API to no avail. I'd like to avoid having to parse the full website for this data since it loads significantly slower then the API and causes unnecessary trafic on both your server and the users end. The desription in particular was also formatted in Markdown, which is easier to parse than the full HTML page.

That's why I'm kindly asking for this data to be added back into the API, if it is not too big of a hassle for you. It was a really useful feature, right now my users have to download mods without seeing a proper description, only the really short summary that is also shown ingame.

Re: Mod portal API

Posted: Wed Aug 01, 2018 4:22 am
by Artentus
Idk if noone saw this or not, but just in case I'm bumping this up.

I have people asking me about the aforementioned functionality but since I never receivd a reply here I myself still don't know what to make of this. If there are no plans to ever add this functionality back please just say so, then I will look into other options.

Re: Mod portal API

Posted: Wed Aug 01, 2018 5:42 am
by Koub
The devs should read this, but in case they didn't, maybe you can try an alternate way getting in touch with them via email (can be found on the contact tab of the website)

Re: Mod portal API

Posted: Wed Aug 01, 2018 4:20 pm
by Sanqui
I have re-added the data you have asked for to the API, as well as a bunch of other goodies like the FAQ and changelog pages. You'll find it under /full, e.g.

https://mods.factorio.com/api/mods/015A ... Radar/full

Let me know if there's anything else that could be useful to you.

Re: Mod portal API

Posted: Wed Aug 01, 2018 4:40 pm
by Artentus
Wow, thank you very much!
This is already more than what I'm asking for so I don't think I need anything else, but if I come across something I'll let you know. I don't want to bother you too much with this either.

I really appreaciate that you took the time for me, this is why I love supporting this game. Again thank you.

Re: Mod portal API

Posted: Wed Aug 01, 2018 7:47 pm
by ukezi
You could also the include the dependencies.

Re: Mod portal API

Posted: Thu Aug 02, 2018 9:15 am
by Sanqui
ukezi wrote:You could also the include the dependencies.
Good point, adding!

Re: Mod portal API

Posted: Thu Aug 09, 2018 7:33 pm
by arielbeje
I would've loved it if the API had a search that returned the same results as the normal search, or if the main /api/mods included the info from /full, so I could cache and search the mod portal more easily.

Before the API rework, there was an option to use mods.factorio.com/api/mods?q={query} to search, but to search for mods now requires web scraping/caching and requesting /api/mods/{modname}/full. I wrote the bot for the Discord server and would love it if I could go back to using the API to get mod info properly.

Additionally, there is no way to get the mod's thumbnail URL(even with /full), as was possible previously.

Thank you.

Re: Mod portal API

Posted: Sat Aug 11, 2018 1:54 am
by Artentus
I kind of agree the full mod list is currently not very search-friendly.

For example you are using a tag-system on the portal, where the tags are supposed to help find mods. However, the API doesn't make the tags available in the full list (and querying /full for every single mod would take ages, you can realistically only get that info for a single mod at a time). So the tags are effectively useless in the API.

I don't think including tags in the list would increase traffic by too much (a lot of mods have very few tags if any at all). I guess even the ingame UI could make use of tag information.