API Google Play Ricerca
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Normale
Ultime 24 ore
Ultimi 30 giorni
Cerca app su Google Play per nome o caso d'uso. Ottieni ID pacchetto, sviluppatore, valutazione, fascia di installazioni, prezzo, categoria, classificazione dei contenuti e ultimo aggiornamento. Usa l'app_id restituito per dettagli e recensioni. installs è il limite inferiore di una fascia, non un conteggio esatto.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su google_play e action impostato su search. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Google Play Ricerca di EveryInfra (google_play/search).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su google_play e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Una query su Google Play per nome dell'app o caso d'uso, ad esempio note taking. Non è una ricerca esatta per nome del pacchetto. Usa app_id per i dettagli e le recensioni dell'app.
- Parametri facoltativi:
- country: Seleziona il paese o la regione dello store di Google Play con un codice minuscolo come us. Il valore predefinito è us.
- language: Seleziona la lingua usata per i contenuti del Play Store e per le query sulle recensioni, ad esempio en o zh. Il valore predefinito è en.
- page_token: Token di paginazione: per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente; omettilo per la prima pagina. Lascia invariati tutti gli altri parametri.
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: app_id, url, name, summary, description, developer, developer_email, developer_website, score, rating_count, review_count, installs; 29 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=google_play.
- Esempio di corpo della richiesta:
{
"platform": "google_play",
"action": "search",
"params": {
"keyword": "habit tracker"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | google_play | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Una query su Google Play per nome dell'app o caso d'uso, ad esempio note taking. Non è una ricerca esatta per nome del pacchetto. Usa app_id per i dettagli e le recensioni dell'app. |
country | body.params | string | No | - | Seleziona il paese o la regione dello store di Google Play con un codice minuscolo come us. Il valore predefinito è us. Per search e profile cambia lo store interrogato, non la regione del telefono dell'utente né la nazionalità dello sviluppatore. Per reviews non cambia le recensioni restituite: le recensioni variano solo in base a language, quindi us e gb restituiscono le stesse recensioni a parità di lingua. Per confrontare le recensioni tra mercati diversi, cambia language, non solo country. |
language | body.params | string | No | - | Seleziona la lingua usata per i contenuti del Play Store e per le query sulle recensioni, ad esempio en o zh. Il valore predefinito è en. Non cambia automaticamente il paese e non garantisce che ogni recensione restituita sia scritta in quella lingua. |
page_token | body.params | string | No | - | Token di paginazione: per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente; omettilo per la prima pagina. Lascia invariati tutti gli altri parametri. I token durano 24 ore e ogni pagina corrisponde a una chiamata. |
limit | body.params | integer (1–100) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "google_play",
"action": "search",
"params": {
"keyword": "habit tracker"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#Acquisita il September 26, 2026 at 08:56 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "platform": "google_play", "action": "search", "results": [ { "app_id": "org.isoron.uhabits", "url": "https://play.google.com/store/apps/details?id=org.isoron.uhabits", "name": "Loop Habit Tracker", "summary": "Create good habits and track their progress over time", "description": "Loop helps you create and maintain good habits, allowing you to achieve your long-term goals. Detailed charts and statistics show you how your habits improved over time. The app is completely ad-free, open source and it respects your privacy.\n\n\nSimple, beautiful and modern interf…", "developer": "Álinson S Xavier", "developer_email": "•••", "score": 4.7175927, "rating_count": 63336, "review_count": 3419, "installs": "5,000,000+", "min_installs": 5000000, "price": 0, "is_free": true, "currency": "USD", "category": "Productivity", "content_rating": "Everyone", "contains_ads": false, "offers_iap": false, "version": "2.3.1", "released": "Feb 22, 2016", "updated_at": "2025-09-14T22:56:06.000Z", "android_version": "9", "icon_url": "https://play-lh.googleusercontent.com/p0AgkzxC9Vus-E82psxrb7p8VtrVJMfXKcU9hNTW8tTG7G3yAGBqxCIyUmwibUyT1Mx7DAzkrJnPLo4VEYDwlbI", "header_image_url": "https://play-lh.googleusercontent.com/saJuIprQv_9zeut6372XuLUEWSSB9iAJIwFc2oASfly5r3AQaNZiVWQ9_Rc1fLe2Y4bNF6fljlze-I7yorTP", "privacy_policy": "http://loophabits.org/privacy", "platform": "google_play", "screenshots": [ "https://play-lh.googleusercontent.com/KrxN9bOtspk63xhtNJx2uyaHZ3GOYK_IJ-VRIhMlh2ChFCQuBxXLWoRJd48uFRU_Rk97Nz3gHiI0eteLn2KDFQ", "https://play-lh.googleusercontent.com/2nZZDFddPS4-wHVgPvAfeYik3vMTsrV-Mgys3g1A6s-KLCcUWsf1PlYLJfKXGyxUnUHkSKX8sESQkrEx6mQN", "https://play-lh.googleusercontent.com/8BBDln1lKgX6ErWkH-_tKlfoD2TEfpcVzrgFlzJO91wK0HiYac_W0wJV7hHhGi8aeqk-8xRI051bK6mlsOLiZw" ], "rating_histogram": { "1": 1850, "2": 871, "3": 1850, "4": 4096, "5": 54630 } }, { "app_id": "com.habitnow", "url": "https://play.google.com/store/apps/details?id=com.habitnow", "name": "HabitNow Daily Routine Planner", "summary": "To-do list, Habit Tracker, Routine Planner and Reminders. All in just one app!", "description": "Maximize Your Productivity with HabitNow: Your Ultimate Todo List and Habit Tracker! 🚀\nKeeping your life organized has never been easier! With HabitNow, efficiently manage your school schedule, house chores, work, and more, all while building strong habits. Enter your routine, re…", "developer": "HabitNow Apps", "developer_email": "•••", "score": 4.7406015, "rating_count": 92815, "review_count": 2861, "installs": "5,000,000+", "min_installs": 5000000, "price": 0, "is_free": true, "currency": "USD", "category": "Productivity", "content_rating": "Everyone", "contains_ads": false, "offers_iap": true, "version": "2.5.4a", "released": "May 17, 2019", "updated_at": "2026-07-26T22:27:33.000Z", "android_version": "6.0", "icon_url": "https://play-lh.googleusercontent.com/HsjWZ5h3QDDNPL-0xKP9j4CXG6dxaojS2PtyuRnylitzLm5huDOCMkwc8gYF1glrr1laiRNospq5uNB0HUIo", "header_image_url": "https://play-lh.googleusercontent.com/rFBjMvOr9AMlbcXyoEcCmd68k7yOPeEwbfmaZar1Anz5nfZZxQvEoWOTj914GRyunw4rCEHtbbt_mtMUivcncQ", "privacy_policy": "https://www.habitnow.app/privacy-policy", "platform": "google_play", "screenshots": [ "https://play-lh.googleusercontent.com/4_x2XH6oemmQ0_d9X_k7sRvq_yQmrb3lUB4ZA7WNZCDhn_kQ9zRzZS2XffNEbBnVcDK-fCm-NowhjTs0VdQJcO8", "https://play-lh.googleusercontent.com/58H0BAGBiSYeRYK4pixVsgYyebULGiYM2S1mBgxTWCFfGS11wbO4uo0e9eF3JmtFWJ99xgnQEh3-ufpmVztj1Q", "https://play-lh.googleusercontent.com/Nwb7e4hd53oPd6WyCGKeT-4Q4yBwe4o7oDUdD6Lbpg3RZp-fpkgXceqIs6PLL1Xon8DaxMeZxPGn6XWB6JQDwG8" ], "rating_histogram": { "1": 2315, "2": 802, "3": 2315, "4": 7666, "5": 79668 } } ], "next_page_token": …, "pagination": { … }, "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
app_id | Mantiene il significato attribuito dalla piattaforma |
url | Link al record sulla piattaforma. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
summary | Mantiene il significato attribuito dalla piattaforma |
description | Riepilogo o descrizione, di solito più breve di text. |
developer | Mantiene il significato attribuito dalla piattaforma |
developer_email | Mantiene il significato attribuito dalla piattaforma |
developer_website | Mantiene il significato attribuito dalla piattaforma |
score | Mantiene il significato attribuito dalla piattaforma |
rating_count | Numero di persone che hanno espresso una valutazione. null significa non reso noto, non 0. |
review_count | Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0. |
installs | Mantiene il significato attribuito dalla piattaforma |
min_installs | Mantiene il significato attribuito dalla piattaforma |
price | Prezzo come numero senza simbolo di valuta; vedi currency. |
is_free | Indica se l'app è scaricabile gratuitamente (keywords_for_app). |
currency | Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta. |
category | Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme. |
content_rating | Mantiene il significato attribuito dalla piattaforma |
contains_ads | Mantiene il significato attribuito dalla piattaforma |
offers_iap | Mantiene il significato attribuito dalla piattaforma |
version | Mantiene il significato attribuito dalla piattaforma |
released | Mantiene il significato attribuito dalla piattaforma |
updated_at | Mantiene il significato attribuito dalla piattaforma |
android_version | Mantiene il significato attribuito dalla piattaforma |
icon_url | Mantiene il significato attribuito dalla piattaforma |
header_image_url | Mantiene il significato attribuito dalla piattaforma |
privacy_policy | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
screenshots | Mantiene il significato attribuito dalla piattaforma |
rating_histogram | Mantiene il significato attribuito dalla piattaforma |
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.