v0.2.0-beta

OpenAPI 3.1.0

Tripadvisor-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/tripadvisor/reviews/task_get/{id}

Tripadvisor-reviews: resultaten op id ophalen

Haalt Tripadvisor-reviews voor één accommodatie 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_BusinessDataTripadvisorReviewsTaskGetResponseInfo
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_BusinessDataTripadvisorReviewsTaskGetTaskInfo
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

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

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

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

date_of_visit
Type: string | null

datum van het bezoek van de recensent aan de lokale vestiging
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

language
Type: string | null

taal van de reviewtekst

original_language
Type: string | null

taal van de niet-vertaalde reviewtekst

position
Type: string | null

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

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

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

bevat informatie over de reactie van de eigenaar

text
Type: string | null

de inhoud van de respons

timestamp
Type: string | null

het moment van publicatie

title
Type: string | null

de titel van de respons

review_highlights
Type: object | null

hoogtepunten van de review
bevat uitgelichte reviewcriteria en -beoordelingen

review_id
Type: string | null

ID van de review

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

bevat URL's van de afbeeldingen die in de review zijn gebruikt

url
Type: string | null

URL van de afbeelding die in de review wordt gebruikt

review_text
Type: string | null

inhoud van de review

timestamp
Type: string | null

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

title
Type: string | null

titel van de review

type
Type: string | null

elementtype

url
Type: string | null

URL van de review

user_profile
Type: object | null · Response36Afe1097B20_BusinessDataUserProfileInfo

informatie uit het profiel van de recensent

image_url
Type: string | null
location
Type: string | null
name
Type: string | null
reviews_count
Type: integer | null Formaat: int64

totaal aantal beoordelingen dat door de beoordelaar is ingediend

url
Type: string | null
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

language_code
Type: string | null

Taalcode in een POST-array

location
Type: string | null

locatie van de lokale vestiging
adres van de lokale vestiging waarvoor de beoordelingen worden verzameld

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

rating_distribution
Type: object | null

beoordelingsverdeling per stem
de verdeling van stemmen over de beoordeling in het bereik van 1 tot 5

propertyName
Type: integer | null Formaat: Int64
reviews_count
Type: integer | null Formaat: int64

het totale aantal reviews

se_domain
Type: string | null

zoekmachinedomein in een POST-array

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

url_path
Type: string | null

URL-pad ontvangen in een POST-array

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/tripadvisor/reviews/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/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": [
        {
          "url_path": null,
          "type": null,
          "se_domain": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "location": null,
          "reviews_count": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "rating_distribution": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "date_of_visit": null,
              "timestamp": null,
              "review_id": null,
              "title": null,
              "review_text": null,
              "language": null,
              "original_language": null,
              "review_images": [
                "[Max Depth Exceeded]"
              ],
              "user_profile": "[Max Depth Exceeded]",
              "responses": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": null
            }
          ],
          "language_code": null
        }
      ]
    }
  ]
}

Geslaagde bewerking

Tripadvisor-reviews: resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Tripadvisor-reviews: resultaten op id ophalen

Prijsreferentie