# Tiki Product API Documentation

<p><strong>Tiki Product API</strong> 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.</p><p>Send the <code>id</code> from search, or a Tiki product page <code>url</code>. The optional <code>spid</code> is the seller product id from search; pass it unchanged because it changes the buybox seller and price.</p><p>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.</p>

- **Documentation:** [https://scrappa.co/docs/tiki-api/tiki_product](https://scrappa.co/docs/tiki-api/tiki_product)
- **API group:** Tiki API
- **Endpoint:** `GET https://scrappa.co/api/tiki/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | No | Product id from search, for example 278628812. Send id or url. |
| `url` | string | No | Tiki product page url, for example https://tiki.vn/example-p278628812.html. Send id or url. |
| `spid` | integer | No | Seller product id from search, for example 278630772. Pass it unchanged. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The product does not exist on Tiki. This response is not billable. |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | Tiki could not be reached. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
