DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API ریسورسز
کرال کو ملنے والے غیر صفحہ اثاثے - امیجز، اسکرپٹس، اسٹائل شیٹس - ان کے اسٹیٹس کوڈز اور سائز کے ساتھ۔ صفحات search_after_token کے ساتھ۔ مکمل شدہ کرال پڑھتا ہے، اس لیے اسے post_dataforseo_on_page_submit سے id درکار ہوتی ہے اور crawl_progress کے ساتھ crawl_status واپس کرتا ہے جس میں max_crawl_pages، pages_in_queue اور pages_crawled شامل ہیں - کسی چھوٹے نتیجے پر بھروسہ کرنے سے پہلے یہ دیکھیں، کیونکہ ابھی جاری کرال کے پاس بتانے کو کم ہوتا ہے۔ ایسے اثاثے جو کرالر بالکل حاصل نہ کر سکا، ان کے لیے post_dataforseo_on_page_uncrawlable_resources استعمال کریں۔ 💰 اپ اسٹریم مفت: مکمل شدہ کرال سے استفسار کرنے کی کوئی لاگت نہیں، لاگت صرف خود کرال کی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.012۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- filtersقسم: array (object | null)[] | null
نتائج کی فلٹرنگ پیرامیٹرز کی صف
اختیاری فیلڈ
آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
شرائط کے درمیان آپ کو منطقی آپریٹرand،orسیٹ کرنا چاہیے
درج ذیل آپریٹرز معاون ہیں:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like
آپ%آپریٹرlikeاورnot_likeکے ساتھ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے استعمال کر سکتے ہیں
مثال:["resource_type","=","stylesheet"][["resource_type","=","image"],
"and",["checks.is_https","=",false]][["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]خالی آبجیکٹ - idقسم: string
- limitقسم: integer | null
واپس کیے جانے والے ریسورسز کی زیادہ سے زیادہ تعداد
اختیاری فیلڈ
ڈیفالٹ قدر:100
زیادہ سے زیادہ قدر:1000 - offsetقسم: integer | null
واپس کیے گئے ریسورسز کی نتائج صف میں آفسیٹ
اختیاری فیلڈ
ڈیفالٹ قدر:0
زیادہ سے زیادہ قدر:2000000
اگر آپ قدر10متعین کریں تو نتائج کی صف میں پہلے دس ریسورسز چھوڑ دیے جائیں گے اور ڈیٹا اگلے ریسورسز کے لیے فراہم کیا جائے گا - orderقسم: array string[] | null
_by نتائج کی ترتیب کے قواعد
اختیاری فیلڈ
آپ نتائج کی ترتیب کے لیےfiltersصف کی طرح وہی اقدار استعمال کر سکتے ہیں
ممکنہ ترتیب کی اقسام:asc- نتائج صعودی ترتیب میں ترتیب دیے جائیں گےdesc- نتائج نزولی ترتیب میں ترتیب دیے جائیں گے
ترتیب کی قسم مقرر کرنے کے لیے کوما استعمال کریں
مثال:["size,desc"]
نوٹ کریں کہ ایک ہی درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کیے جا سکتے ہیں
کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں
مثال:["size,desc","fetch_timing.fetch_end,desc"] - relevantقسم: array string[] | null
_pages _filters متعلقہ صفحات کے لحاظ سے ریسورسز فلٹر کریں
اختیاری فیلڈ
آپ یہ فیلڈ متعین کردہ پیرامیٹرز سے مطابقت رکھنے والے صفحات سے ریسورسز حاصل کرنے کے لیے استعمال کر سکتے ہیں
یہاں آپ وہی فلٹرز لاگو کر سکتے ہیں جو pages endpoint کے لیے دستیاب ہیں
آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
شرائط کے درمیان آپ کو منطقی آپریٹرand،orسیٹ کرنا چاہیے
درج ذیل آپریٹرز معاون ہیں:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like
آپ%آپریٹرlikeاورnot_likeکے ساتھ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے استعمال کر سکتے ہیں
مثال:["checks.no_image_title","=",true] - searchقسم: string | null
_after _token بعد کی درخواستوں کے لیے ٹوکن
اختیاری فیلڈ
ہر درخواست کے جواب کے اسی فیلڈ میں فراہم کیا جاتا ہے؛
ایک ہی درخواست میں20,000سے زیادہ نتائج حاصل کرتے وقت ٹائم آؤٹ سے بچنے کے لیے یہ پیرامیٹر استعمال کریں؛
جواب کی صف سے منفردsearch_after_tokenقدر متعین کر کے آپ کو ابتدائی ٹاسک کے بعد کے نتائج ملیں گے؛search_after_tokenاقدار ہر بعد کے ٹاسک کے لیے منفرد ہوتی ہیں؛
نوٹ: اگر درخواست میںsearch_after_tokenمتعین ہو تو دیگر تمام پیرامیٹرز پچھلی درخواست کے عین مطابق ہونے چاہئیں - tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataآبجیکٹ میں متعین کردہtagقدر دیکھیں گے - urlقسم: string | null
صفحے کا URL
اختیاری فیلڈ
اگر آپ کسی مخصوص صفحے کے لیے ریسورسز حاصل کرنا چاہتے ہیں تو یہ فیلڈ متعین کریں
نوٹ کریں کہ کسی مخصوص URL سے ریسورس کاmetaحاصل کرنے کے لیے آپ کو اس فیلڈ میں URL متعین کرنا چاہیے؛
اگر آپ ٹاسک سیٹ کرتے وقتurlمتعین نہ کریں تو نتائج میں ریسورس کاmetaاس صفحے کے ڈیٹا کی بنیاد پر واپس کیا جائے گا جہاں ہمارے کرالر نے ریسورس پہلی بار دیکھا تھا
- قسم: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- 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
نتائج کی صف
- crawlقسم: string | null
_progress کرالنگ سیشن کی حیثیت
ممکنہ اقدار:in_progress,finished - crawlقسم: object | null · Response36Afe1097B20_CrawlStatusInfo
_status کرالنگ سیشن کی تفصیلات
- maxقسم: integer | null فارمیٹ: int64
_crawl _pages کرال کی جانے والی صفحات کی زیادہ سے زیادہ تعداد ٹاسک سیٹ کرتے وقت آپ کے متعین کردہ max_crawl_pages کی حد بتاتا ہے
- pagesقسم: integer | null فارمیٹ: int64
_crawled کرال شدہ صفحات کی تعداد
- pagesقسم: integer | null فارمیٹ: int64
_in _queue اس وقت کرالنگ قطار میں موجود صفحات کی تعداد
- currentقسم: integer | null
_offset Integer numbers.
- itemsقسم: array (object | null)[] | null
آئٹمز کی صف
- cacheقسم: object | null · Response36Afe1097B20_CacheControl
_control کیشنگ کے لیے ہدایات
- cachableقسم: boolean | null
بتاتا ہے کہ صفحہ کیشے کے قابل ہے یا نہیں
- ttlقسم: integer | null
ٹائم ٹو لائیو — وہ دورانیہ جس تک براؤزر کسی وسیلہ کو کیشے میں رکھتا ہے
- checksقسم: object | null
ویب سائٹ کی جانچ۔ صفحہ سے متعلق آن پیج جانچ
- propertyقسم: boolean | null
Name
- contentقسم: string | null
_encoding انکوڈنگ کی قسم
- encodedقسم: integer | null
_size انکوڈنگ کے بعد صفحہ کا سائز۔ انکوڈ شدہ صفحہ کے سائز کو بائٹس میں ظاہر کرتا ہے
- fetchقسم: string | null
_time وہ تاریخ اور وقت جب وسیلہ حاصل کیا گیا۔ UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”۔ مثال: 2019-11-15 12:57:46 +00:00
- lastقسم: object | null · Response36Afe1097B20_LastModified
_modified وسیعے سے متعلق تبدیلیوں کا ڈیٹا رکھتا ہے۔ اگر ڈیٹا نہ ہو تو قدر null ہوگی
- headerقسم: string | null
وہ تاریخ اور وقت جب ہیڈر آخری بار تبدیل کیا گیاUTC فارمیٹ میں: "yyyy-mm-dd hh-mm-ss +00:00"مثال:2019-11-15 12:57:46 +00:00اگر ڈیٹا نہ ہو تو قدر null ہوگی
- metaقسم: string | null
_tag وہ تاریخ اور وقت جب meta tag آخری بار تبدیل کیا گیاUTC فارمیٹ میں: "yyyy-mm-dd hh-mm-ss +00:00"مثال:2019-11-15 12:57:46 +00:00اگر ڈیٹا نہ ہو تو قدر null ہوگی
- sitemapقسم: string | null
وہ تاریخ اور وقت جب sitemap آخری بار تبدیل کیا گیاUTC فارمیٹ میں: "yyyy-mm-dd hh-mm-ss +00:00"مثال:2019-11-15 12:57:46 +00:00اگر ڈیٹا نہ ہو تو قدر null ہوگی
- locationقسم: string | null
location ہیڈر۔ صفحہ کو جس URL پر ری ڈائریکٹ کرنا ہے وہ بتاتا ہے
- mediaقسم: string | null
_type صفحہ دکھانے کے لیے استعمال ہونے والے میڈیا کی اقسام
- resourceقسم: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors وسیعے کی خرابیاں اور انتباہات
- errorsقسم: array (object | null)[] | null
ریسورس کی خرابیاں
- columnقسم: integer | null
وہ کالم جہاں خرابی ملی
- lineقسم: integer | null
وہ لائن جہاں خرابی ملی
- messageقسم: string | null
خرابی کا متنی پیغام ممکنہ HTML خرابیوں کی مکمل فہرست یہاں مل سکتی ہے
- statusقسم: integer | null
_code عمومی اسٹیٹس کوڈ۔ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے۔ نوٹ: ہم سختی سے تجویز کرتے ہیں کہ متعلقہ استثنائی یا خرابی کی صورتحال سنبھالنے کے لیے ضروری نظام ڈیزائن کریں
- warningsقسم: array (object | null)[] | null
ریسورس کے انتباہات
- columnقسم: integer | null
وہ کالم جہاں خرابی ملی
- lineقسم: integer | null
وہ لائن جہاں خرابی ملی
- messageقسم: string | null
خرابی کا متنی پیغام ممکنہ HTML خرابیوں کی مکمل فہرست یہاں مل سکتی ہے
- statusقسم: integer | null
_code عمومی اسٹیٹس کوڈ۔ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے۔ نوٹ: ہم سختی سے تجویز کرتے ہیں کہ متعلقہ استثنائی یا خرابی کی صورتحال سنبھالنے کے لیے ضروری نظام ڈیزائن کریں
- resourceقسم: string | null
_type عنصر کی قسم
- serverقسم: string | null
سرور ورژن
- sizeقسم: integer | null
وسیعے کا سائز۔ دیے گئے صفحہ کا سائز بائٹس میں ظاہر کرتا ہے
- statusقسم: integer | null
_code عمومی اسٹیٹس کوڈ۔ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے۔ نوٹ: ہم سختی سے تجویز کرتے ہیں کہ متعلقہ استثنائی یا خرابی کی صورتحال سنبھالنے کے لیے ضروری نظام ڈیزائن کریں
- totalقسم: integer | null فارمیٹ: int64
_transfer _size کمپریسڈ صفحہ کا سائز۔ دیے گئے صفحہ کا کمپریسڈ سائز بتاتا ہے
- urlقسم: string | null
صفحہ کا URL
- itemsقسم: integer | null فارمیٹ: int64
_count نتائج کی صف میں آئٹمز کی تعداد
- searchقسم: string | null
_after _token - totalقسم: integer | null فارمیٹ: int64
_items _count کرال کیے گئے متعلقہ آئٹمز کی کل تعداد
- 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/on_page/resources \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"filters": [
[
"resource_type",
"=",
"image"
],
"and",
[
"size",
">",
100000
]
],
"order_by": [
"size,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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"resource_type": null,
"status_code": null,
"location": null,
"url": null,
"resource_errors": "[Max Depth Exceeded]",
"size": null,
"encoded_size": null,
"total_transfer_size": null,
"fetch_time": null,
"cache_control": "[Max Depth Exceeded]",
"checks": null,
"content_encoding": null,
"media_type": null,
"server": null,
"last_modified": "[Max Depth Exceeded]"
}
]
}
]
}
]
}