Product details

Create a task#

POST Request#

You need a simple POST Request with task details like ASIN and marketplace to create a job - max. 1000 task within one job.

curl -X POST 'https://api.sellytics.com/jobs/v1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your-access-token>'
--data-raw '{
    "callbackUrl": "https://your-service.io/job-is-ready/{{jobID}}",
    "tasks": [
        {
            "type": "IDEALO_PRODUCT_DETAIL_TASK",
            "productId": "200248318",
            "marketplace": "DE"
        }
    ]
}'

Note: Use our callback mechanism which send you a callback webhook when your job is done. Optional: Put {{jobID}} in your CallBack-URL, it will be replaced with corresponding JobID.

Response#

You get the data of the created job as response, incl. a simple cost summary.

{
    "id": "b1ec9szd582343bc970b681ba2f4ca16",
    "dateCreated": "2021-03-05T16:21:54.825256Z",
    "callbackUrl": "https://your-service.io/job-is-ready/b1ec9szd582343bc970b681ba2f4ca16",
    "status": {
        "statusCode": "CREATED",
        "message": "Job was created and queued.",
        "date": "2021-03-05T16:21:54.825554Z"
    },
    "summary": {
        "tasks": 1,
        "costs": 10,
        "taskTypes": {
            "IDEALO_PRODUCT_DETAIL_TASK": 1
        }
    }
}

Note: Billing type is IDEALO_PRODUCT_DETAIL_TASK

Reference#

For more details see documentation.

Get your task result#

GET Request#

curl --location --request GET 'https://api.sellytics.com/jobs/b1ec9szd582343bc970b681ba2f4ca16/task-results/v1' \
--header 'Authorization: Bearer <your-access-token>'

Note: Fetching the task result data does not incur any further costs, furthermore the task result ist stored for 48 h. Afterwards you can fetch the cached product data (billing type IDEALO_PRODUCT_DETAIL_VIEW)

Response with list of resulting task results#

{
    "content": [
        {
            "id": "c5ea03687bae44c4a239c4f400644c81",
            "jobId": "470f1ff326994528828e32ef20f535a4",
            "taskId": "c5ea03687bae44c4a239c4f400644c81",
            "dateCreated": "2021-03-05T16:23:25.311Z",
            "content":     {
                "productId": "200248318",
                "marketplace": "DE",
                "title": "Apple iPhone SE (2020)",
                "variantTitle": "64GB Black",
                "categoryId": 19116,
                ...
            }
        }
    ]
}

Reference#

For more details see documentation.

Get cached product data#

GET Request#

curl -X GET 'https://api.sellytics.com/idealo/products/DE/200248318/v1' \
--header 'accept: application/json' \
--header 'Authorization: Bearer <your-access-token>'

Example response#

{
    "productId": "200248318",
    "marketplace": "DE",
    "title": "Apple iPhone SE (2020)",
    "variantTitle": "64GB Black",
    "categoryId": 19116,
    ...
}

Reference#

For more details see documentation.