Skip to content
Scrappa Get API key
Tiki API 1 credit / request

Tiki Product API Documentation

GET https://scrappa.co/api/tiki/product

Tiki Product API returns one Tiki product: name, brand, description, price, original price and discount, rating, review and sold counts, availability, the full-size image gallery, specifications, configurable options and products, the current seller and other sellers, categories and breadcrumbs.

Send the id from search, or a Tiki product page url. The optional spid is the seller product id from search; pass it unchanged because it changes the buybox seller and price.

Prices are VND numbers and images are full-size URLs. A product Tiki has removed answers 404 and is free. Costs 1 credit per successful request. Failed requests are free.

Tiki Product API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/tiki/product
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "data": {
        "id": "278628812",
        "name": "Example phone",
        "price": 12500000,
        "images": [
            "https://salt.tikicdn.com/media/catalog/product/example.jpg"
        ],
        "currency": "VND",
        "discount": 1500000,
        "brand_name": "Example",
        "categories": [],
        "breadcrumbs": [],
        "review_count": 213,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

3 optional filters available.

id integer Optional

Product id from search, for example 278628812. Send id or url.

Example value 1234567890
url string Optional
Open example

Tiki product page url, for example https://tiki.vn/example-p278628812.html. Send id or url.

Example value https://example.com/product
spid integer Optional

Seller product id from search, for example 278630772. Pass it unchanged.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "id": "278628812",
        "name": "Example phone",
        "price": 12500000,
        "images": [
            "https://salt.tikicdn.com/media/catalog/product/example.jpg"
        ],
        "currency": "VND",
        "discount": 1500000,
        "brand_name": "Example",
        "categories": [],
        "breadcrumbs": [],
        "review_count": 213,
        "discount_rate": 10.7,
        "other_sellers": [],
        "current_seller": {
            "id": 1,
            "name": "Tiki",
            "price": 12500000
        },
        "original_price": 14000000,
        "rating_average": 4.8,
        "specifications": [
            {
                "name": "Screen",
                "value": "6.5 inch"
            }
        ],
        "inventory_status": "in_stock",
        "configurable_options": [],
        "configurable_products": []
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

404

Not Found

The product does not exist on Tiki. This response is not billable.

{
    "meta": {
        "credits": 0,
        "billable": false,
        "retryable": false,
        "endpoint_family": "product"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested product was not found."
    },
    "success": false
}
422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "id": [
            "A product id or a product url is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

Tiki could not be reached. This response is not billable.

{
    "meta": {
        "credits": 0,
        "billable": false,
        "retryable": true,
        "endpoint_family": "product"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Tiki could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.