# Naver Shopping Search API Documentation

<p><strong>Naver Shopping Search API Documentation</strong> Search products on Naver Shopping, South Korea's main shopping search. Return products with the title, the price as a number in KRW, the mall count, the rating and review count as numbers, the category ids and a full size image. Filter by a price range with both bounds, free delivery, review score and delivery speed. Every returned product matches the filters you send. Naver has no date sort and returns one full result set, so page 1 is always served. Sponsored cards are excluded unless allow_ads is true; when included their mall count is null. Each result carries an id from the search. Cost: 1 credit per request. Empty results and failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/naver-shopping-api/naver_shopping_search](https://scrappa.co/docs/naver-shopping-api/naver_shopping_search)
- **API group:** Naver Shopping API
- **Endpoint:** `GET https://scrappa.co/api/naver-shopping/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keyword, for example 노트북. Required. |
| `sort` | string | No | relevance only. Naver has no date sort. |
| `price` | string | No | Two price bounds in KRW separated by a pipe, for example 0\|100000. Both bounds are required. |
| `page` | integer | No | Accepted for compatibility. Naver returns one full result set. |
| `free_delivery` | boolean | No | true to return only free-delivery products. |
| `review_score_low_limit` | number | No | Lowest review score, for example 4.8. |
| `fast_delivery` | boolean | No | true for fast-delivery products. |
| `arrive_guarantee` | boolean | No | true for arrival-guaranteed products. |
| `allow_ads` | boolean | No | true to include sponsored cards. Default false. |

## Example response

```json
{
    "data": {
        "pagination": {
            "note": "Naver returns one full result set. A second page is not available.",
            "has_next": false,
            "current_page": 1,
            "total_results": 1
        },
        "shopping_results": [
            {
                "link": "https://shopping.naver.com/",
                "price": "\u20a915,000",
                "title": "Sample laptop",
                "rating": 4.8,
                "source": "Sample Mall",
                "reviews": 320,
                "category": {
                    "l1_id": "1000",
                    "l2_id": "2000"
                },
                "currency": "KRW",
                "delivery": "Free delivery",
                "discount": 25,
                "position": 1,
                "sponsored": false,
                "thumbnail": "https://shopping.pstatic.net/image.jpg",
                "mall_count": 12,
                "product_id": "61641131808",
                "source_type": "NORMAL",
                "delivery_fee": 0,
                "fast_delivery": false,
                "free_delivery": true,
                "original_price": 20000,
                "extracted_price": 15000
            }
        ],
        "search_parameters": {
            "page": 1,
            "sort": "relevance",
            "price": null,
            "query": "\ub178\ud2b8\ubd81",
            "filters": {
                "page": 1,
                "sort": "relevance",
                "query": "\ub178\ud2b8\ubd81"
            }
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid, or an unsupported sort was sent. This response is not billable. |
| 503 | Upstream Unavailable | Naver Shopping did not answer after the internal retries. 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)
