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

Tiki Search API Documentation

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

Tiki Search API searches products on Tiki in Vietnam. Each card has the id, sku, name, brand, price, original price, list price, discount amount and rate, rating, review count, sold count, seller ids, full-size image and product url.

Filter by price range, brand id, rating, sort order and category id. Get category ids from the Categories API and brand ids from data.filters.brands of an earlier search. Every item in the answer follows the filters you send. Page N returns the real page N with 40 results per page, up to page 50.

Prices are numbers in VND. The id and seller product id feed the Product and Reviews APIs unchanged. Costs 1 credit per successful request. Empty results and failed requests are free.

Tiki Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/tiki/search
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "data": {
        "query": "dien thoai",
        "filters": {
            "sorts": [
                "default",
                "top_seller",
                "newest",
                "price,asc",
                "price,desc"
            ],
            "brands": [
                {
                    "id": "42",
...

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.

8 optional filters available.

query string Optional

Search text, for example dien thoai. Required unless you send a category.

Example value coffee shops
category integer Optional

Category id from the Categories API. Required unless you send a query.

Example value 10
page integer Optional

One-based page number, 1 to 50 (default 1).

Example value 1
sort string Optional

One of default, top_seller, newest, price_asc or price_desc.

Example value relevance
min_price number Optional

Lowest price in VND.

Example value 10
max_price number Optional

Highest price in VND.

Example value 10
brand integer Optional

Brand id.

Example value 10
rating integer Optional

Minimum rating, 1 to 5.

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": {
        "query": "dien thoai",
        "filters": {
            "sorts": [
                "default",
                "top_seller",
                "newest",
                "price,asc",
                "price,desc"
            ],
            "brands": [
                {
                    "id": "42",
                    "name": "Example"
                }
            ],
            "categories": [
                {
                    "id": "1789",
                    "name": "Dien thoai"
                }
            ]
        },
        "results": [
            {
                "id": "278628812",
                "sku": "SKU-123",
                "name": "Example phone",
                "price": 12500000,
                "brand_id": 42,
                "currency": "VND",
                "discount": 1500000,
                "url_path": "https://tiki.vn/example-p278628812.html",
                "seller_id": 1,
                "brand_name": "Example",
                "list_price": 15000000,
                "availability": true,
                "review_count": 213,
                "discount_rate": 10.7,
                "quantity_sold": 1200,
                "thumbnail_url": "https://salt.tikicdn.com/ts/product/example.jpg",
                "original_price": 14000000,
                "rating_average": 4.8,
                "seller_product_id": 278630772
            }
        ],
        "category": null,
        "currency": "VND",
        "pagination": {
            "page": 1,
            "has_next": true,
            "per_page": 40,
            "total_results": 5000
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

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

422

Validation Error

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

{
    "errors": {
        "query": [
            "A search text or a category id is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

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

{
    "meta": {
        "credits": 0,
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "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.