Skip to main content

Naver Ads

info

API Documentation: Naver Search Ads API

The Naver Search Ads API allows you to access advertising data from Naver, South Korea's leading search engine. This connector supports syncing account and campaign metadata, plus a variety of performance and reporting datasets.

Source Setup Guide

This source uses API key-based authentication. You will need to obtain credentials from Naver's advertising platform.

Step 1 - Create a Naver Search Ads Account

If you don't already have one, sign up for a Naver Search Advertiser account at searchad.naver.com.

Step 2 - Generate API Credentials

  1. Go to the Naver Ads Manager
  2. Navigate to Tools > API Manager
  3. Click Create API license to generate your credentials
  4. Copy your API License (API Key) and Secret Key
warning

Store your Secret Key securely. You will not be able to view it again after leaving the page.

Step 3 - Configure the Source in Extract

  1. In the Extract platform, navigate to Sources > Add Source > Naver Ads
  2. Enter the following credentials:
    • API Key: Your API License from the Naver API Manager
    • Secret Key: Your Secret Key from the Naver API Manager
    • Customer ID: Your Naver Ads customer account ID (numeric)
  3. Click Save to complete the setup

Connection Setup Guide

Once you connected Naver Ads to a destination, you will also need to configure:

  • Connection Pull Schedule: Determines how frequently data is extracted from the source.
  • Backfill (Days): Specifies the duration for which historical data will be retrieved during each connection run. This is used by date-based endpoints (for example, daily stats and certain billing/bizmoney history streams).
  • Destination specific settings: different settings such as "Dataset Name" or "Target Schema" (depending on your destination)
  • Schema Migration Policy: Controls how Extract will handle schema changes from the source.

Connector Information

info

API Overview

Base URL: https://api.searchad.naver.com

The connector uses Naver’s signed request headers (timestamp + HMAC signature). Some report streams are generated asynchronously by creating a report job, polling until it completes, and then downloading the resulting file.

Data Streams

Metadata

Loading ....

ad_account

Loading ....

ad_extension

Loading ....

ad_group

Loading ....

ad_keyword

Loading ....

bizmoney

Loading ....

brand_new_contract

Loading ....

business_channel

Loading ....

campaign

Loading ....

criterion

Loading ....

ip_exclusion

Loading ....

label

Loading ....

manager_account

Loading ....

product_group

Loading ....

shared_budget

Loading ....

target

Loading ....

time_contract

Loading ....

Stats

ad_group_stats_daily

Loading ....

campaign_stats_daily

Loading ....

Bizmoney History

bizmoney_charge_history

Loading ....

bizmoney_daily_status

Loading ....

bizmoney_exhaust_history

Loading ....

Master Reports

Loading ....

ad_extension_master_report

Loading ....

ad_group_budget_master_report

Loading ....

ad_group_master_report

Loading ....

ad_master_report

Loading ....

ad_quality_index_master_report

Loading ....

asset_master_report

Loading ....

biz_master_report

Loading ....

brand_banner_ad_master_report

Loading ....

brand_thumbnail_ad_master_report

Loading ....

business_channel_master_report

Loading ....

campaign_budget_master_report

Loading ....

campaign_master_report

Loading ....

catalog_ad_master_report

Loading ....

contents_ad_master_report

Loading ....

criterion_master_report

Loading ....

hospital_ad_master_report

Loading ....

keyword_master_report

Loading ....

label_master_report

Loading ....

label_ref_master_report

Loading ....

media_master_report

Loading ....

place_ad_master_report

Loading ....

product_group_master_report

Loading ....

product_group_rel_master_report

Loading ....

quality_index_master_report

Loading ....

rsa_ad_master_report

Loading ....

seasonal_event_master_report

Loading ....

shared_budget_master_report

Loading ....

shopping_product_master_report

Loading ....

Performance Reports

ad_detail_report

Loading ....

ad_extension_performance_report

Loading ....

ad_performance_report

Loading ....

criterion_performance_report

Loading ....

search_term_report

Loading ....

shopping_product_report

Loading ....

shopping_search_term_report

Loading ....

Conversion Reports

ad_conversion_detail_report

Loading ....

ad_conversion_report

Loading ....

ad_extension_conversion_report

Loading ....

criterion_conversion_report

Loading ....

shopping_product_conversion_report

Loading ....

shopping_search_term_conversion_report

Loading ....