DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
App Store: intersezione di app (live)
Le keyword per cui due o più app App Store si posizionano entrambe. Paginazione con limit, offset e offset_token; oltre le prime pagine usare il token. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Gemello Google Play: post_dataforseo_labs_google_app_intersection_live.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.1356.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- appTipo: object | null
_ids id delle app di destinazione
campo obbligatorio
ID delle applicazioni mobili di destinazione su App Store;
l'ID è presente nell'URL di ogni app elencata su App Store;
esempio:
nell'URLhttps://apps.apple.com/us/app/id835599320
l'id è835599320;
gli id vanno specificati come segue:"app_ids": {<br>"1": "686449807",<br>"2": "382617920"<br>}
se si specifica un solo ID, l'API restituisce risultati solo per un'applicazione;
il numero massimo di ID app specificabili in questo oggetto è20- propertyTipo: string | null
Name
- filtersTipo: array (object | null)[] | null
array di parametri di filtro dei risultati
campo facoltativo
è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
tra le condizioni impostare un operatore logicoandoor
sono supportati i seguenti operatori:<,<=,>,>=,=,<>,in,not_in
esempio:["keyword_data.keyword_info.search_volume",">",500][["keyword_data.keyword_info.search_volume","<>",500],"and",[intersection_result.382617920.rank_group",">=","10"]]per ulteriori informazioni sui filtri, fare riferimento a Dataforseo Labs - Filters o a questa guida del Help Center
Oggetto vuoto - languageTipo: string | null
_code codice della lingua
campo obbligatorio se non si specificalanguage_name
Nota: è necessario specificarelanguage_nameoppurelanguage_code
l'elenco delle lingue disponibili conlanguage_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Nota: questo endpoint attualmente supporta solo la lingua inglese
esempio:en - languageTipo: string
_name nome completo della lingua
campo obbligatorio se non si specificalanguage_code
Nota: è necessario specificarelanguage_nameoppurelanguage_code
l'elenco delle lingue disponibili conlanguage_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Nota: questo endpoint attualmente supporta solo la lingua inglese;
esempio:English - limitTipo: integer | null
numero massimo di keyword restituite
campo facoltativo
valore predefinito:100
valore massimo:1000 - locationTipo: integer
_code codice della località
campo obbligatorio se non si specificalocation_name
Nota: è necessario specificarelocation_nameoppurelocation_code
l'elenco delle località disponibili conlocation_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Nota: questo endpoint attualmente supporta solo la località Stati Uniti;
esempio:2840 - locationTipo: string
_name nome completo della località
campo obbligatorio se non si specificalocation_code
Nota: è necessario specificarelocation_nameoppurelocation_code
l'elenco delle località disponibili conlocation_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Nota: questo endpoint attualmente supporta solo la località Stati Uniti;
esempio:United States - offsetTipo: integer | null
offset nell'array dei risultati delle keyword restituite
campo facoltativo
valore predefinito:0
se si specifica il valore10, le prime dieci keyword nell'array dei risultati vengono saltate e i dati vengono forniti per le keyword successive - orderTipo: array string[] | null
_by regole di ordinamento dei risultati
campo facoltativo
è possibile usare gli stessi valori dell'arrayfiltersper ordinare i risultati;
tipi di ordinamento possibili:asc– i risultati vengono ordinati in ordine crescente;desc– i risultati vengono ordinati in ordine decrescente;
il tipo di ordinamento si specifica con una virgola;
esempio:["intersection_result.382617920.rank_absolute,asc"]
Nota: è possibile impostare al massimo tre regole di ordinamento per richiesta;
per separare più regole di ordinamento usare una virgola;
esempio:["intersection_result.382617920.rank_absolute,desc","keyword_data.keyword_info.search_volume,asc"]
regola predefinita:["keyword_data.keyword_info.search_volume,desc"]
Nota: se l'arrayitem_typescontiene tipi di elemento diversi daorganic, i risultati vengono ordinati in base al primo tipo di elemento nell'array - tagTipo: string | null
identificatore dell'attività definito dall'utente
campo facoltativo
il limite di caratteri è 255
puoi usare questo parametro per identificare l'attività e associarla al risultato
il valoretagspecificato si trova nell'oggettodatadella risposta
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsAppleAppIntersectionLiveResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
array di attività
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsAppleAppIntersectionLiveTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: array (object | null)[] | null
array di risultati
- appTipo: object | null
_ids id delle app in un array POST
- propertyTipo: string | null
Name
- itemsTipo: array (object | null)[] | null
contiene i dati relativi alle keyword di ranking per l'app specificata nel campo
app_id- intersectionTipo: object | null
_result contiene i dati SERP per la
keywordrestituita
i dati vengono forniti in array separati per ogni ID app specificato nell'oggettoapp_idsdurante l'impostazione di un'attività;
a seconda del numero di ID app specificati, può contenere da 1 a 20 array denominati corrispondentemente- propertyTipo: object | null · Response36Afe1097B20_GooglePlaySearchOrganic
Name - appTipo: string | null
_id id dell'app in un array POST
- developerTipo: string | null
nome dello sviluppatore dell'app
- developerTipo: string | null
_url URL della pagina dello sviluppatore su Google Play
- iconTipo: string | null
URL dell'icona dell'app
- isTipo: boolean | null
_free - positionTipo: string | null
l'allineamento dell'elemento nella SERP
può assumere i seguenti valori:left,right - priceTipo: object | null · Response36Afe1097B20_PriceInfo
- currencyTipo: string | null
valuta del prezzo indicato codice ISO della valuta applicata al prezzo
- currentTipo: number | null Formato: double
prezzo attuale indica il prezzo attuale del prodotto o servizio mostrato nel risultato
- displayedTipo: string | null
_price stringa del prezzo nel risultato stringa del prezzo non elaborata, come fornita nel risultato
- isTipo: boolean | null
_price _range prezzo fornito come intervallo indica se un prezzo è fornito come intervallo
- maxTipo: number | null Formato: double
_value il prezzo massimo il prezzo massimo del prodotto o servizio come indicato nel risultato
- regularTipo: number | null Formato: double
prezzo normale indica il prezzo normale del prodotto o servizio senza sconti applicati
- rankTipo: integer | null
_absolute posizione assoluta nella SERP
posizione assoluta tra tutti gli elementi della SERP - rankTipo: integer | null
_group posizione all'interno di un gruppo di elementi con valori
typeidentici
le posizioni degli elementi con valoritypediversi sono omesse darank_group - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
valutazione media dell'app
- ratingTipo: integer | null
_max il valore massimo per un rating_type
- ratingTipo: string | null
_type il tipo di valutazione qui puoi trovare i seguenti elementi: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
il valore della valutazione
- votesTipo: integer | null Formato: int64
_count la quantità di feedback
- reviewsTipo: integer | null Formato: int64
_count il numero totale di recensioni dell'app
- titleTipo: string | null
titolo dell'app
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL della pagina dell'app su Google Play
- keywordTipo: object | null · Response36Afe1097B20_KeywordDataInfo
_data dati delle keyword per la keyword restituita
- avgTipo: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info dati sui backlink per la keyword restituita
questo oggetto fornisce il numero medio di backlink, pagine e domini di riferimento, nonché i valori di ranking medi tra le prime 10 pagine web posizionate organicamente per la keyword- backlinksTipo: number | null
numero medio di backlink
- dofollowTipo: number | null
numero medio di link dofollow
- lastTipo: string | null
_updated _time data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - mainTipo: number | null
_domain _rank - rankTipo: number | null
- referringTipo: number | null
_domains numero medio di domini di riferimento
- referringTipo: number | null
_main _domains numero medio di domini principali di riferimento
- referringTipo: number | null
_pages numero medio di pagine di riferimento
- seTipo: string | null
_type tipo di motore di ricerca
- clickstreamTipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info dati clickstream per la keyword restituita
per recuperare i risultati per questo campo, il parametroinclude_clickstream_datadeve essere impostato sutrue- ageTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- genderTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- lastTipo: string | null
_updated _time data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - monthlyTipo: array (object | null)[] | null
_searches ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com
- keywordTipo: string | null
idea di keyword restituita
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfo
_info dati della keyword per l'idea di keyword restituita
- categoriesTipo: array integer[] | null
- competitionTipo: number | null
concorrenza
indica l'intensità relativa della concorrenza per la keyword in questione. Il valore si basa sui dati di Google Ads e può essere compreso tra 0 e 1 (inclusi) - competitionTipo: string | null
_level - cpcTipo: number | null
costo per clic
indica il costo medio per clic (USD) storicamente pagato per la keyword - highTipo: number | null
_top _of _page _bid offerta massima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa l'80% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST - lastTipo: string | null
_updated _time data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - lowTipo: number | null
_top _of _page _bid offerta minima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa il 20% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST - monthlyTipo: array (object | null)[] | null
_searches ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- seTipo: string | null
_type tipo di motore di ricerca
- searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com - searchTipo: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend variazioni della tendenza di ricerca
indica la variazione percentuale del volume di ricerca rispetto al periodo precedente- monthlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto al mese precedente
- quarterlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto al trimestre precedente
- yearlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto all'anno precedente
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contiene il volume di ricerca della keyword normalizzato sul volume di ricerca Bing
- isTipo: boolean | null
_normalized i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing
- lastTipo: string | null
_updated _time data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno
- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null
_volume tasso attuale di volume di ricerca di una keyword
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contiene il volume di ricerca della keyword normalizzato sui dati clickstream
- isTipo: boolean | null
_normalized i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing
- lastTipo: string | null
_updated _time data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno
- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null
_volume tasso attuale di volume di ricerca di una keyword
- keywordTipo: object | null · Response36Afe1097B20_KeywordProperties
_properties informazioni aggiuntive sulla keyword
- coreTipo: string | null
_keyword keyword principale in un gruppo
contiene la keyword principale in un gruppo determinata dall'algoritmo di clustering dei sinonimi
se il valore ènull, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi dikeyword - detectedTipo: string | null
_language lingua rilevata della keyword
indica la lingua della keyword identificata dal nostro sistema - isTipo: boolean | null
_another _language la lingua rilevata della keyword differisce dalla lingua impostata
se il valore ètrue, la lingua specificata nella richiesta non corrisponde a quella determinata dal nostro sistema per una keyword - keywordTipo: integer | null
_difficulty difficoltà di posizionamento nei primi 10 risultati organici per una keyword
indica la probabilità di entrare nei primi 10 risultati organici per una keyword, su una scala logaritmica da 0 a 100;
calcolata, tra l'altro, analizzando i profili di link delle prime 10 pagine nella SERP;
scopri di più sulla metrica in questa guida dell'Help Center - seTipo: string | null
_type tipo di motore di ricerca
- synonymTipo: string | null
_clustering _algorithm l'algoritmo utilizzato per identificare i sinonimi
valori possibili:keyword_metrics- indica l'algoritmo basato sui parametri dikeyword_infotext_processing- indica l'algoritmo basato sul testo
se il valore ènull, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi dikeyword - wordsTipo: integer | null Formato: int64
_count numero di parole nella keyword
indica da quante parole è composta la keyword
- languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: integer | null
_code codice posizione in un array POST
- seTipo: string | null
_type tipo di motore di ricerca
- searchTipo: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTipo: array (string | null)[] | null
_intent intenti di ricerca supplementari
valori possibili:informational,navigational,commercial,transactional - lastTipo: string | null
_updated _time data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - mainTipo: string | null
_intent intento di ricerca principale
valori possibili:informational,navigational,commercial,transactional - seTipo: string | null
_type tipo di motore di ricerca
- serpTipo: object | null · Response36Afe1097B20_SerpInfo
_info dati SERP
il valore sarànullse non hai impostato il campoinclude_serp_infosutruenell'array POST o se non ci sono dati SERP per questa keyword nel nostro database- checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati - lastTipo: string | null
_updated _time data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - previousTipo: string | null
_updated _time data e ora precedenti all'ultimo aggiornamento dei dati SERP
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-10-15 12:57:46 +00:00 - seTipo: integer | null Formato: int64
_results _count numero di risultati di ricerca per la keyword restituita
- seTipo: string | null
_type tipo di motore di ricerca
- serpTipo: array (string | null)[] | null
_item _types tipi di risultati di ricerca nella SERP
contiene i tipi di risultati di ricerca (items) trovati nella SERP
tipi di elemento possibili:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
Nota: i risultati effettivi verranno restituiti solo per gli elementiorganic,paid,featured_snippetelocal_pack
- seTipo: string | null
_type tipo di motore di ricerca
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: integer | null
_code codice posizione in un array POST
- seTipo: string | null
_type tipo di motore di ricerca
- totalTipo: integer | null Formato: int64
_count quantità totale di risultati nel nostro database pertinenti alla tua richiesta
- resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
La versione corrente dell'API
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_ids": {
"1": "686449807",
"2": "382617920"
},
"language_name": "English",
"location_code": 2840,
"limit": 10
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"app_ids": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword_data": "[Max Depth Exceeded]",
"intersection_result": null
}
]
}
]
}
]
}