DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: ricerca attività commerciali
Cerca nell'indice proprietario di DataForSEO delle schede di attività locali per categories, description, title e location_coordinate: una terna di latitudine, longitudine e raggio. Restituisce total_count, count, offset, offset_token e items, paginati con il token. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Questa legge un indice e risponde subito; tutto il resto qui accoda una scansione live della fonte. Partire da qui e approfondire solo dove conta.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.2428.
- 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)[]
- categoriesTipo: array string[] | null
categorie di attività commerciali
campo facoltativo
le categorie specificate vengono utilizzate per cercare gli elenchi di attività;
se non si usa questo campo, restituiremo gli elenchi di attività trovati nella località specificata;
è possibile specificare fino a 10 categorie - descriptionTipo: string | null
descrizione dell'elemento nella SERP
campo facoltativo
la descrizione dell'entità aziendale per cui vengono raccolti i risultati;
può contenere fino a 200 caratteri - 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:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
con l'operatore%inlikeenot_likeè possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
esempio:["rating.value",">",3]
è possibile ricevere l'elenco dei filtri disponibili effettuando una richiesta separata ahttps://api.dataforseo.com/v3/business_data/business_listings/available_filters
l'elenco completo dei filtri possibili è disponibile qui.Oggetto vuoto - isTipo: boolean | null
_claimed indica se l'attività è verificata dal proprietario su Google Maps
campo facoltativo - limitTipo: integer | null
il numero massimo di attività restituite
campo facoltativo
valore predefinito:100
valore massimo:1000 - locationTipo: string | null
_coordinate coordinate GPS di una località
campo facoltativo
il parametrolocation_coordinatedeve essere specificato nel formato "latitude,longitude,radius"
numero massimo di cifre decimali per "latitude" e "longitude": 7
il valore di "radius" è espresso in chilometri (km)
valore minimo per "radius":1
valore massimo per "radius":100000
esempio:53.476225,-2.243572,200
scopri di più su come impostare i parametri di località in questa API nel nostro Help Center - offsetTipo: integer | null
offset nell'array dei risultati delle attività restituite
campo facoltativo
valore predefinito:0
se si specifica il valore10, le prime dieci entità nell'array dei risultati verranno saltate e i dati verranno forniti per le entità successive
Nota: consigliamo di usare questo parametro solo quando si recuperano fino a 10.000 risultati
per recuperare più di 10.000 risultati, usare inveceoffset_token - offsetTipo: string | null
_token token per le richieste successive
campo facoltativo
fornito nel campo identico della risposta a ogni richiesta;
usa questo parametro per evitare timeout quando tenti di ottenere più di 100.000 risultati in una singola richiesta;
specificando il valore univoco dioffset_tokendall'array della risposta, otterrai i risultati successivi dell'attività iniziale;
i valori dioffset_tokensono univoci per ogni attività successiva
Nota: seoffset_tokenè specificato nella richiesta, tutti gli altri parametri devono essere identici alla richiesta precedente
scopri di più su questo parametro nel nostro Help Center - 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 crescentedesc- i risultati vengono ordinati in ordine decrescente
il tipo di ordinamento si imposta con una virgola
esempio:["rating.value,desc"]nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
per separare più regole di ordinamento usare una virgola
esempio:["rating.value,desc","rating.votes_count,desc"] - 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 - titleTipo: string | null
titolo dell'elemento nella SERP
campo facoltativo
il nome dell'entità aziendale per cui vengono raccolti i risultati;
può contenere fino a 200 caratteri
- Tipo: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo200
- 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_BusinessDataBusinessListingsSearchLiveTaskInfo
- 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
- countTipo: integer | null Formato: int64
tipi di elemento
il numero di elementi nell'arrayitems - itemsTipo: array (object | null)[] | null
tipi di elemento rilevati
tipi di risultati di ricerca presenti nell'arrayitems;
tipi di elemento possibili:business_listing- additionalTipo: array (string | null)[] | null
_categories categorie di attività aggiuntive
categorie Google My Business aggiuntive che descrivono in modo più dettagliato i servizi forniti dall'entità aziendale - addressTipo: string | null
indirizzo dell'azienda
- addressTipo: object | null · Response36Afe1097B20_AddressInfo
_info oggetto contenente i componenti dell'indirizzo dell'azienda
- addressTipo: string | null
indirizzo stradale dell'esercizio locale
- boroughTipo: string | null
unità amministrativa o distretto a cui appartiene l'esercizio locale
- cityTipo: string | null
nome della città in cui si trova l'esercizio locale
- countryTipo: string | null
_code codice paese ISO dell'esercizio locale
- regionTipo: string | null
regione DMA a cui appartiene l'esercizio locale
- zipTipo: string | null
codice postale dell'esercizio locale
- attributesTipo: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
dettagli del servizio sotto forma di controlli recensiti dagli utenti;
dettagli del servizio di un'azienda visualizzati sotto forma di controlli e basati sul feedback degli utenti e sullacategorydell'azienda- availableTipo: object | null
_attributes attributi disponibili
indica gli attributi che un'entità aziendale può offrire- propertyTipo: array (string | null)[] | null
Name
- unavailableTipo: object | null
_attributes attributi non disponibili
indica gli attributi che un'entità aziendale non può offrire- propertyTipo: array (string | null)[] | null
Name
- categoryTipo: string | null
categoria di attività
categoria generale di Google My Business che descrive al meglio i servizi forniti dall'entità aziendale - categoryTipo: array (string | null)[] | null
_ids ID globali delle categorie
ID di categoria universali che non cambiano in base al paese selezionato - checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati - cidTipo: string | null
- contactTipo: array (object | null)[] | null
_info contatti disponibili dell'attività
elenco dei contatti per interagire con l'attività- sourceTipo: string | null
origine dei dati
- typeTipo: string | null
tipo di elemento
- valueTipo: string | null
il valore della valutazione
- descriptionTipo: string | null
descrizione dell'elemento in SERP
la descrizione dell'azienda per cui vengono raccolti i risultati - domainTipo: string | null
dominio dell'entità aziendale
- featureTipo: string | null
_id - firstTipo: string | null
_seen data e ora in cui il nostro crawler ha trovato per la prima volta la scheda dell'attività
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2023-03-11 10:04:11 +00:00 - hotelTipo: integer | null
_rating - isTipo: boolean | null
_claimed indica se l'attività è stata verificata dal proprietario su Google Maps
- lastTipo: string | null
_updated _time data e ora dell'ultimo aggiornamento dei dati
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2023-01-26 09:03:15 +00:00 - latitudeTipo: number | null
coordinata di latitudine delle strutture locali in Google Maps
esempio:"latitude": 51.584091 - localTipo: array (object | null)[] | null
_business _links interazioni disponibili con l'attività
elenco di opzioni per interagire direttamente con l'attività dai risultati di ricerca- typeTipo: string | null
tipo di elemento
- logoTipo: string | null
URL del logo presente nel profilo Google My Business
- longitudeTipo: number | null
coordinata di longitudine della struttura locale in Google Maps
esempio:"longitude": -0.31365919999999997 - mainTipo: string | null
_image URL dell'immagine principale presente nel profilo Google My Business
- originalTipo: string | null
_title titolo originale dell'elemento
titolo originale non tradotto da Google - peopleTipo: array (object | null)[] | null
_also _search entità aziendali correlate
- cidTipo: string | null
- featureTipo: string | null
_id - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
la valutazione dell'elemento
il tasso di popolarità basato sulle recensioni e visualizzato nella SERP- 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
- titleTipo: string | null
titolo dell'elemento in SERP
il nome dell'entità aziendale per cui vengono raccolti i risultati
- phoneTipo: string | null
numero di telefono dell'entità aziendale
- placeTipo: string | null
_id identificatore univoco del luogo
place ID dell'attività locale mostrata nell'elemento
scopri di più sull'identificatore in questo articolo del centro assistenza - placeTipo: object | null
_topics keyword menzionate nelle recensioni dei clienti
contiene le keyword più diffuse relative a prodotti/servizi menzionati nelle recensioni dei clienti di un'entità aziendale e il numero di recensioni che menzionano ciascuna keyword
esempio:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- popularTipo: object | null · Response36Afe1097B20_PopularTimes
_times orari di maggiore affluenza
informazioni sugli orari di punta dell'entità aziendale- popularTipo: object | null
_times _by _days orari di punta
informazioni sugli orari di maggiore affluenza dell'attività locale per ogni giorno della settimana- propertyTipo: array (object | null)[] | null
Name orari di lavoro la domenica
- popularTipo: integer | null
_index indice di popolarità indice di popolarità relativo e legato al tempo, misurato da 0 a 100; un valore più alto corrisponde a un momento della giornata più affollato
- timeTipo: object | null · Response36Afe1097B20_TimeInfo
ore nel formato a 24 ore
- hourTipo: integer | null
ore nel formato a 24 ore
- minuteTipo: integer | null
minuti
- priceTipo: string | null
_level livello di prezzo della struttura
può assumere i valori:inexpensive,moderate,expensive,very_expensive
se non sono disponibili informazioni sul livello di prezzo, il valore sarànull - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
la valutazione dell'elemento
il tasso di popolarità basato sulle recensioni e visualizzato nella SERP- ratingTipo: number | null Formato: double
_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
- ratingTipo: object | null
_distribution la distribuzione delle valutazioni dell'entità aziendale
l'oggetto mostra il numero di valutazioni da 1 a 5 stelle, come recensite dagli utenti- propertyTipo: integer | null Formato: Int64
Name
- servicesTipo: array (object | null)[] | null
- categoryTipo: string | null
categoria di attività
categoria generale di Google My Business che descrive al meglio i servizi forniti dall'entità aziendale - 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
- snippetTipo: string | null
informazioni aggiuntive sull'entità aziendale
- titleTipo: string | null
titolo dell'elemento in SERP
il nome dell'entità aziendale per cui vengono raccolti i risultati
- snippetTipo: string | null
informazioni aggiuntive sull'entità aziendale
- titleTipo: string | null
titolo dell'elemento in SERP
il nome dell'entità aziendale per cui vengono raccolti i risultati - totalTipo: integer | null Formato: int64
_photos numero totale di immagini presenti nel profilo Google My Business
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL assoluto dell'entità aziendale
- workTipo: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time dettagli sugli orari di lavoro
informazioni sugli orari di apertura dell'entità aziendale- workTipo: object | null · Response36Afe1097B20_WorkHours
_hours orari di apertura
informazioni sugli orari di lavoro della struttura locale- currentTipo: string | null
_status stato attuale della struttura
indica se la struttura è aperta o chiusa - timetableTipo: object | null
orario di lavoro
- propertyTipo: array (object | null)[] | null
Name orari di lavoro la domenica
- closeTipo: object | null · Response36Afe1097B20_TimeInfo
orario di chiusura
- hourTipo: integer | null
ore nel formato a 24 ore
- minuteTipo: integer | null
minuti
- openTipo: object | null · Response36Afe1097B20_TimeInfo
orario di apertura
- hourTipo: integer | null
ore nel formato a 24 ore
- minuteTipo: integer | null
minuti
- offsetTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- offsetTipo: string | null
_token - totalTipo: integer | null Formato: int64
_count numero 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/business_data/business_listings/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_coordinate": "53.476225,-2.243572,10",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 3
}
]'
{
"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": [
{
"total_count": null,
"count": null,
"offset": null,
"offset_token": null,
"items": [
{
"type": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"rating_type": "[Max Depth Exceeded]",
"value": "[Max Depth Exceeded]",
"votes_count": "[Max Depth Exceeded]",
"rating_max": "[Max Depth Exceeded]"
},
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"contact_info": [
"[Max Depth Exceeded]"
],
"check_url": null,
"last_updated_time": null,
"first_seen": null,
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}