Hvis du vil ha en dump med anmeldelser for en applikasjon på Steam, så kan du bruke følgende metode med parametrene nedenfor.
Parametre:
GET store.steampowered.com/appreviews/<appid>?json=1
| Navn | Type | Påkrevd | Beskrivelse |
|---|
| filter | streng | ✔ | nylig – sortert etter tid opprettet
oppdatert – sortert etter sist oppdatert
alle – (standard) sortert etter nyttighet, med glidende vinduer basert på parameteren day_range, finner alltid resultater å returnere.
Ved bruk av cursor for å bla gjennom anmeldelser, velg så enten det nylige alternativet eller det oppdaterte alternativet for å til slutt motta en tom responsliste. |
| language | streng | ✔ | se https://partner.steamgames.com/documentation/languages (og bruk språkkodelisten til API-et) eller send «alt» for alle anmeldelser. |
| day_range | streng | ✔ | spenn fra nå til n dager siden for å lete etter nyttige anmeldelser. Gjelder kun for filteret «alt». Maksverdi er 365. |
| cursor | streng | ✔ | anmeldelser returneres i grupper på 20, så send «*» for det første settet, og så verdien til «cursor» som ble returnert i svaret til det neste settet osv. Merk at verdier for cursor kan inneholder karakterer som må kodes for bruk i spørrestrengen. |
| review_type | streng | ✔ | alt – alle anmeldelser (standard)
positive – kun positive anmeldelser
negative – kun negative anmeldelser. |
| purchase_type | streng | ✔ | alt – alle anmeldelser
non_steam_purchase – anmeldelser skrevet av brukere som ikke betalte for produktet på Steam
steam – anmeldelser skrevet av brukere som betalte for produktet på Steam (standard). |
| num_per_page | streng | ✔ | som standard returneres opptil 20 anmeldelser. Flere anmeldelser kan returneres basert på denne parameteren (maks 100 anmeldelser). |
| filter_offtopic_activity | number | | som standard filtreres avsporinger (f.eks. anmeldelsesangrep) og, og returneres ikke med dette API-et. Send 0 for å inkludere disse. Mer informasjon her. |
Svar
en liste i JSON-format med anmeldelser som svarer til parametrene, med informasjonsfelt. Strenger i JSON-en kan inneholde avbruddssekvenser, og disse sekvensene må av og til fjernes i svaret før bruk.
Respons:-
success – 1 hvis forespørselen var vellykket.
-
query_summary – Returneres med første forespørsel.
-
num_reviews – Antallet anmeldelser som returneres i denne responsen.
-
review_score – Anmeldelsespoeng
-
review_score_desc – Beskrivelsen av poengsummen fra anmeldelser.
-
total_positive – Totalt antall positive anmeldelser.
-
total_negative – Totalt antall negative anmeldelser.
-
total_reveiws – Totalt antall anmeldelser som samsvarer med parametrene i forespørselen.
-
cursor – Verdien å sende til neste forespørsel som cursor for å hente den neste gruppen med anmeldelser.
-
reviews
-
recommendationid – Den unike ID-en til anbefalingen.
-
author
-
steamid – Brukerens Steam-ID.
-
num_games_owned – Antall spill som brukeren eier.
-
num_reviews – Antall anmeldelser brukeren har skrevet.
-
playtime_forever – Helhetlig spilletid sporet i denne applikasjonen.
-
playtime_last_two_weeks – Spilletid i de siste to ukene i denne applikasjonen.
-
playtime_at_review – Spilletid når anmeldelsen ble skrevet.
-
last_played – Tidspunktet da brukeren spilte sist.
-
language – Språket brukeren oppgav når de skrev anmeldelsen.
-
review – Teksten i en skrevet anmeldelse.
-
timestamp_created – Datoen da anmeldelsen ble skrevet (unix-tidsstempel).
-
timestamp_updated – Datoen da anmeldelsen sist ble skrevet (unix-tidsstempel).
-
voted_up – true betyr at det var en positiv anbefaling.
-
votes_up – Antallet brukere som syntes at anmeldelsen var nyttig.
-
votes_funny – Antallet brukere som syntes at anmeldelsen var morsom.
-
weighted_vote_score – Nyttighetspoeng.
-
comment_count – Antallet kommentarer på anmeldelsen.
-
steam_purchase – true hvis brukeren kjøpte spillet på Steam.
-
received_for_free – true hvis brukeren krysset av for at de mottok applikasjonen gratis.
-
written_during_early_access - true hvis brukeren la ut anmeldelsen mens spillet var i tidlig tilgang.
-
developer_response – Tekst fra svar fra utvikleren, hvis det finnes noe.
-
timestamp_dev_responded – Unix-tidsstempel for når utvikleren svarte, hvis aktuelt.
