DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Trustpilot-zoeken: taak indienen
Zet Trustpilot-bedrijven die bij een zoekopdracht passen in de wachtrij – zo vind je de ID die het reviews-endpoint nodig heeft – 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_trustpilot_search_fetch; reviews komen van 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.
- Type: array (object | null)[]
- depthType: integer | null
parseerdiepte
optioneel veld
aantal zoekresultaten dat in de API-respons wordt geretourneerd
we raden sterk aan de parseerdiepte in veelvouden van twintig in te stellen, omdat onze systemen twintig zoekresultaten achter elkaar verwerken;
standaardwaarde:10;
maximale waarde:140
uw account wordt gefactureerd per SERP met maximaal 10 resultaten;
een diepte boven 10 kan extra kosten veroorzaken als de zoekmachine meer dan 10 resultaten retourneert;
de kosten kunnen worden berekend op de pagina Pricing. - keywordType: string
keyword
verplicht veld
het opgegeven keyword moet een bedrijfscategorie of bedrijfsnaam aanduiden;
u kunt maximaal 700 tekens opgeven in het veldkeyword;
alle %## worden gedecodeerd (het teken ‘+’ wordt bovendien gedecodeerd naar een spatie);
als u het teken ‘%’ nodig hebt voor uwkeyword, geeft u het op als ‘%25’meer informatie over regels en beperkingen voor de velden
keywordenkeywordsin DataForSEO-API's vindt u in dit Help Center-artikel - pingbackType: string | null
_url meldings-URL van een voltooide taak
optioneel veld
wanneer een taak is voltooid, melden wij u dit via een GET-verzoek naar de URL die u hebt opgegeven
u kunt de tekenreeks ‘$id’ als$id-variabele en ‘$tag’ als URL-gecodeerde$tag-variabele gebruiken. Wij stellen de benodigde waarden in voordat we het verzoek versturen.
voorbeeld:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Let op: speciale tekens inpingback_urlworden URL-gecodeerd;
d.w.z. het teken#wordt gecodeerd als%23 - postbackType: string | null
_url URL voor het verzenden van taakresultaten
optioneel veld
zodra de taak is voltooid, sturen wij een POST-verzoek met de resultaten, gecomprimeerd in de indelinggzip, naar de door u opgegevenpostback_url
u kunt de tekenreeks ‘$id’ gebruiken als$id-variabele en ‘$tag’ als url-gecodeerde$tag-variabele. Wij stellen de benodigde waarden in voordat het verzoek wordt verzonden.
voorbeeld:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Let op: speciale tekens inpostback_urlworden url-gecodeerd;
zo wordt het teken#gecodeerd als%23 - priorityType: integer | null
- tagType: 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 waardetagvind je in hetdata-object van de respons
- Type: object | null · Response36Afe1097B20_BusinessDataTrustpilotSearchTaskPostResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_BusinessDataTrustpilotSearchTaskPostTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: object | null
array van resultaten
in dit geval is de waardenull - resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/trustpilot/search/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "pizza restaurant",
"depth": 20
}
]'
{
"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
}
]
}