v0.2.0-beta

OpenAPI 3.1.0

Google-reviews: resultaten op id ophalen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

get/v1/beta/dataforseo/business_data/google/reviews/task_get/{id}

Google-reviews: resultaten op id ophalen

Haalt Google-bedrijfsprofiel-reviews uit de wachtrij op basis van id op. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ De omvang schaalt met de diepte die bij het indienen is ingesteld en kan hier niet worden beperkt.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Padparameters

id
Type: string
verplicht

taak-ID
unieke taak-ID in ons systeem in UUID-formaat
je kunt deze 30 dagen lang gebruiken om op elk moment de resultaten van de taak op te vragen

Responsen

200
Type: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskGetResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskGetTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd

cid
Type: string | null

door Google gedefinieerde client-id
unieke id van een lokale vestiging
lees meer over de id in dit Help Center-artikel

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

feature_id
Type: string | null

de unieke id van het element 'reviews' in de SERP
lees meer over de id in dit Help Center-artikel

items
Type: array (object | null)[] | null

gevonden beoordelingen
u kunt meer resultaten krijgen met de parameter depth bij het instellen van een taak

images
Type: array (object | null)[] | null

door de reviewer ingediende afbeeldingen

alt
Type: string | null

alt-tag van de afbeelding

image_url
Type: string | null

URL van de afbeelding
de URL die naar de afbeelding leidt op de oorspronkelijke bron of in de DataForSEO-opslag (als de oorspronkelijke bron niet beschikbaar is)

type
Type: string | null

elementtype

url
Type: string | null

relevante URL

local_guide
Type: boolean | null

geeft aan of de reviewer de status 'local guide' heeft

original_language
Type: string | null

oorspronkelijke taal van de reviewtekst

original_owner_answer
Type: string | null

oorspronkelijke tekst van de reactie van de eigenaar
de oorspronkelijke reactie op de review, zonder automatische vertaling

original_review_text
Type: string | null

oorspronkelijke inhoud van de review
de oorspronkelijke inhoud van de review, zonder automatische vertaling

owner_answer
Type: string | null

tekst van de reactie van de eigenaar
de reactie van de eigenaar op de review

owner_time_ago
Type: string | null

publicatietijd
geeft de tijd (in het formaat 'time ago') aan waarop de eigenaar de reactie op de review heeft ingediend

owner_timestamp
Type: string | null

datum en tijd van de reactie van de eigenaar op de review
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

photos_count
Type: integer | null Formaat: int64

totaal aantal door de reviewer ingediende foto's

position
Type: string | null

de uitlijning van de review in SERP
kan de volgende waarden aannemen: right

profile_image_url
Type: string | null

URL van de profielafbeelding van de reviewer

profile_name
Type: string | null

profielnaam van de reviewer

profile_url
Type: string | null

URL van het profiel van de reviewer

rank_absolute
Type: integer | null

absolute rang onder alle vermelde reviews
absolute positie onder alle reviews in de lijst

rank_group
Type: integer | null

positie binnen een groep elementen met identieke type-waarden
posities van elementen met verschillende type-waarden worden weggelaten uit rank_group

rating
Type: object | null · Response36Afe1097B20_RatingInfo

de beoordeling die door de recensent is ingediend

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

review_highlights
Type: array (object | null)[] | null

hoogtepunten van de review
bevat uitgelichte reviewcriteria en -beoordelingen

assessment
Type: string | null

kenmerkbeoordeling

feature
Type: string | null

beoordeeld kenmerk

review_id
Type: string | null

de unieke identificatie van een review op Google
voorbeeld:
ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

review_text
Type: string | null

de inhoud van de review

review_url
Type: string | null

de URL van de review

reviews_count
Type: integer | null Formaat: int64

totaal aantal beoordelingen dat door de beoordelaar is ingediend

time_ago
Type: string | null

het publicatiemoment
geeft de tijd (in het formaat 'time ago') aan waarop de review is vermeld

timestamp
Type: string | null

datum en tijd waarop een review is gepubliceerd
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

type
Type: string | null

elementtype

xpath
Type: string | null

de XPath van de review

items_count
Type: integer | null Formaat: int64

het aantal beoordelingsitems in de resultatenarray
u kunt meer resultaten krijgen met de parameter depth bij het instellen van een taak

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; het plusteken '+' wordt gedecodeerd naar een spatie)

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

place_id
Type: string | null

door Google toegewezen unieke id van een bedrijfslocatie
lees meer over de id in dit Help Center-artikel

rating
Type: object | null · Response36Afe1097B20_RatingInfo

beoordeling van de betreffende lokale vestiging
populariteitsscore op basis van beoordelingen, weergegeven in de SERP

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

reviews_count
Type: integer | null Formaat: int64

het totale aantal reviews

se_domain
Type: string | null

zoekmachinedomein in een POST-array

sub_title
Type: string | null

ondertitel van het element 'reviews' in de SERP
aanvullende informatie (bijv. adres) over het element 'reviews' waarvoor de beoordelingen worden verzameld

title
Type: string | null

titel van het element 'reviews' in de SERP
de naam van de lokale vestiging waarvoor de beoordelingen worden verzameld

type
Type: string | null

elementtype

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

application/json

get/v1/beta/dataforseo/business_data/google/reviews/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Schema tonen

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "sub_title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "feature_id": null,
          "place_id": null,
          "cid": null,
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "review_text": null,
              "original_review_text": null,
              "original_language": null,
              "time_ago": null,
              "timestamp": null,
              "rating": "[Max Depth Exceeded]",
              "reviews_count": null,
              "photos_count": null,
              "local_guide": null,
              "profile_name": null,
              "profile_url": null,
              "review_url": null,
              "profile_image_url": null,
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null,
              "review_id": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Google-reviews: resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Google-reviews: resultaten op id ophalen

Prijsreferentie