v0.2.0-beta

OpenAPI 3.1.0

Tripadvisor-reviews: taak indienen

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

post/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post

Tripadvisor-reviews: taak indienen

Zet Tripadvisor-reviews voor één vermelding in de wachtrij en retourneert een taak-id. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Ophalen met get_dataforseo_business_tripadvisor_reviews_fetch; het Trustpilot-equivalent is post_dataforseo_business_trustpilot_reviews_submit.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.2428.
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.

Body

application/json

Type: array (object | null)[]
- depth
  Type: integer | null
  
  parsediepte
  optioneel veld
  aantal reviews in de SERP;
  we raden sterk aan de parsediepte in veelvouden van tien in te stellen, omdat onze systemen tien reviews achter elkaar verwerken;
  standaardwaarde: 10;
  maximale waarde: 4490
  uw account wordt gefactureerd per SERP met maximaal 10 resultaten;
  een diepte boven 10 kan extra kosten opleveren als de zoekmachine meer dan 10 resultaten retourneert;
  de kosten kunt u berekenen op de pagina Pricing.
- keyword
  Type: string
  
  keyword
  verplicht veld als u url_path niet opgeeft
  het opgegeven keyword moet de naam aanduiden van een bestaand bedrijf of een bekende plaats op Tripadvisor;
  u kunt tot 700 tekens in het veld keyword opgeven;
  alle %## worden gedecodeerd (het teken ‘+’ wordt daarbij gedecodeerd naar een spatie);
  als u het teken “%” in uw keyword wilt gebruiken, geeft u het op als “%25”
- language_code
  Type: string | null
  
  taalcode van de zoekmachine
  optioneel veld
  als u dit veld gebruikt, wordt er één extra verzoek op uw account in rekening gebracht
  de lijst met beschikbare talen met language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/tripadvisor/languages
  voorbeeld:
  en
  Voor het instellen van een taalparameter in dit endpoint worden extra kosten in rekening gebracht.
  de kosten kunt u berekenen op de pagina Pricing.
- language_name
  Type: string | null
  
  volledige naam van de taal van de zoekmachine
  optioneel veld
  als u dit veld gebruikt, wordt er één extra verzoek op uw account in rekening gebracht
  de lijst met beschikbare talen met language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/tripadvisor/languages
  voorbeeld:
  English
  Voor het instellen van een taalparameter in dit endpoint worden extra kosten in rekening gebracht.
  de kosten kunt u berekenen op de pagina Pricing.
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als u location_name of url_path niet opgeeft
  de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/tripadvisor/locations
  voorbeeld:
  1003854
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als u location_code of url_path niet opgeeft
  de lijst met beschikbare locaties met location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/tripadvisor/locations
  voorbeeld:
  London,England,United Kingdom
- months
  Type: array string[] | null
  
  filteren op maanden waarin een reiziger een bezoek heeft gebracht
  optioneel veld
  mogelijke waarden: january, february, march, april, may, april, june, july, august, september, october, november, december
  u kunt meerdere waarden tegelijk opgeven
- pingback_url
  Type: string | null
  
  meldings-URL van een voltooide taak
  optioneel veld
  wanneer een taak is voltooid, melden we je dit via een GET-verzoek naar de URL die je hebt opgegeven
  je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
  voorbeeld:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Let op: speciale tekens in pingback_url worden URL-gecodeerd;
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vind je in ons Help Center
- postback_url
  Type: string | null
  
  URL voor het verzenden van taakresultaten
  optioneel veld
  zodra de taak is voltooid, sturen we een POST-verzoek met de resultaten gecomprimeerd in gzip-formaat naar de opgegeven postback_url
  je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
  voorbeeld:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Let op: speciale tekens in postback_url worden URL-gecodeerd;
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vind je in ons Help Center
- priority
  Type: integer | null
  
  taakprioriteit
  optioneel veld
  kan de volgende waarden hebben:
  1 – normale uitvoeringsprioriteit (standaard ingesteld)
  2 – hoge uitvoeringsprioriteit. Voor taken met hoge uitvoeringsprioriteit worden extra kosten in rekening gebracht.
  de kosten kunnen worden berekend op de pagina Pricing.
- ratings
  Type: array string[] | null
  
  Tripadvisor-reizigersbeoordeling voor een bezienswaardigheid
  optioneel veld
  beoordeling op basis van de geschreven reviews van een reiziger na een bezoek aan een plaats.
  mogelijke waarden: excellent, very_good, average, poor, terrible
  u kunt meerdere waarden tegelijk opgeven
- sort_by
  Type: string | null
  
  sorteerparameters voor resultaten
  optioneel veld
  u kunt dit veld gebruiken om de resultaten te sorteren;
  mogelijke sorteertypen:
  most_recent
  detailed_reviews
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taak-ID
  optioneel veld
  de tekenslimiet is 255
  je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  de opgegeven waarde tag vind je in het data-object van de respons
- translate_reviews
  Type: boolean | null
  
  reviews vertalen op basis van het URL-pad
  optioneel veld
  als dit op true is ingesteld, worden geretourneerde reviews vertaald naar de taal die overeenkomt met het opgegeven url_path;
  als url_path bijvoorbeeld tripadvisor.it bevat en translate_reviews true is, worden reviews naar het Italiaans vertaald;
  standaardwaarde: true
  meer informatie over het vertalen van reviews vindt u in dit Help Center-artikel
- url_path
  Type: string
  
  URL-pad van de bedrijfsentiteit
  verplicht veld als u keyword niet opgeeft
  URL-pad naar de Tripadvisor-pagina van de bedrijfsentiteit;
  voorbeelden:
  Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html
  https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html
- visit_type
  Type: array string[] | null
  
  filter op type reizigers dat een beoordeling heeft achtergelaten
  optioneel veld
  mogelijke waarden: families, couples, solo, business, friends
  u kunt meerdere waarden tegelijk opgeven

Responsen

200
Type: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo
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_BusinessDataTripadvisorReviewsTaskPostTaskInfo
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: object | null

array van resultaten
in dit geval is de waarde null

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

post/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
    "location_code": 1003854,
    "pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
    "tag": "some_string_123"
  }
]'

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": null
    }
  ]
}

Geslaagde bewerking

Tripadvisor-reviews: taak indienen

AuthenticatieRequired

DataForSEO

Tripadvisor-reviews: taak indienen

Prijsreferentie