v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – تلاش API

Felo API Support

MIT

سرور

https://openapi.felo.ai

کلائنٹ لائبریریاں

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO آپریشنز

post/v1/beta/dataforseo/content_analysis/search/live

Content Analysis – تلاش API

ٹوٹل کے بجائے کسی کی ورڈ کا حوالہ دینے والے انفرادی صفحات کی فہرست دیتا ہے۔ ہر آئٹم url، domain، main_domain، url_rank، domain_rank، spam_score، fetch_time، country، language، score اور page_category، ساتھ ہی total_count اور items_count رکھتا ہے۔ filters وہ فیلڈز قبول کرتا ہے جو get_dataforseo_content_available_filters میں درج ہیں۔ صفحات کے بجائے گنتی اور تقسیم کے لیے post_dataforseo_content_summary_live استعمال کریں۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: USD 0.0276۔
حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی

application/json

قسم: array (object | null)[]
- filters
  قسم: array (object | null)[] | null
  
  نتائج کی صف کے فلٹرنگ پیرامیٹرز
  اختیاری فیلڈ
  آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
  شرائط کے درمیان آپ کو منطقی آپریٹر and، or سیٹ کرنا چاہیے
  درج ذیل آپریٹرز معاون ہیں:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  آپ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے like اور not_like کے ساتھ % آپریٹر استعمال کر سکتے ہیں
  مثال:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  فلٹرز کے بارے میں مزید معلومات کے لیے Content Analysis API - Filters دیکھیں
  
  خالی آبجیکٹ
- keyword
  قسم: string
  
  ہدف کی ورڈ
  درکار فیلڈ
  UTF-8 انکوڈنگ
  کی ورڈز کو لوئر کیس فارمیٹ میں تبدیل کر دیا جائے گا؛
  نوٹ: کسی الگ کی ورڈ کے بجائے عین فقرے سے مطابقت کے لیے ڈبل کوٹس اور بیک سلیشز استعمال کریں؛
  مثال:
  "keyword": "\"tesla palo alto\""
  
  DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں
- keyword_fields
  قسم: object | null
  
  ہدف کی ورڈ فیلڈز اور ہدف کی ورڈز
  اختیاری فیلڈ
  یہ پیرامیٹر ڈیٹاسیٹ کو ان کی ورڈز کے حساب سے فلٹر کرنے کے لیے استعمال کریں جو مخصوص فیلڈز میں شامل ہونی چاہئیں؛
  آپ درج ذیل فیلڈز متعین کر سکتے ہیں: title, main_title, previous_title, snippet
  آپ کئی فیلڈز کی نشاندہی کر سکتے ہیں؛
  نوٹ: کسی الگ کی ورڈ کے بجائے عین فقرے سے مطابقت کے لیے ڈبل کوٹس اور بیک سلیشز استعمال کریں؛
  مثال:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  قسم: string | null
- limit
  قسم: integer | null
  
  واپس کیے جانے والے حوالوں کی زیادہ سے زیادہ تعداد
  اختیاری فیلڈ
  ڈیفالٹ قدر: 100
  زیادہ سے زیادہ قدر: 1000
- offset
  قسم: integer | null
  
  واپس کیے گئے حوالوں کی نتائج صف میں آفسیٹ
  اختیاری فیلڈ
  ڈیفالٹ قدر: 0
  اگر آپ 10 قدر متعین کریں تو نتائج صف کے پہلے دس حوالے چھوڑ دیے جائیں گے اور ڈیٹا اگلے حوالوں کے لیے فراہم کیا جائے گا
  نوٹ: ہم یہ پیرامیٹر صرف 10,000 تک نتائج حاصل کرنے کے لیے استعمال کرنے کی تجویز دیتے ہیں
  10,000 سے زیادہ نتائج حاصل کرنے کے لیے اس کے بجائے offset_token استعمال کریں۔
- offset_token
  قسم: string | null
  
  بعد کی درخواستوں کے لیے آفسیٹ ٹوکن
  اختیاری فیلڈ
  ہر درخواست کے جواب میں اسی فیلڈ میں فراہم کیا جاتا ہے؛
  ایک ہی درخواست میں 10,000 سے زیادہ نتائج حاصل کرنے کی کوشش کے دوران ٹائم آؤٹ سے بچنے کے لیے یہ پیرامیٹر استعمال کریں؛
  جواب کی صف سے منفرد offset_token قدر متعین کر کے آپ ابتدائی ٹاسک کے بعد کے نتائج حاصل کریں گے؛
  offset_token قدریں ہر بعد کے ٹاسک کے لیے منفرد ہوتی ہیں
  نوٹ: اگر درخواست میں offset_token متعین ہو تو ٹاسک پروسیس کرتے وقت limit کے سوا دیگر تمام پیرامیٹرز کو نظر انداز کر دیا جائے گا
  اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں
- order_by
  قسم: array string[] | null
  
  نتائج کی ترتیب کے قواعد
  اختیاری فیلڈ
  آپ نتائج کی ترتیب کے لیے filters صف کی طرح وہی اقدار استعمال کر سکتے ہیں
  ممکنہ ترتیب کی اقسام:
  asc - نتائج صعودی ترتیب میں ترتیب دیے جائیں گے
  desc - نتائج نزولی ترتیب میں ترتیب دیے جائیں گے
  ترتیب کی قسم مقرر کرنے کے لیے کوما استعمال کریں
  مثال:
  ["content_info.sentiment_connotations.anger,desc"]
  ڈیفالٹ قاعدہ:
  ["content_info.sentiment_connotations.anger,desc"]
  نوٹ کریں کہ ایک ہی درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کیے جا سکتے ہیں
  کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں
  مثال:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  قسم: array string[] | null
  
  ہدف صفحہ کی اقسام
  اختیاری فیلڈ
  یہ پیرامیٹر ڈیٹاسیٹ کو صفحہ کی اقسام کے حساب سے فلٹر کرنے کے لیے استعمال کریں
  ممکنہ اقدار:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  قسم: string | null
  
  domain_rank اور url_rank قدروں کے حساب اور نمایش کے لیے استعمال ہونے والا اسکیل متعین کرتا ہے
  اختیاری فیلڈ
  
  آپ یہ پیرامیٹر اس انتخاب کے لیے استعمال کر سکتے ہیں کہ rank قدریں 0–100 یا 0–1000 اسکیل پر دکھائی جائیں
  
  ممکنہ اقدار:
  one_hundred — rank قدریں 0–100 اسکیل پر دکھائی جاتی ہیں
  one_thousand — rank قدریں 0–1000 اسکیل پر دکھائی جاتی ہیں
  
  ڈیفالٹ قدر: one_thousand
  
  یہ پیرامیٹر کیسے کام کرتا ہے اس بارے میں اس Help Center مضمون میں مزید جانیں
- search_mode
  قسم: string | null
  
  نتائج کی گروپنگ کی قسم
  اختیاری فیلڈ
  ممکنہ گروپنگ اقسام:
  as_is - ہدف keyword کے لیے تمام حوالے واپس کرتا ہے
  one_per_domain - فی ڈومین keyword کا ایک حوالہ واپس کرتا ہے
  ڈیفالٹ قدر: as_is
- tag
  قسم: string | null
  
  صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
  اختیاری فیلڈ
  حروف کی حد 255 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

جوابات

200
قسم: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

status_code
قسم: integer | null

عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

status_message
قسم: string | null

عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

tasks
قسم: array (object | null)[] | null

ٹاسکس کی صف

قسم: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

data
قسم: object | null

وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

propertyName
قسم: object | null
id
قسم: string | null

ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

path
قسم: array (string | null)[] | null

URL پاتھ

result
قسم: array (object | null)[] | null

نتائج کی صف

items
قسم: array (object | null)[] | null

حوالہ جات اور متعلقہ ڈیٹا رکھتا ہے

content_info
قسم: object | null · Response36Afe1097B20_AnalysisContentInfo

دیے گئے url سے آنے والے حوالوں کا ڈیٹا رکھتا ہے

author
قسم: string | null

مواد کا مصنف

connotation_types
قسم: object | null

لحن کی اقسام
دی گئی حوالہ جات سے متعلق جذبات کی اقسام (جذباتی قطبیت) اور ہر جذباتی قسم کے لیے احتمال کا اشاریہ شامل ہے
ممکنہ جذباتی لحن کی اقسام: positive، negative، neutral

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

content_quality_score
قسم: integer | null

مواد کے معیار کا اسکور
یہ قدر مواد میں موجود الفاظ، جملوں اور حروف کی تعداد کی بنیاد پر شمار کی جاتی ہے

content_type
قسم: string | null

مواد کی قسم
مثال:
page_content، comment

date_published
قسم: string | null

وہ تاریخ و وقت جب مواد شائع ہوا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

group_date
قسم: string | null

حوالہ جات گروپ کی تاریخ و وقت
مواد کی اشاعت کی تاریخ یا وہ تاریخ و وقت ظاہر کرتا ہے جب ہمارے کرالر نے صفحہ پہلی بار دیکھا؛
یہ فیلڈ حوالہ جات کو تاریخ کے حساب سے گروپ کرنے اور حوالہ جات کے رجحانات دکھانے کے لیے استعمال ہو سکتی ہے؛
تاریخ و وقت UTC فارمیٹ میں دیے جاتے ہیں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

highlighted_text
قسم: string | null

snippet سے نمایاں متن

language
قسم: string | null

ڈومین کی مرکزی زبان
دستیاب زبانوں کی مکمل فہرست کے لیے Languages endpoint دیکھیں

level
قسم: integer | null

title کی سرخی کی سطح
1 (سب سے اوپر) سے 6 (سب سے نیچے) تک h-ٹیگ کی سطح ظاہر کرتا ہے

main_title
قسم: string | null

صفحے کا عنوان

previous_title
قسم: string | null

پچھلے مواد بلاک کا عنوان

rating
قسم: object | null · Response36Afe1097B20_ContententRatingInfo

مواد کی درجہ بندی
content_info سے متعلق درجہ بندی

max_rating_value
قسم: number | null فارمیٹ: double

ریٹنگ نام کے لیے زیادہ سے زیادہ قدر

name
قسم: string | null

ریٹنگ نام یہاں آپ درج ذیل عناصر دیکھ سکتے ہیں: Max5، Percents، CustomMax

rating_count
قسم: integer | null فارمیٹ: int64

ووٹوں کی تعداد

rating_value
قسم: number | null فارمیٹ: double

درجہ بندی کی قدر

relative_rating
قسم: number | null فارمیٹ: double

نسبتی ریٹنگ

semantic_location
قسم: string | null

سیمنٹک مقام
HTML میں وہ سیمنٹک عنصر ظاہر کرتا ہے جہاں ہدف کی ورڈ کا حوالہ موجود ہے
مثال:
article، header

sentiment_connotations
قسم: object | null

جذباتی لحن
دی گئی حوالہ جات سے متعلق جذبات (جذباتی ردعمل) اور ہر جذبے کے لیے احتمال کا اشاریہ شامل ہے
ممکنہ جذباتی لحن: anger، happiness، love، sadness، share، fun

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

snippet
قسم: string | null

مواد کا اسنیپٹ

snippet_length
قسم: integer | null

اسنیپٹ کی حروف کی لمبائی

social_metrics
قسم: array (object | null)[] | null

سوشل میڈیا مصروفیت کے میٹرکس
سوشل میڈیا پلیٹ فارمز کے تیار کردہ اور معاون ویب سائٹ ایمبیڈز کی بنیاد پر مواد سے وابستہ سوشل میڈیا تعاملات کا ڈیٹا

like_count
قسم: integer | null فارمیٹ: int64

لائکس کی تعداد

type
قسم: string | null

عنصر کی قسم

text_category
قسم: array integer[] | null

متن کی قسم
دستیاب زمروں کی مکمل فہرست حاصل کرنے کے لیے Categories endpoint دیکھیں

title
قسم: string | null

نتیجے کا عنوان

country
قسم: string | null

ڈومین رجسٹریشن کا ملکی کوڈ
دستیاب ممالک کی مکمل فہرست کے لیے Locations endpoint دیکھیں

domain
قسم: string | null

ڈومین نام

domain_rank
قسم: integer | null

domain کا رینک
یہ قدر DataForSEO Backlink Index سے دیے گئے ڈومین کے بیک لنک ڈیٹا پر مبنی ہے؛
domain_rank لنکڈ ڈیٹابیس میں نوڈ رینکنگ کے طریقے کی بنیاد پر شمار ہوتا ہے – یہی اصول اصل Google PageRank الگورتھم میں استعمال ہوا
اس میٹرک اور اس کے حساب کے بارے میں اس Help Center مضمون میں مزید جانیں

fetch_time
قسم: string | null

وہ تاریخ اور وقت جب ہمارے کرالر نے صفحہ کا دورہ کیا
UTC فارمیٹ میں: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:
2017-01-24 13:20:59 +00:00

language
قسم: string | null

ڈومین کی مرکزی زبان
دستیاب زبانوں کی مکمل فہرست کے لیے Languages endpoint دیکھیں

main_domain
قسم: string | null

مرکزی ڈومین

page_category
قسم: array integer[] | null

صفحے کے تمام متعلقہ زمرے رکھتا ہے
صفحے کے لیے متعلقہ مصنوعات اور خدمات کے زمرے
دستیاب زمروں کی مکمل فہرست کے لیے Categories endpoint دیکھیں

page_types
قسم: array string[] | null

صفحے کی اقسام

ratings
قسم: array (object | null)[] | null

صفحے پر ملنے والی ریٹنگز
مائیکرو ڈیٹا کی بنیاد پر صفحے پر ملنے والی تمام ریٹنگز

max_rating_value
قسم: number | null فارمیٹ: double

ریٹنگ نام کے لیے زیادہ سے زیادہ قدر

name
قسم: string | null

ریٹنگ نام یہاں آپ درج ذیل عناصر دیکھ سکتے ہیں: Max5، Percents، CustomMax

rating_count
قسم: integer | null فارمیٹ: int64

ووٹوں کی تعداد

rating_value
قسم: number | null فارمیٹ: double

درجہ بندی کی قدر

relative_rating
قسم: number | null فارمیٹ: double

نسبتی ریٹنگ

score
قسم: number | null

حوالے کی نمایاں پن اسکور
یہ قدر url_rank، domain_rank اور title، main_title، url، snippet میں keyword کی موجودگی پر مبنی ہے
score جتنا زیادہ ہو، متعلقہ حوالے کی قدر اتنی ہی زیادہ ہوتی ہے

social_metrics
قسم: array (object | null)[] | null

سوشل میڈیا مصروفیت کے میٹرکس
سوشل میڈیا پلیٹ فارمز کے تیار کردہ اور معاون ویب سائٹ ایمبیڈز کی بنیاد پر مواد سے وابستہ سوشل میڈیا تعاملات کا ڈیٹا

like_count
قسم: integer | null فارمیٹ: int64

لائکس کی تعداد

type
قسم: string | null

عنصر کی قسم

spam_score
قسم: integer | null

url کا بیک لنک اسپام اسکور
یہ قدر DataForSEO Backlink Index سے دیے گئے URL کے بیک لنک ڈیٹا پر مبنی ہے؛
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center صفحہ پر مزید جانیں

type
قسم: string | null

عنصر کی قسم

url
قسم: string | null

وہ URL جہاں حوالہ ملا

url_rank
قسم: integer | null

url کا رینک
یہ قدر DataForSEO Backlink Index سے دیے گئے URL کے بیک لنک ڈیٹا پر مبنی ہے؛
url_rank لنکڈ ڈیٹابیس میں نوڈ رینکنگ کے طریقے کی بنیاد پر شمار ہوتا ہے – یہی اصول اصل Google PageRank الگورتھم میں استعمال ہوا
اس میٹرک اور اس کے حساب کے بارے میں اس Help Center مضمون میں مزید جانیں

items_count
قسم: integer | null فارمیٹ: int64

items صف میں واپس کیے گئے نتائج کی تعداد

offset_token
قسم: string | null

بعد کی درخواستوں کے لیے آفسیٹ ٹوکن
ابتدائی ٹاسک کے بعد کے نتائج حاصل کرنے کے لیے آپ اس فیلڈ میں دی گئی اسٹرنگ استعمال کر سکتے ہیں؛
نوٹ: offset_token کی قدریں ہر بعد کے ٹاسک کے لیے منفرد ہوتی ہیں

total_count
قسم: integer | null فارمیٹ: int64

آپ کی درخواست سے متعلقہ ہمارے ڈیٹابیس میں نتائج کی کل تعداد

result_count
قسم: integer | null فارمیٹ: int64

result صف میں عناصر کی تعداد

status_code
قسم: integer | null

ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

status_message
قسم: string | null

ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

time
قسم: string | null

عمل درآمد کا وقت، سیکنڈز

tasks_count
قسم: integer | null فارمیٹ: int64

tasks صف میں ٹاسکس کی تعداد

tasks_error
قسم: integer | null فارمیٹ: int64

خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد

time
قسم: string | null

کل عمل درآمد کا وقت، سیکنڈ

version
قسم: string | null

API کا موجودہ ورژن
application/json
400

درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
401

درست Felo API کلید درکار ہے۔
402

درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
403

اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
429

درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
502

سروس درخواست مکمل نہیں کر سکی۔
503

API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
504

درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
default

خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

application/json

post/v1/beta/dataforseo/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

کامیاب آپریشن

Content Analysis – تلاش API

توثیقRequired

DataForSEO

Content Analysis – تلاش API

قیمت کا حوالہ