Tâches de recherche de fiches d'entreprises en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tâches de recherche de fiches d'entreprises en temps réel
Recherche dans l'index propre à DataForSEO des fiches d'entreprises locales par categories, description, title et location_coordinate : un triplet latitude, longitude et rayon. Renvoie total_count, count, offset, offset_token et items, paginés avec le jeton. Enveloppé dans l'enveloppe DataForSEO : données dans tasks[0].result, résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Ceci lit un index et répond immédiatement ; tout le reste ici met en file un scraping en direct de la source. Commencez par ceci et n'approfondissez que là où cela compte.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.2428.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- categoriesType: array string[] | null
catégories d'entreprises
champ facultatif
les catégories que vous indiquez servent à rechercher des fiches d'établissements ;
si vous n'utilisez pas ce champ, nous renvoyons les fiches d'établissements trouvées dans la localisation indiquée ;
vous pouvez indiquer jusqu'à 10 catégories - descriptionType: string | null
description de l'élément dans le SERP
champ facultatif
la description de l'entité commerciale pour laquelle les résultats sont collectés ;
peut contenir jusqu'à 200 caractères - filtersType: array (object | null)[] | null
tableau de paramètres de filtrage des résultats
champ facultatif
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
définissez un opérateur logiqueandouorentre les conditions
les opérateurs suivants sont pris en charge :regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro caractère ou plus
exemple :["rating.value",">",3]
vous pouvez obtenir la liste des filtres disponibles en effectuant une requête distincte vershttps://api.dataforseo.com/v3/business_data/business_listings/available_filters
La liste complète des filtres possibles est disponible ici.Objet vide - isType: boolean | null
_claimed indique si l'établissement a été vérifié par son propriétaire sur Google Maps
champ facultatif - limitType: integer | null
le nombre maximal d'entreprises renvoyées
champ facultatif
valeur par défaut :100
valeur maximale :1000 - locationType: string | null
_coordinate coordonnées GPS d'une localisation
champ facultatif
le paramètrelocation_coordinatedoit être indiqué au format "latitude,longitude,radius"
le nombre maximal de décimales pour "latitude" et "longitude" : 7
la valeur de "radius" est indiquée en kilomètres (km)
la valeur minimale pour "radius" :1
la valeur maximale pour "radius" :100000
exemple :53.476225,-2.243572,200
en savoir plus sur la définition des paramètres de localisation dans cette API sur notre centre d'aide - offsetType: integer | null
décalage dans le tableau de résultats des entreprises renvoyées
champ facultatif
valeur par défaut :0
si vous indiquez la valeur10, les dix premières entités du tableau de résultats sont omises et les données sont fournies pour les entités suivantes
Remarque : nous recommandons d'utiliser ce paramètre uniquement pour récupérer jusqu'à 10 000 résultats
pour récupérer plus de 10 000 résultats, utilisez plutôtoffset_token - offsetType: string | null
_token jeton pour les requêtes suivantes
champ facultatif
fourni dans le champ identical de la réponse à chaque requête ;
utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de 100 000 résultats en une seule requête ;
en indiquant la valeur uniqueoffset_tokendu tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeursoffset_tokensont uniques pour chaque tâche suivante
Remarque : sioffset_tokenest indiqué dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente
en savoir plus sur ce paramètre dans notre centre d'aide - orderType: array string[] | null
_by règles de tri des résultats
champ facultatif
vous pouvez utiliser les mêmes valeurs que dans le tableaufilterspour trier les résultats
types de tri possibles :asc- les résultats sont triés par ordre croissantdesc- les résultats sont triés par ordre décroissant
utilisez une virgule pour définir un paramètre de tri
exemple :["rating.value,desc"]notez que vous pouvez définir au maximum trois règles de tri dans une même requête
utilisez une virgule pour séparer plusieurs règles de tri
exemple :["rating.value,desc","rating.votes_count,desc"] - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse - titleType: string | null
titre de l'élément dans le SERP
champ facultatif
le nom de l'entité commerciale pour laquelle les résultats sont collectés ;
peut contenir jusqu'à 200 caractères
- Type: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- countType: integer | null Format: int64
types d'éléments
le nombre d'éléments du tableauitems - itemsType: array (object | null)[] | null
types d'éléments rencontrés
types de résultats de recherche trouvés dans le tableauitems;
types d'éléments possibles :business_listing- additionalType: array (string | null)[] | null
_categories catégories d'entreprise supplémentaires
catégories Google My Business supplémentaires qui décrivent plus en détail les services fournis par l'entité commerciale - addressType: string | null
adresse de l'entité commerciale
- addressType: object | null · Response36Afe1097B20_AddressInfo
_info objet contenant les composants d'adresse de l'entité commerciale
- addressType: string | null
adresse de l'établissement local
- boroughType: string | null
unité administrative ou district auquel appartient l'établissement local
- cityType: string | null
nom de la ville où se trouve l'établissement local
- countryType: string | null
_code code ISO du pays de l'établissement local
- regionType: string | null
région DMA à laquelle appartient l'établissement local
- zipType: string | null
code postal de l'établissement local
- attributesType: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
détails du service sous forme de vérifications évaluées par les utilisateurs ;
détails du service d'une entité commerciale affichés sous forme de vérifications et basés sur les retours des utilisateurs et lacategoryde l'entreprise- availableType: object | null
_attributes attributs disponibles
indique les attributs qu'une entité commerciale peut proposer- propertyType: array (string | null)[] | null
Name
- unavailableType: object | null
_attributes attributs indisponibles
indique les attributs qu'une entité commerciale ne peut pas proposer- propertyType: array (string | null)[] | null
Name
- categoryType: string | null
catégorie d'entreprise
catégorie générale Google My Business qui décrit le mieux les services fournis par l'entité commerciale - categoryType: array (string | null)[] | null
_ids ID de catégorie globaux
ID de catégorie universels qui ne changent pas selon le pays sélectionné - checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis - cidType: string | null
- contactType: array (object | null)[] | null
_info contacts disponibles de l'entreprise
liste de contacts pour interagir avec l'entreprise- sourceType: string | null
source de données
- typeType: string | null
type d'élément
- valueType: string | null
la valeur de la note
- descriptionType: string | null
description de l'élément dans la SERP
la description de l'entité commerciale pour laquelle les résultats sont collectés - domainType: string | null
domaine de l'entité commerciale
- featureType: string | null
_id - firstType: string | null
_seen date et heure auxquelles notre robot d'exploration a trouvé l'élément de fiche d'entreprise pour la première fois
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2023-03-11 10:04:11 +00:00 - hotelType: integer | null
_rating - isType: boolean | null
_claimed indique si l'entité est vérifiée par son propriétaire sur Google Maps
- lastType: string | null
_updated _time date et heure de la dernière mise à jour des données
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2023-01-26 09:03:15 +00:00 - latitudeType: number | null
coordonnée de latitude des établissements locaux dans google maps
exemple :"latitude": 51.584091 - localType: array (object | null)[] | null
_business _links interactions disponibles avec l'entreprise
liste des options permettant d'interagir avec l'entreprise directement depuis les résultats de recherche- typeType: string | null
type d'élément
- logoType: string | null
URL du logo présenté dans le profil Google My Business
- longitudeType: number | null
coordonnée de longitude de l'établissement local dans google maps
exemple :"longitude": -0.31365919999999997 - mainType: string | null
_image URL de l'image principale présentée dans le profil Google My Business
- originalType: string | null
_title titre d'origine de l'élément
titre d'origine non traduit par Google - peopleType: array (object | null)[] | null
_also _search entités commerciales associées
- cidType: string | null
- featureType: string | null
_id - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés
- phoneType: string | null
numéro de téléphone de l'entité commerciale
- placeType: string | null
_id identifiant unique du lieu
place id de l'établissement local présenté dans l'élément
en savoir plus sur l'identifiant dans cet article du centre d'aide - placeType: object | null
_topics mots-clés mentionnés dans les avis clients
contient les mots-clés les plus populaires liés aux produits/services mentionnés dans les avis clients d'une entité commerciale, ainsi que le nombre d'avis mentionnant chaque mot-clé
exemple :
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- popularType: object | null · Response36Afe1097B20_PopularTimes
_times heures de forte affluence
informations relatives aux heures de forte affluence de l'entité commerciale- popularType: object | null
_times _by _days heures de forte affluence
informations sur les heures d'affluence de l'établissement local pour chaque jour de la semaine- propertyType: array (object | null)[] | null
Name horaires d'ouverture le dimanche
- popularType: integer | null
_index indice de popularité indice de popularité relatif et limité dans le temps, mesuré de 0 à 100 ; une valeur plus élevée correspond à une heure de la journée plus fréquentée
- timeType: object | null · Response36Afe1097B20_TimeInfo
heures au format 24 heures
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- priceType: string | null
_level niveau de prix de l'établissement
peut prendre les valeurs :inexpensive,moderate,expensive,very_expensive
s'il n'y a pas d'informations sur le niveau de prix, la valeur seranull - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: number | null Format: double
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- ratingType: object | null
_distribution la répartition des notes de l'entité commerciale
l'objet affiche le nombre de notes de 1 à 5 étoiles, selon les avis des utilisateurs- propertyType: integer | null Format: Int64
Name
- servicesType: array (object | null)[] | null
- categoryType: string | null
catégorie d'entreprise
catégorie générale Google My Business qui décrit le mieux les services fournis par l'entité commerciale - priceType: object | null · Response36Afe1097B20_PriceInfo
- currencyType: string | null
devise du prix indiqué code ISO de la devise appliquée au prix
- currentType: number | null Format: double
prix actuel indique le prix actuel du produit ou du service présenté dans le résultat
- displayedType: string | null
_price chaîne de prix dans le résultat chaîne de prix brute telle que fournie dans le résultat
- isType: boolean | null
_price _range le prix est fourni sous forme de fourchette indique si un prix est fourni sous forme de fourchette
- maxType: number | null Format: double
_value le prix maximum le prix maximum du produit ou du service tel qu'indiqué dans le résultat
- regularType: number | null Format: double
prix normal indique le prix normal du produit ou du service sans réduction appliquée
- snippetType: string | null
informations complémentaires sur l'entité commerciale
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés
- snippetType: string | null
informations complémentaires sur l'entité commerciale
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés - totalType: integer | null Format: int64
_photos nombre total d'images présentées dans le profil Google My Business
- typeType: string | null
type d'élément
- urlType: string | null
url absolue de l'entité commerciale
- workType: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time détails des horaires d'ouverture
informations relatives aux horaires d'ouverture de l'entité commerciale- workType: object | null · Response36Afe1097B20_WorkHours
_hours horaires d'ouverture
informations sur les horaires de travail de l'établissement local- currentType: string | null
_status statut actuel de l'établissement
indique si l'établissement est ouvert ou fermé - timetableType: object | null
tableau des horaires d'ouverture
- propertyType: array (object | null)[] | null
Name horaires d'ouverture le dimanche
- closeType: object | null · Response36Afe1097B20_TimeInfo
heure de fermeture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- openType: object | null · Response36Afe1097B20_TimeInfo
heure d'ouverture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- offsetType: integer | null Format: int64
Signed 64-bit integers (long type).
- offsetType: string | null
_token - totalType: integer | null Format: int64
_count nombre total de résultats de notre base de données correspondant à votre requête
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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]"
]
}
]
}
]
}
]
}