v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Carian Google Ads Lanjutan mengikut id

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/google/ads_search/task_get/advanced/{id}

Dapatkan Hasil Carian Google Ads Lanjutan mengikut id

Mengambil hasil carian Google Ads yang berbaris mengikut id. Memulangkan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count dan items. 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.02.
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_SerpGoogleAdsSearchTaskGetAdvancedResponseInfo
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_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo
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
dalam kes ini, sama dengan null

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 dalam SERP
mengandungi jenis hasil carian (items) yang ditemui dalam SERP.
jenis item yang mungkin:
ads_search

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

item elemen

advertiser_id
Jenis: string | null

pengecam unik akaun pengiklan

creative_id
Jenis: string | null

pengecam unik iklan

first_shown
Jenis: string | null

tarikh dan masa iklan dipaparkan kali pertama
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”

format
Jenis: string | null

format iklan
nilai sah: text, image, video

last_shown
Jenis: string | null

tarikh dan masa iklan dipaparkan kali terakhir
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”

preview_image
Jenis: object | null · Response36Afe1097B20_PreviewImage

imej pratonton iklan

height
Jenis: integer | null

tinggi imej pratonton

url
Jenis: string | null

URL carian dengan parameter penghalusan

width
Jenis: integer | null Format: int64

lebar imej pratonton

preview_url
Jenis: string | null

URL yang menghala ke pratonton iklan

rank_absolute
Jenis: integer | null

kedudukan mutlak dalam SERP
kedudukan mutlak antara semua elemen dalam SERP

rank_group
Jenis: integer | null

kedudukan kumpulan dalam SERP
kedudukan dalam kumpulan elemen dengan nilai type yang sama
kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group

title
Jenis: string | null

tajuk elemen

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL carian dengan parameter penghalusan

verified
Jenis: boolean | null

akaun pengiklan disahkan
sama dengan true jika akaun pengiklan disahkan oleh Google Ads

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

refinement_chips
Jenis: object | null · Response36Afe1097B20_RefinementChipsInfo

cip penghalusan carian

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;
dalam kes ini, sama dengan null

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/google/ads_search/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_get/advanced/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,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "advertiser_id": null,
              "creative_id": null,
              "title": null,
              "url": null,
              "verified": null,
              "format": null,
              "preview_image": "[Max Depth Exceeded]",
              "preview_url": null,
              "first_shown": null,
              "last_shown": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Dapatkan Hasil Carian Google Ads Lanjutan mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Carian Google Ads Lanjutan mengikut id

Rujukan harga