MapsScraper.dev
تسجيل الدخولفتح مساحة العمل

أداة استخراج مراجعات Google Maps

تقرأ أداة استخراج مراجعات Google Maps المراجعات العامة لمعرّف النشاط التجاري: النص والتقييم والتاريخ والمؤلف ورد المالك، حتى 100 في الصفحة. صدّر هذه الصفحة أو اقرأها عبر API.

ابدأ البحثالأسعار

قبل البدء · يتطلب البحث المباشر إعداد مصدر بيانات. تُميّز بيانات الأمثلة بوضوح. الخطط المدفوعة غير متاحة بعد.

ما هي أداة استخراج مراجعات Google Maps؟

تقرأ هذه الأداة المراجعات العامة لمعرّف نشاط تجاري واحد: النص والتقييم والتاريخ والمؤلف وردّ المالك، حتى 100 مراجعة في الصفحة. لا تبحث حسب الفئة. صدّر هذه الصفحة، أو اطلب صفحة أخرى بميزانيتها الخاصة.

الحقول في كل مراجعة

تختلف الحقول من مراجعة لأخرى. لا يظهر الحقل إلا عندما يُرجعه مصدر البيانات، والحقل الفارغ ليس دليلًا على عدم وجود المعلومة.

كيفية استخراج مراجعات Google Maps وتصديرها

  1. اختر النشاط التجاري

    ابحث في صفحة استكشاف الشركات، وافتح نشاطًا تجاريًا، ثم اختر "مجموعة المراجعات" ضمن "تحضير مهمة متابعة". يمكنك أيضًا اختيار "مجموعة المراجعات" ولصق معرّف نشاط تجاري.

  2. اضبط الصفحة ثم شغّل

    اختر ترتيب المراجعات، وفلتر نص المراجعة إن أردت، وحتى 100 مراجعة. تحقّق من الحد الأقصى للوحدات، ثم شغّل.

  3. اجلب المزيد من الصفحات وصدّرها

    افتح صفحات النتائج لجلب صفحة إضافية واحدة في كل مرة، لكل منها ميزانيتها الخاصة. نزّل CSV أو Excel أو JSON أو JSONL، أو اجمع الصفحات في تصدير واحد للسلسلة الكاملة.

لجمع مراجعات عدة أنشطة تجارية، حدّدها في صفحة استكشاف الشركات واختر "جمع المراجعات للعناصر المحددة في البحث الجماعي". يصبح كل نشاط تجاري مهمة واحدة ضمن ميزانية إجمالية واحدة.

واجهة API لمراجعات Google Maps

عبر API، أنشئ مهمة استخراج مراجعات Google Maps باستخدام معرّف نشاط تجاري وميزانية وحدات صريحة، ثم اقرأ المراجعات صفحةً بصفحة. قراءة المراجعات المخزنة لا تُشغّل بحثًا جديدًا أبدًا.

في عميل MCP، استخدم estimate_job، ثم create_job مع idempotency_key ثابت و max_units، واقرأ النتائج باستخدام get_job_results. للصفحة التالية، تُرجع preview_provider_continuation المهمة الدقيقة المطلوب اعتمادها.

curl -X POST https://mapsscraper.dev/api/v1/jobs \
  -H "Authorization: Bearer $MAPSSCRAPER_API_KEY" \
  -H "Idempotency-Key: reviews-sample-business-001" \
  -H "X-Max-Units: 1" \
  -H "Content-Type: application/json" \
  -d '{"kind":"reviews","business_id":"sample-business-id","limit":100,"review_options":{"sort_by":"newest"}}'

HTTP/1.1 202 Accepted
{"id":"6f1c2b3a-0000-4000-8000-000000000000","status":"queued","reserved":1}

curl "https://mapsscraper.dev/api/v1/jobs/6f1c2b3a-0000-4000-8000-000000000000/results?offset=0&limit=100" \
  -H "Authorization: Bearer $MAPSSCRAPER_API_KEY"

نموذج استجابة مختصر. القيم توضيحية وليست بيانات حقيقية لأنشطة تجارية.

{
  "items": [
    {
      "review_id": "sample-review-id",
      "business_id": "sample-business-id",
      "review_text": "Friendly staff and a short wait.",
      "rating": 5,
      "review_language": "en",
      "author_name": "Sample Reviewer",
      "owner_response_text": "Thank you for visiting.",
      "like_count": 2,
      "_source": {
        "provider": "live_maps",
        "fetched_at": "2026-11-01T12:00:00Z"
      }
    }
  ],
  "count": 1,
  "offset": 0,
  "next_offset": null,
  "provider": "live_maps",
  "coverage": "bounded_sample",
  "fetched_at": "2026-11-01T12:00:00Z"
}

وسائط أداة MCP create_job

{
  "task": {
    "kind": "reviews",
    "business_id": "sample-business-id",
    "limit": 100,
    "review_options": {
      "sort_by": "newest"
    }
  },
  "idempotency_key": "reviews-sample-business-001",
  "max_units": 1
}

مثال Python

أنشئ مهمة مراجعات، وانتظر حتى تنتهي، واقرأ المراجعات، ثم اعرض معاينة الصفحة التالية. إرسال تلك الصفحة مهمة مدفوعة منفصلة.

import os
import time
import uuid

import requests

API = "https://mapsscraper.dev/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['MAPSSCRAPER_API_KEY']}"}


def run(task, units):
    # Keep the key: a retry of the same page must send it again.
    key = str(uuid.uuid4())
    job = requests.post(
        f"{API}/jobs",
        json=task,
        headers={**HEADERS, "Idempotency-Key": key, "X-Max-Units": str(units)},
        timeout=30,
    )
    job.raise_for_status()
    job_id = job.json()["id"]
    while True:
        status = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS, timeout=30).json()["status"]
        if status not in ("queued", "running"):
            return job_id, status
        time.sleep(5)


task = {"kind": "reviews", "business_id": "sample-business-id", "limit": 100,
        "review_options": {"sort_by": "newest"}}
units = requests.post(f"{API}/estimate", json=task, headers=HEADERS, timeout=30).json()["units"]
job_id, status = run(task, units)

if status in ("completed", "partial"):
    page = requests.get(
        f"{API}/jobs/{job_id}/results",
        params={"offset": 0, "limit": 100},
        headers=HEADERS,
        timeout=30,
    ).json()
    for review in page["items"]:
        print(review.get("rating"), review.get("review_text"))

    # The next source page is a separate paid task: preview it, then submit
    # its exact task only if you need it.
    preview = requests.get(f"{API}/jobs/{job_id}/continuation", headers=HEADERS, timeout=30).json()
    if preview["available"]:
        run(preview["task"], preview["units"])

صيغ التصدير

CSV

يُفتح ملف CSV الناتج عن تصدير بيانات Google Maps في أي برنامج جداول بيانات. يُضاف حرف الفاصلة العليا قبل النص الذي يبدأ بـ = أو + أو - أو @، حتى لا يشغّله برنامج الجداول كصيغة.

Excel (XLSX)

مصنف لـ Excel أو جداول بيانات Google، للنتائج التي يصل حجمها إلى 5 MB تقريبًا. استخدم JSON Lines للنتائج الأكبر.

JSON

النتيجة الكاملة مع مصدر كل سجل ووقت جلبه ونطاق تغطية المهمة.

أسطر JSON

مراجعة واحدة في كل سطر، للملفات الكبيرة ومسارات البيانات.

التكلفة والحدود

في استخراج مراجعات Google Maps، تحجز كل صفحة تضم حتى 100 مراجعة وحدة واحدة، مهما كان عدد المراجعات التي تُرجعها. لا تُحتسب أي رسوم على المهام الفاشلة والملغاة وغير المؤكدة. لا تستهلك قراءة الصفحات التي لديك بالفعل وتصديرها ودمجها أي وحدات.

تتوقف سلسلة الصفحات الخاصة بنشاط تجاري واحد عند حد الصفحات في مساحة العمل، وهو 20 صفحة افتراضيًا و100 كحد أقصى، أو عندما لا تتوفر صفحة تالية لدى مصدر البيانات.

الأسعار

الموارد

أسئلة حول أداة استخراج مراجعات Google Maps

الوثائق
هل هذه هي Google Places API؟

لا. MapsScraper.dev خدمة مستقلة وغير تابعة لـ Google. تأتي النتائج من مصدر بيانات أعمال تابع لجهة خارجية وتستخدم تنسيق JSON الخاص بنا.

كم مراجعة يمكنني جمعها لنشاط تجاري واحد عند استخراج مراجعات Google Maps؟

بحد أقصى 100 مراجعة في الصفحة. كل صفحة إضافية مهمة منفصلة بميزانية خاصة بها، إلى أن تنفد الصفحات لدى مصدر البيانات أو يتم بلوغ حد الصفحات في مساحة العمل. قد يعرض النشاط التجاري مراجعات أكثر مما يُرجعه مصدر البيانات.

هل استخراج بيانات Google Maps قانوني؟

لا يمكننا تقديم استشارة قانونية. تعتمد مشروعية جمع بيانات الأنشطة التجارية واستخدامها على مكان وجودك، وما تجمعه، وسبب استخدامه، والشروط السارية. ولا يعني توفر البيانات للعامة وحده الحصول على إذن بتخزينها أو إعادة بيعها أو التواصل مع الأشخاص. اقرأ سياسة البيانات لدينا

تبدأ قائمتك القادمة بمكان.

جرّب المسار بسجلات أمثلة محددة، ثم اربط مساحة عملك للبحث المباشر.

استكشف مثالاً