v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil SERP Organik Seznam mengikut id（regular）

Felo API Support

MIT

Pelayan

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/seznam/organic/task_get/regular/{id}

Dapatkan Hasil SERP Organik Seznam mengikut id（regular）

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

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.012.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Parameter Laluan

id
Jenis: string
wajib

pengecam tugas
pengecam tugas unik dalam sistem kami dalam format UUID
anda boleh menggunakannya dalam tempoh 30 hari untuk meminta hasil tugas pada bila-bila masa

Respons

200
Jenis: object | null · Response36Afe1097B20_SerpSeznamOrganicTaskGetRegularResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_SerpSeznamOrganicTaskGetRegularTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

Laluan URL

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

tatasusunan hasil

check_url
Jenis: string | null

URL terus ke hasil enjin carian
anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

datetime
Jenis: string | null

tarikh dan masa hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

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

jenis hasil carian yang ditemui dalam SERP
mengandungi jenis semua hasil carian (items) yang ditemui dalam SERP yang dipulangkan
jenis item yang mungkin:
images, local_pack, organic, related_searches, top_stories, featured_snippet, video

ambil perhatian bahawa array ini mengandungi semua jenis hasil carian yang ditemui dalam SERP yang dipulangkan;
namun, endpoint ini hanya menyediakan data untuk jenis organic

untuk mendapatkan semua item (termasuk ciri SERP dan coretan kaya) yang ditemui dalam SERP yang dipulangkan, sila rujuk endpoint Seznam Organiс Advanced SERP

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

item dalam SERP

page
Jenis: integer | null

nombor halaman hasil carian
menunjukkan nombor halaman SERP tempat elemen berada

position
Jenis: string | null

penjajaran elemen dalam SERP
boleh mengambil nilai berikut:
left, right

rectangle
Jenis: object | null · Response36Afe1097B20_AiModeRectangleInfo

parameter segi empat tepat
mengandungi koordinat kartesan dan dimensi piksel petikan hasil dalam SERP
sama dengan null jika calculate_rectangles dalam permintaan POST tidak ditetapkan kepada true

height
Jenis: number | null Format: double

tinggi elemen dalam piksel

width
Jenis: number | null Format: double

lebar elemen dalam piksel

x
Jenis: number | null Format: double

koordinat paksi x koordinat paksi x sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan

y
Jenis: number | null Format: double

koordinat paksi y koordinat paksi y sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan

type
Jenis: string | null

jenis elemen

xpath
Jenis: string | null

XPath elemen

items_count
Jenis: integer | null Format: int64

bilangan hasil yang dipulangkan dalam tatasusunan items

keyword
Jenis: string | null

kata kunci yang diterima dalam array POST
kata kunci dipulangkan dengan %## dinyahkod (simbol tambah '+' akan dinyahkod menjadi aksara ruang)

language_code
Jenis: string | null

kod bahasa dalam array POST

location_code
Jenis: integer | null

kod lokasi dalam array POST

pages_count
Jenis: integer | null Format: int64

jumlah halaman yang diambil
jumlah keseluruhan SERP yang diambil dalam hasil

refinement_chips
Jenis: object | null · Response36Afe1097B20_RefinementChipsInfo

cip penghalusan carian
sama dengan null

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

item elemen

domain
Jenis: string | null

domain dalam SERP

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

pilihan penghalusan carian lanjut

domain
Jenis: string | null

domain dalam SERP

title
Jenis: string | null

tajuk elemen

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL carian dengan parameter penghalusan

title
Jenis: string | null

tajuk elemen

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL carian dengan parameter penghalusan

type
Jenis: string | null

jenis elemen

xpath
Jenis: string | null

XPath elemen

se_domain
Jenis: string | null

domain enjin carian dalam array POST

se_results_count
Jenis: integer | null Format: int64

jumlah keseluruhan hasil dalam SERP

spell
Jenis: object | null · Response36Afe1097B20_SpellInfo

pembetulan automatik enjin carian
jika enjin carian memberikan hasil untuk kata kunci yang dibetulkan, kami akan menyatakan kata kunci yang dibetulkan oleh enjin carian dan jenis pembetulan automatiknya

keyword
Jenis: string | null

kata kunci yang diperoleh hasil daripada pembetulan automatik enjin carian keputusan akan diberikan untuk kata kunci yang dibetulkan

type
Jenis: string | null

jenis pembetulan automatik nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo dan Yandex hanya menyokong jenis pembetulan automatik berikut: including_results_for

type
Jenis: string | null

jenis elemen

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

versi semasa API
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

application/json

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

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

Tunjukkan 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 berjaya

Dapatkan Hasil SERP Organik Seznam mengikut id（regular）

PengesahanRequired

DataForSEO

Dapatkan Hasil SERP Organik Seznam mengikut id（regular）

Rujukan harga