Skip to content
Scrappa Get API key
Naver Shopping API 1 credit / request

Naver Shopping Search API Documentation

GET https://scrappa.co/api/naver-shopping/search

Naver Shopping Search API Documentation 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.

Naver Shopping Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/naver-shopping/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "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,
...

Parameters

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

Runnable path

1 required parameter needed before sending a request.

8 optional filters available.

query string Required

Search keyword, for example 노트북. Required.

Example value coffee shops
sort string Optional

relevance only. Naver has no date sort.

Example value relevance
price string Optional

Two price bounds in KRW separated by a pipe, for example 0|100000. Both bounds are required.

Example value example
page integer Optional

Accepted for compatibility. Naver returns one full result set.

Example value 1
free_delivery boolean Optional

true to return only free-delivery products.

Example value true
review_score_low_limit number Optional

Lowest review score, for example 4.8.

Example value 10
fast_delivery boolean Optional

true for fast-delivery products.

Example value true
arrive_guarantee boolean Optional

true for arrival-guaranteed products.

Example value true
allow_ads boolean Optional

true to include sponsored cards. Default false.

Example value true

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": {
        "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

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

422

Validation Error

A query parameter is missing or invalid, or an unsupported sort was sent. This response is not billable.

{
    "errors": {
        "query": [
            "The query field is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

Naver Shopping did not answer after the internal retries. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Naver Shopping is temporarily unavailable. Please retry. This request was not charged."
    },
    "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.