v0.2.0-beta

OpenAPI 3.1.0

Amazon ASIN-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/merchant/amazon/asin/task_get/advanced/{id}

Amazon ASIN-resultaten op id ophalen

Eén Amazon-productpagina, uit een taak die in de wachtrij is gezet door post_dataforseo_merchant_amazon_asin_submit. Retourneert asin, se_domain, location_code, language_code, check_url, datetime, item_types, items_count en items, waarbij elk item title, details, image_url, author, data_asin, parent_asin en product_asins bevat – het laatste veld is de variantfamilie, waarmee je de andere maten of kleuren vindt. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Gebruik het alleen als het geparseerde resultaat iets mist dat je kunt aanwijzen.

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_MerchantAmazonAsinTaskGetAdvancedResponseInfo
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_MerchantAmazonAsinTaskGetAdvancedTaskInfo
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

asin
Type: string | null

in een POST-array ontvangen ASIN
de unieke productidentificatie bij Amazon (ASIN) die in een POST-array is ontvangen
meer over de identificatie lees je in deze Help Center-gids

check_url
Type: string | null

directe URL naar de Amazon-resultaten
je kunt deze gebruiken om te controleren of we accurate 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

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

soorten zoekresultaten die op Amazon zijn gevonden
bevat de typen van alle zoekresultaten (items) die in de geretourneerde SERP zijn gevonden
mogelijke itemtypen:
amazon_product_info

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

Amazon-productinfo-items

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

array met objecten die informatie bevatten over toepasselijke vouchers

fixed_discount
Type: number | null

waarde van de vaste korting

fixed_discount_currency
Type: string | null

valutacode van de vaste korting

important_details
Type: string | null

belangrijke details over de voorwaarden van kortingsvouchers

percentage_discount
Type: number | null

waarde van de procentuele korting
als de korting vast is, is de waarde null

text
Type: string | null

tekst van de voucher

type
Type: string | null

elementtype

author
Type: string | null

merknaam van het product

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

bevat gerelateerde productcategorieën

category
Type: string | null

naam van de productcategorie

url
Type: string | null

URL van de productcategorie
geeft het browsepad op Amazon aan met de unieke browse-node-id (productcategorie-id op Amazon)

currency
Type: string | null

valuta in het ISO-formaat
voorbeeld:
USD

data_asin
Type: string | null

ASIN van het product dat in een POST-array is ontvangen

description
Type: string | null

bevat de beschrijving van het product

details
Type: string | null

productspecificaties en andere details

image_url
Type: string | null

de URL van de productafbeelding

is_amazon_choice
Type: boolean | null

"Amazon's choice"-label
als de waarde true is, is het product voorzien van het "Amazon's choice"-label

is_available
Type: boolean | null

geeft aan of het product bestelbaar is
als de waarde true is, kan het product worden besteld

is_newer_model_available
Type: boolean | null

geeft aan of het nieuwere model van het product beschikbaar is

is_prime_video
Type: boolean | null

geeft aan of een product een Amazon Prime Video-label heeft
bij true maakt het opgegeven product deel uit van de Amazon Prime Video-dienst

newer_model
Type: object | null · Response36Afe1097B20_NewerModel

informatie over het nieuwere model van het product

newer_model_asin
Type: string | null

ASIN van het nieuwere productmodel

title
Type: string | null

producttitel

parent_asin
Type: string | null

parent-ASIN van het product

percentage_discount
Type: string | null

waarde van de procentuele korting

position
Type: string | null

de uitlijning van het element in de Amazon SERP
mogelijke waarden:
left, right

price_from
Type: number | null

de ondergrens van het productprijsbereik
voorbeeld:
49.98

price_to
Type: number | null

de bovengrens van het productprijsbereik
voorbeeld:
384.99

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

ASIN's van alle gevonden productvarianten

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

bevat URL's voor alle afbeeldingen van het product die links van de hoofdafbeelding worden weergegeven

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

bevat gerelateerde productinformatie

section_name
Type: string | null

naam van de sectie met productinformatie die is opgegeven in contents

type
Type: string | null

elementtype

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

bevat URL's voor alle video's van het product die rechts van de hoofdvideo worden weergegeven

rank_absolute
Type: integer | null

absolute rang
absolute positie onder alle elementen in de responsarray

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_RatingElement

beoordelingsinformatie van het product

position
Type: string | null

de uitlijning van het element in Google Shopping SERP
mogelijke waarden:
left, right

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

type
Type: string | null

elementtype

value
Type: number | null

waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

title
Type: string | null

producttitel

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

array van objecten met topreviews van over de hele wereld

helpful_votes
Type: string | null

aantal nuttige stemmen
aantal gebruikers dat onder de reviewtekst op de knop 'Helpful' heeft geklikt

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

door de reviewer ingediende afbeeldingen van het product

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

position
Type: string | null

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

publication_date
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

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

inhoud van de review

subtitle
Type: string | null

ondertitel van de review

title
Type: string | null

titel van de review

type
Type: string | null

elementtype

url
Type: string | null
user_profile
Type: object | null · Response36Afe1097B20_UserProfileInfo

gebruikersprofiel van de recensent

avatar
Type: string | null
locations
Type: string | null
name
Type: string | null
reviews_count
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

url
Type: string | null

relevante URL

verified
Type: boolean | null

geeft aan of de review de markering "Verified Purchase" heeft

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

door de reviewer ingediende video's van het product

preview
Type: string | null

URL naar de voorbeeldafbeelding van de video

source
Type: string | null

URL naar de videobron

timestamp
Type: string | null

datum en tijd waarop het resultaat 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 een bepaald linkelement

type
Type: string | null

elementtype

url
Type: string | null

bron-URL

xpath
Type: string | null

het XPath van het element

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

array van objecten met topreviews uit de doellocatie

helpful_votes
Type: string | null

aantal nuttige stemmen
aantal gebruikers dat onder de reviewtekst op de knop 'Helpful' heeft geklikt

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

door de reviewer ingediende afbeeldingen van het product

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

position
Type: string | null

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

publication_date
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

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

inhoud van de review

subtitle
Type: string | null

ondertitel van de review

title
Type: string | null

titel van de review

type
Type: string | null

elementtype

url
Type: string | null
user_profile
Type: object | null · Response36Afe1097B20_UserProfileInfo

gebruikersprofiel van de recensent

avatar
Type: string | null
locations
Type: string | null
name
Type: string | null
reviews_count
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

url
Type: string | null

relevante URL

verified
Type: boolean | null

geeft aan of de review de markering "Verified Purchase" heeft

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

door de reviewer ingediende video's van het product

preview
Type: string | null

URL naar de voorbeeldafbeelding van de video

source
Type: string | null

URL naar de videobron

timestamp
Type: string | null

datum en tijd waarop het resultaat 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 een bepaald linkelement

type
Type: string | null

elementtype

url
Type: string | null

bron-URL

xpath
Type: string | null

het XPath van het element

type
Type: string | null

elementtype

xpath
Type: string | null

het XPath van het element

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

se_domain
Type: string | null

Amazon-domein in een POST-array

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/merchant/amazon/asin/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/asin/task_get/advanced/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": [
        {
          "asin": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "title": null,
              "details": null,
              "image_url": null,
              "author": null,
              "data_asin": null,
              "parent_asin": null,
              "product_asins": [
                "[Max Depth Exceeded]"
              ],
              "price_from": null,
              "price_to": null,
              "percentage_discount": null,
              "currency": null,
              "is_amazon_choice": null,
              "rating": "[Max Depth Exceeded]",
              "is_newer_model_available": null,
              "is_prime_video": null,
              "applicable_vouchers": [
                "[Max Depth Exceeded]"
              ],
              "newer_model": "[Max Depth Exceeded]",
              "categories": [
                "[Max Depth Exceeded]"
              ],
              "product_information": [
                "[Max Depth Exceeded]"
              ],
              "product_images_list": [
                "[Max Depth Exceeded]"
              ],
              "product_videos_list": [
                "[Max Depth Exceeded]"
              ],
              "description": null,
              "is_available": null,
              "top_local_reviews": [
                "[Max Depth Exceeded]"
              ],
              "top_global_reviews": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Amazon ASIN-resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Amazon ASIN-resultaten op id ophalen

Prijsreferentie