add/keywords_2/keywords/import

Method description

Use to import keywords to your project.

Import operation automatically creates folders and groups that didn't exist before.

Fields available for import

Add fields to import in the first line of keywords data.

  • name (mandatory)
  • tags
  • target
  • group_folder_path
  • group_name

Method parameters

Parameter Type Description Default
Mandatory
project_id int Project ID
keywords data of CSV

CSV file contents

  • default delimiter is to be set in the user account
  • the first row should contain the names of the fields to import
Additional
folder_id int

ID of the target folder to import keyword groups

  • to be ignored if keywords CSV data contains a group_folder_path field
  • used together with group_name
  • to be used when group_id not specified
0
group_id int

ID of the target group to import keywords

  • to be ignored if keywords CSV data contains a group_name field
0
group_name string

Group name to import keywords

  • to be used when group_id not specified
  • to be ignored if keywords CSV data contains a group_name field
move_duplicate int boolean Should duplicates be moved to a separate group 0
move_duplicate_folder_id int

ID of the target folder to new group for move duplicates

  • to be used when
    move_duplicate = 1
  • used with move_duplicate_group_name
  • to be used when move_duplicate_group_id not specified
0
move_duplicate_group_id int

Target group ID to move duplicates

  • to be used when
    move_duplicate = 1
0
move_duplicate_group_name string

Name of group to move duplicates

  • to be used when
    move_duplicate = 1
  • to be used when move_duplicate_group_id not specified

Посмотреть в API Explorer

Пример с PHP SDK на GitHub

Returned data

Parameter Type Description
result (object)
countSended int the number of sent keywords
countDuplicated int the number of detected duplicates
countAdded int the number of added keywords
countChanged int the number of updated keywords