Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Setting Naver Organic SERP Tasks

サーバー:https://openapi.felo.ai
クライアントライブラリ

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Setting Naver Organic SERP Tasks

​

Queues the ranked results for a keyword on Naver, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

リクエストボディ
必須
application/json
  • 型: array object[]
    • keyword
      型: string
      必須

      Keyword to search for

    • depth
      型: integer

      Parsing depth

    • device
      型: string

      Device type

    • language_code
      型: string

      Search engine language code

    • language_name
      型: string

      Full name of search engine language

    • location_code
      型: integer

      Search engine location code

    • location_name
      型: string

      Full name of search engine location

    • os
      型: string

      Device operating system

    • pingback_url
      型: string

      Notification URL of a completed task

    • postback_data
      型: string

      Postback datatype; possible values: regular, advanced, html

    • postback_url
      型: string

      URL for sending task results

    • priority
      型: integer

      Task priority

レスポンス
  • 200
    型: object

    Successful response

    • cost
      型: number

      Total tasks cost, USD

    • status_code
      型: integer

      General status code

    • status_message
      型: string

      General informational message

    • tasks
      型: array string[]

      Array of task objects

    • tasks_count
      型: integer

      The number of tasks in the tasks array

    • tasks_error
      型: integer

      The number of tasks in the tasks array returned with an error

    • tasks[].cost
      型: number

      Cost of the task, USD

    • tasks[].id
      型: string

      Task identifier in UUID format

    • tasks[].result_count
      型: integer

      Number of elements in the result array

    • tasks[].status_code
      型: integer

      Task status code

    • tasks[].status_message
      型: string

      Task status message

    • time
      型: string

      Execution time, seconds

    • version
      型: string

      The current version of the API

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for post/v1/beta/dataforseo/serp/naver/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "",
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "device": "",
    "os": "",
    "depth": 1,
    "priority": 1,
    "postback_url": "",
    "pingback_url": "",
    "postback_data": ""
  }
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].id": "string",
  "tasks[].status_code": 1,
  "tasks[].status_message": "string",
  "tasks[].cost": 1,
  "tasks[].result_count": 1
}
Setting Naver Organic SERP Tasks