DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – ریٹنگ تقسیم API
کی ورڈ کے حوالوں کو ریٹنگ بالٹیوں میں تقسیم کرتا ہے اور ہر ایک کے لیے مکمل میٹرک سیٹ بتاتا ہے۔ ہر بالٹی کے لیے ایک اندراج min، max اور ایک metrics آبجیکٹ کے ساتھ واپس کرتا ہے جس میں total_count، rank، top_domains (ہر ایک domain اور count)، sentiment_connotations (anger، happiness، love، sadness، share، fun)، connotation_types (positive، negative، neutral)، text_categories، page_categories، page_types، countries اور languages ہیں۔ rank_scale بالٹی بندی منتخب کرتا ہے۔ وہی میٹرکس بغیر بالٹی کے لیے post_dataforseo_content_summary_live استعمال کریں؛ صرف جذبات کے لیے post_dataforseo_content_sentiment_analysis_live۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.0276۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- initialقسم: array (object | null)[] | null
_dataset _filters ابتدائی ڈیٹاسیٹ فلٹرنگ کے پیرامیٹرز
اختیاری فیلڈ
ابتدائی فلٹرنگ پیرامیٹرز جو Search endpoint میں فیلڈز پر لاگو ہوتے ہیں
آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
شرائط کے درمیان آپ کو منطقی آپریٹرand،orسیٹ کرنا چاہیے
درج ذیل آپریٹرز معاون ہیں:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
آپ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیےlikeاورnot_likeکے ساتھ%آپریٹر استعمال کر سکتے ہیں
مثال:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
فلٹرز کے بارے میں مزید معلومات کے لیے Content Analysis API - Filters دیکھیں
ابتدائی ڈیٹاسیٹ فلٹرز کے بارے میں اس help center مضمون میں مزید جانیں۔خالی آبجیکٹ - internalقسم: integer | null
_list _limit اندرونی صفوں میں عناصر کی زیادہ سے زیادہ تعداد
اختیاری فیلڈ
آپ یہ فیلڈ درج ذیل صفوں میں عناصر کی تعداد محدود کرنے کے لیے استعمال کر سکتے ہیں:top_domainstext_categoriespage_categoriescountrieslanguages
ڈیفالٹ قدر:1
زیادہ سے زیادہ قدر:20 - keywordقسم: string
ہدف کی ورڈ
درکار فیلڈ
UTF-8 انکوڈنگ
کی ورڈز کو لوئر کیس فارمیٹ میں تبدیل کر دیا جائے گا؛
نوٹ: کسی الگ کی ورڈ کے بجائے عین فقرے سے مطابقت کے لیے ڈبل کوٹس اور بیک سلیشز استعمال کریں؛
مثال:"keyword": ""tesla palo alto""DataForSEO APIs میں
keywordاورkeywordsفیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں - keywordقسم: object | null
_fields ہدف کی ورڈ فیلڈز اور ہدف کی ورڈز
اختیاری فیلڈ
یہ پیرامیٹر ڈیٹاسیٹ کو ان کی ورڈز کے حساب سے فلٹر کرنے کے لیے استعمال کریں جو مخصوص فیلڈز میں شامل ہونی چاہئیں؛
آپ درج ذیل فیلڈز متعین کر سکتے ہیں:title,main_title,previous_title,snippet
آپ کئی فیلڈز کی نشاندہی کر سکتے ہیں؛
نوٹ: کسی الگ کی ورڈ کے بجائے عین فقرے سے مطابقت کے لیے ڈبل کوٹس اور بیک سلیشز استعمال کریں؛
مثال:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}- propertyقسم: string | null
Name
- pageقسم: array string[] | null
_type ہدف صفحہ کی اقسام
اختیاری فیلڈ
یہ پیرامیٹر ڈیٹاسیٹ کو صفحہ کی اقسام کے حساب سے فلٹر کرنے کے لیے استعمال کریں
ممکنہ اقدار:"ecommerce","news","blogs","message-boards","organization" - positiveقسم: number | null
_connotation _threshold مثبت مفہوم کی حد
اختیاری فیلڈ
حوالے کے مواد سے متعلق مثبت جذبات کے لیے احتمال انڈیکس کی حد کے طور پر متعین
اگر آپ یہ فیلڈ متعین کریں تو جواب میںconnotation_typesآبجیکٹ صرف ان حوالوں کا ڈیٹا رکھے گا جن میںpositiveجذبات کا احتمال متعین قدر سے زیادہ یا اس کے برابر ہو
ممکنہ اقدار:0سے1تک
ڈیفالٹ قدر:0.4 - rankقسم: string | null
_scale rankقدروں کے حساب اور نمایش کے لیے استعمال ہونے والا اسکیل متعین کرتا ہے
اختیاری فیلڈآپ یہ پیرامیٹر اس انتخاب کے لیے استعمال کر سکتے ہیں کہ rank قدریں 0–100 یا 0–1000 اسکیل پر دکھائی جائیں
ممکنہ اقدار:
one_hundred— rank قدریں 0–100 اسکیل پر دکھائی جاتی ہیںone_thousand— rank قدریں 0–1000 اسکیل پر دکھائی جاتی ہیںڈیفالٹ قدر:
one_thousandیہ پیرامیٹر کیسے کام کرتا ہے اس بارے میں اس Help Center مضمون میں مزید جانیں
- searchقسم: string | null
_mode نتائج کی گروپنگ کی قسم
اختیاری فیلڈ
ممکنہ گروپنگ اقسام:as_is- ہدفkeywordکے لیے تمام حوالے واپس کرتا ہےone_per_domain- فی ڈومینkeywordکا ایک حوالہ واپس کرتا ہے
ڈیفالٹ قدر:as_is - sentimentsقسم: number | null
_connotation _threshold جذباتی مفہوم کی حد
اختیاری فیلڈ
حوالے کے مواد سے متعلق جذباتی مفاہیم کے لیے احتمال انڈیکس کی حد کے طور پر متعین
اگر آپ یہ فیلڈ متعین کریں تو جواب میںsentiment_connotationsآبجیکٹ صرف ان حوالوں کا ڈیٹا رکھے گا جن میں ہر جذبے کا احتمال متعین قدر سے زیادہ یا اس کے برابر ہو
ممکنہ اقدار:0سے1تک
ڈیفالٹ قدر:0.4 - tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataآبجیکٹ میں متعین کردہtagقدر دیکھیں گے
- قسم: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
- 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
نتائج کی صف
- maxقسم: number | null
تقسیم کے اسکیل پر زیادہ سے زیادہ ریٹنگ
- metricsقسم: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
ریٹنگ کی تقسیم کے میٹرکس رکھتا ہے
- connotationقسم: object | null
_types لحن کی اقسام
کی ورڈ کے حوالے سے متعلق جذبات کی اقسام (جذباتی قطبیت) اور ہر جذباتی قسم کے لیے حوالوں کی تعداد رکھتا ہے
ممکنہ جذباتی لحن کی اقسام:positive،negative،neutral- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- countriesقسم: object | null
- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- languagesقسم: object | null
- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- pageقسم: array (object | null)[] | null
_categories - categoryقسم: array (integer | null)[] | null
- countقسم: integer | null فارمیٹ: int64
Signed 64-bit integers (long type).
- pageقسم: object | null
_types صفحے کی اقسام
صفحے کی اقسام اور ہر صفحہ قسم کے لیے حوالوں کی تعداد رکھتا ہے- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- rankقسم: integer | null
keywordکا حوالہ دینے والے تمام URLs کا رینک
ہدفkeywordکا حوالہ دینے والے تمام URLs کے رینک کا نارملائزڈ مجموعہ - sentimentقسم: object | null
_connotations جذباتی لحن
ہدف کی ورڈ کے حوالے سے متعلق جذبات (جذباتی ردعمل) اور ہر جذبے کے لیے حوالوں کی تعداد رکھتا ہے
ممکنہ جذباتی لحن:anger،happiness،love،sadness،share،fun- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- textقسم: array (object | null)[] | null
_categories - categoryقسم: array (integer | null)[] | null
- countقسم: integer | null فارمیٹ: int64
Signed 64-bit integers (long type).
- topقسم: array (object | null)[] | null
_domains ہدف کی ورڈ کا حوالہ دینے والے سرفہرست ڈومینز
ہدف کی ورڈ کا حوالہ دینے والے سرفہرست ڈومینز اور ہر ڈومین کے لیے حوالوں کی تعداد والے آبجیکٹس رکھتا ہے- countقسم: integer | null فارمیٹ: int64
Signed 64-bit integers (long type).
- domainقسم: string | null
- totalقسم: integer | null فارمیٹ: int64
_count آپ کی درخواست سے متعلقہ ہمارے ڈیٹابیس میں نتائج کی کل تعداد
- typeقسم: string | null
عنصر کی قسم
- minقسم: number | null
تقسیم کے اسکیل پر کم از کم ریٹنگ
- 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/content_analysis/rating_distribution/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"internal_list_limit": 10
}
]'
{
"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": [
{
"type": null,
"min": null,
"max": null,
"metrics": {
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
"[Max Depth Exceeded]"
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
"[Max Depth Exceeded]"
],
"page_categories": [
"[Max Depth Exceeded]"
],
"page_types": null,
"countries": null,
"languages": null
}
}
]
}
]
}