v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Ulasan Lanjutan Google Business Data 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/business_data/google/extended_reviews/task_get/{id}

Dapatkan Hasil Ulasan Lanjutan Google Business Data mengikut id

Mendapatkan hasil baris gilir bagi seluruh sejarah ulasan Google untuk sesuatu perniagaan, melepasi halaman pertama yang dipulangkan endpoint standard, mengikut id. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. ⚠️ Saiz mengikut kedalaman yang ditetapkan semasa penghantaran dan tidak boleh disempitkan di sini.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0,012.
Pengganda rujukan pelanggan: 1,0. Jangan gunakannya 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_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo
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_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
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

cid
Jenis: string | null

client id yang ditentukan Google
id unik sesuatu pertubuhan tempatan
pelajari lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

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

feature_id
Jenis: string | null

pengecam unik elemen 'reviews' dalam SERP
pelajari lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

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

ulasan yang ditemui
anda boleh mendapatkan lebih banyak hasil dengan menggunakan parameter depth semasa menetapkan tugas

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

imej yang dihantar oleh pengulas

alt
Jenis: string | null

tag alt imej

image_url
Jenis: string | null

URL imej
URL yang menghala ke imej pada sumber asal atau storan DataForSEO (jika sumber asal tidak tersedia)

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL berkaitan

local_guide
Jenis: boolean | null

menunjukkan sama ada pengulas mempunyai status 'local guide'

original_owner_answer
Jenis: string | null

teks asal respons pemilik
respons asal kepada ulasan, tanpa terjemahan automatik

original_review_text
Jenis: string | null

kandungan asal ulasan
kandungan asal ulasan, tanpa terjemahan automatik

owner_answer
Jenis: string | null

teks respons pemilik
respons pemilik kepada ulasan

owner_time_ago
Jenis: string | null

masa penerbitan
menunjukkan masa (dalam format 'time ago') apabila pemilik menghantar respons kepada ulasan

owner_timestamp
Jenis: string | null

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

photos_count
Jenis: integer | null Format: int64

jumlah keseluruhan foto yang dihantar oleh pengulas

position
Jenis: string | null

jajaran ulasan dalam SERP
boleh mengambil nilai berikut: right

profile_image_url
Jenis: string | null

URL imej profil pengulas

profile_name
Jenis: string | null

nama profil pengulas

profile_url
Jenis: string | null

URL profil pengulas

rank_absolute
Jenis: integer | null

kedudukan mutlak antara semua ulasan yang disenaraikan
kedudukan mutlak antara semua ulasan dalam senarai

rank_group
Jenis: integer | null

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

rating
Jenis: object | null · Response36Afe1097B20_RatingInfo

skor penilaian yang dihantar oleh pengulas

rating_max
Jenis: integer | null

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

value
Jenis: number | null Format: double

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

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

sorotan ulasan
mengandungi kriteria dan penilaian ulasan yang disorot

assessment
Jenis: string | null

penilaian ciri

feature
Jenis: string | null

ciri yang diulas

review_id
Jenis: string | null

pengecam unik ulasan di Google
contoh:
ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

review_text
Jenis: string | null

kandungan ulasan

review_url
Jenis: string | null

URL ulasan

reviews_count
Jenis: integer | null Format: int64

jumlah ulasan yang dihantar oleh pengulas

source
Jenis: object | null · Response36Afe1097B20_Source

sumber ulasan
mengandungi maklumat tentang sumber tempat ulasan disiarkan

domain
Jenis: string | null

domain sumber tempat ulasan disiarkan

image
Jenis: string | null

imej pilihan sumber

title
Jenis: string | null

nama sumber tempat ulasan disiarkan

time_ago
Jenis: string | null

masa penerbitan
menunjukkan masa (dalam format 'time ago') apabila ulasan disenaraikan

timestamp
Jenis: string | null

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

type
Jenis: string | null

jenis elemen

xpath
Jenis: string | null

XPath bagi ulasan

items_count
Jenis: integer | null Format: int64

bilangan item ulasan dalam array hasil
anda boleh mendapatkan lebih banyak hasil dengan menggunakan parameter depth semasa menetapkan tugas

keyword
Jenis: string | null

kata kunci yang diterima dalam array POST
kata kunci dipulangkan dengan %## dinyahkod (aksara 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

place_id
Jenis: string | null

pengecam unik lokasi perniagaan yang ditetapkan oleh Google
pelajari lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

rating
Jenis: object | null · Response36Afe1097B20_RatingInfo

penilaian pertubuhan tempatan yang berkaitan
kadar populariti berdasarkan ulasan dan dipaparkan dalam SERP

rating_max
Jenis: integer | null

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

value
Jenis: number | null Format: double

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

reviews_count
Jenis: integer | null Format: int64

jumlah ulasan

se_domain
Jenis: string | null

domain enjin carian dalam array POST

sub_title
Jenis: string | null

subtajuk elemen 'reviews' dalam SERP
maklumat tambahan (contohnya alamat) tentang elemen 'reviews' yang ulasannya dikumpulkan

title
Jenis: string | null

tajuk elemen 'reviews' dalam SERP
nama pertubuhan tempatan yang ulasannya dikumpulkan

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/business_data/google/extended_reviews/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/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,
          "title": null,
          "sub_title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "feature_id": null,
          "place_id": null,
          "cid": null,
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "review_text": null,
              "original_review_text": null,
              "time_ago": null,
              "timestamp": null,
              "rating": "[Max Depth Exceeded]",
              "reviews_count": null,
              "photos_count": null,
              "local_guide": null,
              "profile_name": null,
              "profile_url": null,
              "review_url": null,
              "profile_image_url": null,
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null,
              "review_id": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": [
                "[Max Depth Exceeded]"
              ],
              "source": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Dapatkan Hasil Ulasan Lanjutan Google Business Data mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Ulasan Lanjutan Google Business Data mengikut id

Rujukan harga