v0.2.0-beta

OpenAPI 3.1.0

Ambil Hasil SERP Organik Naver berdasarkan id（regular）

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

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

DataForSEO Operasi

get/v1/beta/dataforseo/serp/naver/organic/task_get/regular/{id}

Ambil Hasil SERP Organik Naver berdasarkan id（regular）

Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.012.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Jalur

id
Tipe: string
wajib

pengenal tugas
pengenal tugas unik di sistem kami dalam format UUID
Anda dapat menggunakannya dalam 30 hari untuk meminta hasil tugas kapan saja

Respons

200
Tipe: object | null · Response36Afe1097B20_SerpNaverOrganicTaskGetRegularResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array (object | null)[] | null

array tugas

Tipe: object | null · Response36Afe1097B20_SerpNaverOrganicTaskGetRegularTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

path
Tipe: array (string | null)[] | null

Jalur URL

result
Tipe: array (object | null)[] | null

array hasil

check_url
Tipe: string | null

URL langsung ke hasil mesin pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

datetime
Tipe: string | null

tanggal dan waktu saat hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
misalnya:
2019-11-15 12:57:46 +00:00

item_types
Tipe: array (string | null)[] | null

jenis hasil pencarian yang ditemukan di SERP
berisi jenis semua hasil pencarian (items) yang ditemukan di SERP yang dikembalikan
jenis item yang mungkin:
images, local_pack, map, organic, paid, related_searches, video

perhatikan bahwa array ini berisi semua jenis hasil pencarian yang ditemukan di SERP yang dikembalikan;
namun, endpoint ini hanya menyediakan data untuk organic dan paid

untuk mendapatkan semua item (termasuk fitur SERP dan cuplikan kaya) yang ditemukan di SERP yang dikembalikan, lihat Naver Organiс Advanced SERP endpoint

items
Tipe: array (object | null)[] | null

item di SERP

page
Tipe: integer | null

nomor halaman hasil pencarian
menunjukkan nomor halaman SERP tempat elemen berada

position
Tipe: string | null

perataan elemen dalam SERP
dapat mengambil nilai berikut:
left, right

rectangle
Tipe: object | null · Response36Afe1097B20_AiModeRectangleInfo

parameter persegi panjang
berisi koordinat kartesius dan dimensi piksel cuplikan hasil di SERP
sama dengan null jika calculate_rectangles dalam permintaan POST tidak disetel ke true

height
Tipe: number | null Format: double

tinggi elemen dalam piksel

width
Tipe: number | null Format: double

lebar elemen dalam piksel

x
Tipe: number | null Format: double

koordinat sumbu x koordinat sumbu x sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal

y
Tipe: number | null Format: double

koordinat sumbu y koordinat sumbu y sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal

type
Tipe: string | null

jenis elemen

xpath
Tipe: string | null

XPath elemen

items_count
Tipe: integer | null Format: int64

jumlah hasil yang dikembalikan dalam array items

keyword
Tipe: string | null

kata kunci yang diterima dalam array POST
kata kunci dikembalikan dengan %## yang didekode (simbol plus '+' akan didekode menjadi karakter spasi)

language_code
Tipe: string | null

kode bahasa dalam array POST

location_code
Tipe: integer | null

kode lokasi dalam array POST

pages_count
Tipe: integer | null Format: int64

total halaman yang diambil
jumlah total SERP yang diambil dalam hasil

refinement_chips
Tipe: object | null · Response36Afe1097B20_RefinementChipsInfo

chip penyempurnaan pencarian
sama dengan null

items
Tipe: array (object | null)[] | null

item elemen

domain
Tipe: string | null

domain di SERP

options
Tipe: array (object | null)[] | null

opsi penyempurnaan pencarian lebih lanjut

domain
Tipe: string | null

domain di SERP

title
Tipe: string | null

judul elemen

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

URL penelusuran dengan parameter penyempurnaan

title
Tipe: string | null

judul elemen

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

URL penelusuran dengan parameter penyempurnaan

type
Tipe: string | null

jenis elemen

xpath
Tipe: string | null

XPath elemen

se_domain
Tipe: string | null

domain mesin pencari dalam array POST

se_results_count
Tipe: integer | null Format: int64

jumlah total hasil di SERP

spell
Tipe: object | null · Response36Afe1097B20_SpellInfo

koreksi otomatis mesin pencari
jika mesin pencari memberikan hasil untuk kata kunci yang telah dikoreksi, kami akan menentukan kata kunci yang dikoreksi oleh mesin pencari dan jenis koreksi otomatisnya

keyword
Tipe: string | null

kata kunci yang diperoleh sebagai hasil koreksi otomatis mesin penelusuran hasil akan diberikan untuk kata kunci yang dikoreksi

type
Tipe: string | null

jenis koreksi otomatis nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for catatan: Yahoo dan Yandex hanya mendukung jenis koreksi otomatis berikut: including_results_for

type
Tipe: string | null

jenis elemen

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

application/json

get/v1/beta/dataforseo/serp/naver/organic/task_get/regular/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_get/regular/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tampilkan Skema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Ambil Hasil SERP Organik Naver berdasarkan id（regular）

AutentikasiRequired

DataForSEO

Ambil Hasil SERP Organik Naver berdasarkan id（regular）

Referensi harga