DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
لائیو Google Maps SERP
Google پر کسی مقامی کوئری کے لیے میپ پیک ہم وقت واپس کرتا ہے، جس میں Google پر ہر کاروبار کی ریٹنگ، ایڈریس اور place id شامل ہوتے ہیں۔ keyword، type، se_domain، location_code، language_code، check_url، datetime، spell، refinement_chips، item_types، items_count اور items واپس کرتا ہے۔ advanced ڈیفالٹ انتخاب ہے؛ regular تب لیں جب صرف درجہ بند فہرست اہم ہو، اور html صرف یہ دیکھنے کے لیے کہ پارسر نے کیا چھوڑا۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.002۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- depthقسم: integer | null
پارسنگ ڈیپتھ
اختیاری فیلڈ
SERP میں نتائج کی تعداد
ڈیفالٹ قدر:
100زیادہ سے زیادہ قدر:
700
آپ کے اکاؤنٹ سے ہر اس SERP کے لیے بل لیا جائے گا جس میں زیادہ سے زیادہ 100 نتائج ہوں؛100 سے زیادہ ڈیپتھ مقرر کرنے پر اضافی چارجز آ سکتے ہیں اگر سرچ انجن 100 سے زیادہ نتائج واپس کرے؛
لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔
- deviceقسم: string | null
ڈیوائس کی قسم
اختیاری فیلڈ
مخصوص ڈیوائس کی قسم کے لیے نتائج واپس کریں
یہ اقدار لے سکتا ہے:
desktop،mobileڈیفالٹ قدر:
desktopنوٹ:
mobileڈیوائس کے لیے ہر SERP کے لیے صرف 20 نتائج واپس کیے جاتے ہیں - keywordقسم: string
کی ورڈ
درکار فیلڈ
آپ
keywordفیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیںتمام %## ڈی کوڈ ہوں گے (نیز حرف اسپیس حرف میں ڈی کوڈ ہو جائے گا)
اگر آپ کو اپنے
keywordکے لیے "%" حرف استعمال کرنا ہو تو اسے "%25" کے طور پر متعین کریں؛اگر آپ کو اپنے
keywordکے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں؛DataForSEO APIs میں
keywordاورkeywordsفیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں - languageقسم: string
_code سرچ انجن زبان کا کوڈ
اگر آپ متعین نہ کریں تو درکار فیلڈ
language_nameاگر آپ یہ فیلڈ استعمال کریں تو
language_nameمتعین کرنے کی ضرورت نہیںآپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے
language_codeکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/google/languagesسے حاصل کر سکتے ہیںمثال:
en - languageقسم: string
_name سرچ انجن زبان کا پورا نام
اگر آپ متعین نہ کریں تو درکار فیلڈ
language_codeاگر آپ یہ فیلڈ استعمال کریں تو
language_codeمتعین کرنے کی ضرورت نہیںآپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے
language_nameکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/google/languagesسے حاصل کر سکتے ہیںمثال:
English - locationقسم: integer
_code سرچ انجن مقام کا کوڈ
اگر آپ متعین نہ کریں تو درکار فیلڈ
location_nameیاlocation_coordinateاگر آپ یہ فیلڈ استعمال کریں تو
location_nameیاlocation_coordinateمتعین کرنے کی ضرورت نہیںآپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے
location_codeکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/google/locationsسے حاصل کر سکتے ہیںمثال:
2840 - locationقسم: string
_coordinate مقام کے GPS نقاط
اگر آپ متعین نہ کریں تو درکار فیلڈ
location_nameیاlocation_codeاگر آپ یہ فیلڈ استعمال کریں تو
location_nameیاlocation_codeمتعین کرنے کی ضرورت نہیںlocation_coordinateپیرامیٹر "latitude,longitude,zoom" کی شکل میں متعین کرنا چاہیےاگر "zoom" متعین نہ ہو تو ڈیفالٹ کے طور پر 17z لاگو ہوگا
"latitude" اور "longitude" کے لیے اعشاریے ہندسوں کی زیادہ سے زیادہ تعداد: 7
"zoom" کی کم سے کم قدر: 3z
"zoom" کی زیادہ سے زیادہ قدر: 21z
مثال:
52.6178549,-155.352142,20z - locationقسم: string
_name سرچ انجن مقام کا پورا نام
اگر آپ متعین نہ کریں تو درکار فیلڈ
location_codeیاlocation_coordinateاگر آپ یہ فیلڈ استعمال کریں تو
location_codeیاlocation_coordinateمتعین کرنے کی ضرورت نہیںآپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے
location_nameکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/google/locationsسے حاصل کر سکتے ہیںمثال:
London,England,United Kingdom - maxقسم: integer | null
_crawl _pages پیج کرال کی حد
اختیاری فیلڈ
کرال کیے جانے والے سرچ نتائج کے صفحات کی تعداد
زیادہ سے زیادہ قدر:
100نوٹ:
max_crawl_pagesاورdepthپیرامیٹرز ایک دوسرے کی تکمیل کرتے ہیں؛ہمارے help center پر مزید جانیں
- osقسم: string | null
ڈیوائس آپریٹنگ سسٹم
اختیاری فیلڈ
اگر آپ
desktopکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:windows،macosڈیفالٹ قدر:
windowsاگر آپ
mobileکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:android،iosڈیفالٹ قدر:
android - seقسم: string | null
_domain سرچ انجن ڈومین
اختیاری فیلڈ
ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
مثال:
google.co.uk,google.com.au,google.de, etc. - searchقسم: boolean | null
_places سرچ پلیسز موڈ
اختیاری فیلڈ
سرچ پلیسز موڈ کسی مخصوص مقام (مثلاً نیو یارک میں Apple Store) کے لیے Google Maps نتائج حاصل کرنے کی اجازت دیتا ہے
تاہم ہمارے ڈیٹا مائننگ الگورتھم کی خصوصیات کی وجہ سے یہ موڈ کچھ لوکل-انٹینٹ کوئریز میں مداخلت کر سکتا ہے اور درخواست میں متعین مقام سے مختلف مقام کے نتائج دکھا سکتا ہے؛
اس مداخلت کو روکنے اور لوکل انٹینٹ والے کی ورڈز کے لیے درست نتائج حاصل کرنے کے لیے آپ اس پیرامیٹر کو
falseپر سیٹ کر سکتے ہیں؛
ڈیفالٹ قدر:
trueنوٹ: اگر
search_placesموڈ بند ہو اور سرچ کے علاقے میں کوئی نتیجہ نہ ملے توresultsصف خالی ہوگی - searchقسم: boolean | null
_this _area دکھائے گئے علاقے سے نتائج دکھائیں
اختیاری فیلڈ
یہ اقدار لے سکتا ہے:
true،falseڈیفالٹ قدر:
true
اگر
falseپر سیٹ کیا جائے توsearch_this_areaموڈ بند ہو جائے گا
نوٹ: اگر
search_this_areaموڈ بند ہو تو Google Maps لسٹنگز میں دکھائے گئے علاقے سے باہر کے نتائج شامل ہو سکتے ہیں - tagقسم: string | null
صارف کی متعین کردہ ٹاسک شناخت
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر کو ٹاسک کی شناخت اور اسے نتیجے سے ملانے کے لیے استعمال کر سکتے ہیں
آپ کو متعین کردہ
tagقدر جواب کےdataآبجیکٹ میں ملے گی - urlقسم: string | null
سرچ کوئری کا براہ راست URL
اختیاری فیلڈ
آپ براہ راست URL متعین کر سکتے ہیں اور ہم اسے ضروری فیلڈز میں تقسیم کر دیں گے۔ نوٹ کریں کہ یہ طریقہ ہماری API کے لیے سب سے مشکل ہے اور اس کے لیے URL میں درست زبان اور مقام متعین کرنا بھی ضروری ہے۔ زیادہ تر صورتوں میں ہم یہ طریقہ استعمال کرنے کی سفارش نہیں کرتے۔
مثال:
https://google.com/maps/search/pizza/@37.09024,-95.712891,4z
نوٹ: درج ذیل سرچ انجن پیرامیٹرز تعاون یافتہ نہیں ہیں اور URL میں متعین کیے جانے پر خودکار طور پر غیر سیٹ ہو جائیں گے:allinanchor:،allintext:،allintitle:،allinurl:،cache:،define:،definition:،filetype:،id:،inanchor:،info:،intext:،intitle:،inurl:،link:،site:۔
- قسم: object | null · Response36Afe1097B20_SerpGoogleMapsLiveAdvancedResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_SerpGoogleMapsLiveAdvancedTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: array (object | null)[] | null
نتائج کی صف
- checkقسم: string | null
_url سرچ انجن نتائج کا براہ راست URL
آپ اسے یقینی بنانے کے لیے استعمال کر سکتے ہیں کہ ہم نے عین مطابق نتائج فراہم کیے ہیں
نوٹ: مقام کے لحاظ سے مخصوص نتائج کی جانچ کے لیے فراہم کردہ check url کی پیروی کریں، اوپر نیچے اسکرول کریں، پھر "Search this area" بٹن پر کلک کریں - datetimeقسم: string | null
وہ تاریخ اور وقت جب نتیجہ موصول ہوا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - itemقسم: array (string | null)[] | null
_types SERP میں تلاش کے نتائج کی اقسام
SERP میں پائے جانے والے تلاش کے نتائج (items) کی اقسام شامل ہیں۔
ممکنہ آئٹم اقسام:maps_search,maps_paid_item - itemsقسم: array (object | null)[] | null
عنصر کے آئٹمز
- domainقسم: string | null
SERP میں ڈومین
- rankقسم: integer | null
_absolute SERP میں مطلق رینک
SERP میں تمام عناصر کے درمیان مطلق پوزیشن - rankقسم: integer | null
_group SERP میں گروپ رینک
یکساںtypeاقدار والے عناصر کے گروپ کے اندر پوزیشن
مختلفtypeاقدار والے عناصر کی پوزیشنزrank_groupسے خارج ہوتی ہیں - ratingقسم: object | null · Response36Afe1097B20_RatingInfo
عنصر کی ریٹنگ
جائزوں پر مبنی مقبولیت کی شرح جو SERP میں دکھائی جاتی ہے- ratingقسم: integer | null
_max rating_type کے لیے زیادہ سے زیادہ قدر
- ratingقسم: string | null
_type درجہ بندی کی قسم یہاں آپ درج ذیل عناصر پا سکتے ہیں: Max5، Percents، CustomMax
- valueقسم: number | null فارمیٹ: double
درجہ بندی کی قدر
- votesقسم: integer | null فارمیٹ: int64
_count تاثرات کی مقدار
- ratingقسم: object | null
_distribution کاروباری ادارے کی ریٹنگز کی تقسیم
یہ آبجیکٹ صارفین کے جائزوں کے مطابق 1 سے 5 ستاروں تک ریٹنگز کی تعداد دکھاتا ہے- propertyقسم: integer | null فارمیٹ: Int64
Name
- titleقسم: string | null
عنصر کا عنوان
- typeقسم: string | null
عنصر کی قسم
- urlقسم: string | null
ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL
- itemsقسم: integer | null فارمیٹ: int64
_count itemsصف میں واپس کیے گئے نتائج کی تعداد - keywordقسم: string | null
POST صف میں موصول ہونے والا کی ورڈ
کی ورڈ ڈی کوڈ شدہ %## کے ساتھ واپس کیا جاتا ہے (پلس کریکٹر '+' اسپیس کریکٹر میں ڈی کوڈ ہو جائے گا) - languageقسم: string | null
_code POST صف میں زبان کا کوڈ
- locationقسم: integer | null
_code POST صف میں مقام کا کوڈ
- refinementقسم: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips تلاش کی باریکی کے چپس
- itemsقسم: array (object | null)[] | null
عنصر کے آئٹمز
- domainقسم: string | null
SERP میں ڈومین
- optionsقسم: array (object | null)[] | null
مزید تلاش کی باریکی کے مزید اختیارات
- domainقسم: string | null
SERP میں ڈومین
- titleقسم: string | null
عنصر کا عنوان
- typeقسم: string | null
عنصر کی قسم
- urlقسم: string | null
ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL
- titleقسم: string | null
عنصر کا عنوان
- typeقسم: string | null
عنصر کی قسم
- urlقسم: string | null
ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL
- typeقسم: string | null
عنصر کی قسم
- xpathقسم: string | null
عنصر کا XPath
- seقسم: string | null
_domain POST صف میں سرچ انجن کا ڈومین
- seقسم: integer | null فارمیٹ: int64
_results _count SERP میں نتائج کی کل تعداد
- spellقسم: object | null · Response36Afe1097B20_SpellInfo
سرچ انجن کی خودکار تصحیح
اگر سرچ انجن نے کسی ایسے کی ورڈ کے لیے نتائج فراہم کیے جو درست کیا گیا تھا، تو ہم سرچ انجن کی درست کردہ کی ورڈ اور خودکار تصحیح کی قسم بتائیں گے- keywordقسم: string | null
سرچ انجن کی خودکار تصحیح کے نتیجے میں حاصل کردہ کی ورڈ نتائج درست کیے گئے کی ورڈ کے لیے فراہم کیے جائیں گے
- typeقسم: string | null
خودکار تصحیح کی قسم ممکنہ اقدار: did_you_mean, showing_results_for, no_results_found_for, including_results_for نوٹ: Yahoo اور Yandex صرف درج ذیل خودکار تصحیح کی قسم معاون کرتے ہیں: including_results_for
- typeقسم: string | null
عنصر کی قسم
- resultقسم: integer | null فارمیٹ: int64
_count result صف میں عناصر کی تعداد
- statusقسم: integer | null
_code ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- statusقسم: string | null
_message ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- timeقسم: string | null
عمل درآمد کا وقت، سیکنڈز
- قسم: integer | null فارمیٹ: int64tasks
_count tasks صف میں ٹاسکس کی تعداد
- قسم: integer | null فارمیٹ: int64tasks
_error خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد
- قسم: string | nulltime
کل عمل درآمد کا وقت، سیکنڈ
- قسم: string | nullversion
API کا موجودہ ورژن
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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,
"domain": null,
"title": null,
"url": null,
"rating": "[Max Depth Exceeded]",
"rating_distribution": null
}
]
}
]
}
]
}