search endpoint

[fasterthanlime]

Separate endpoints for users, tags, and games:

/api/1/search/games?q=TERM

etc. — so we can run concurrent queries

all paginated

games format is well-defined already

tags you can pretty much dump the model (description if there is one, etc.)

users, same as what there is in user fields in game response?

[fasterthanlime]

feel free to break down in separate issues

[leafo]

• why paginated? do we ever get valuable results past the top 30?
• why separate endpoints? it will probably be much faster to mimic the web with one search endpoint

[fasterthanlime]

do we ever get valuable results past the top 30?

yes because our current ranking could, uh, use some improvement. look at how jimsterling is doing itch.io tasty, he's definitely going past page 1

there's "targeted" searches where you're looking for 1 game, in which case it should definitely be in top 10 (first google page), and larger searches where you want everything that has to do with "word X" (yes, tags and categories and whatever exist but people use search for everything nowadays and I don't think they're wrong)

why separate endpoints? it will probably be much faster to mimic the web with one search endpoint

so we can paginate those separately? they're separate DB queries anyway.

[leafo]

I do agree that our current search isn't the best. For topic searches we should be figuring out how to get people to the respective topic page, the browsing experience will always be better. For direct matches there should never be more than a handful of relevant results so pagination is less important.

[leafo]

https://itch.io/api/1/me/search/games?query=x-moon

[Mrmaxmeier]

Currently /api/1/me/search/games requires an api key via cookie.
Could you move it to /api/1/<key>/me/search/games or add something like /api/1/search/games without requiring an api key?

[fasterthanlime]

@Mrmaxmeier /me is a fragment you can use instead of your api key :)

[fasterthanlime]

@Mrmaxmeier so the real endpoint is /api/1/<key>/search/games

[Mrmaxmeier]

@fasterthanlime whoops, I should've tried that.

[fasterthanlime]

@Mrmaxmeier if you're working on search functionality in your fork, can you open an early PR so we can discuss it in the open and minimize duplicated effort ?

[Mrmaxmeier]

@fasterthanlime sure, opened it in itchio/itch #231

[fasterthanlime]

API has game & creator search, I consider this closed.

(For now!)

[Enissay]

@fasterthanlime a link please ?

[fasterthanlime]

@Enissay

https://itch.io/api/1/me/search/games?query=x-moon
https://itch.io/api/1/me/search/users?query=kenney