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 ....