Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

OnPage API مائیکرو ڈیٹا

سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں

DataForSEO

​

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

OnPage API مائیکرو ڈیٹا

​

ایک کرال شدہ url پر ساختیافتہ ڈیٹا کی توثیق کرتا ہے۔ مکمل شدہ کرال پڑھتا ہے، اس لیے اسے post_dataforseo_on_page_submit سے id درکار ہوتی ہے اور crawl_progress کے ساتھ crawl_status واپس کرتا ہے جس میں max_crawl_pages، pages_in_queue اور pages_crawled شامل ہیں - کسی چھوٹے نتیجے پر بھروسہ کرنے سے پہلے یہ دیکھیں، کیونکہ ابھی جاری کرال کے پاس بتانے کو کم ہوتا ہے۔ ⚠️ صفحہ لازماً کرال کا حصہ ہونا چاہیے: ایسا URL مانگنے پر جو نہیں تھا، HTTP 200 کے اندر status_code 40406، Requested page was not submitted for crawling واپس ہوتا ہے۔ اگر مطلوبہ صفحہ غائب ہو تو max_crawl_pages بڑھائیں یا submit کال پر start_url سیٹ کریں۔ 💰 اپ اسٹریم مفت: مکمل شدہ کرال سے استفسار کرنے کی کوئی لاگت نہیں، لاگت صرف خود کرال کی ہے۔

قیمت کا حوالہ

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

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

باڈی
application/json
  • قسم: array (object | null)[]
    • id
      قسم: string

      ٹاسک کی ID
      درکار فیلڈ
      آپ یہ ID Task POST endpoint کے جواب میں حاصل کر سکتے ہیں
      مثال:
      "07131248-1535-0216-1000-17384017ad04"

    • tag
      قسم: string | null

      صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
      اختیاری فیلڈ
      حروف کی حد 255 ہے
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
      آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

    • url
      قسم: string

      ریسورس کا URL
      درکار فیلڈ
      آپ یہ URL Pages endpoint کے جواب میں حاصل کر سکتے ہیں
      مثال:
      https://dataforseo.com/apis

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
        • 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

          نتائج کی صف

          • crawl_progress
            قسم: string | null

            کرالنگ سیشن کی حیثیت
            ممکنہ اقدار: in_progress, finished

          • crawl_status
            قسم: object | null · Response36Afe1097B20_CrawlStatusInfo

            کرالنگ سیشن کی تفصیلات

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

              کرال کی جانے والی صفحات کی زیادہ سے زیادہ تعداد ٹاسک سیٹ کرتے وقت آپ کے متعین کردہ max_crawl_pages کی حد بتاتا ہے

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

              کرال شدہ صفحات کی تعداد

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

              اس وقت کرالنگ قطار میں موجود صفحات کی تعداد

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

            آئٹمز کی صف

            • inspection_info
              قسم: object | null · Response36Afe1097B20_MicrodataInspectionInfo

              مائیکرو ڈیٹا توثیق سے متعلق معلومات

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

                مائیکرو ڈیٹا فیلڈز
                مخصوص مائیکرو ڈیٹا قسم سے متعلق ڈیٹا فیلڈز پر مشتمل آبجیکٹس کی صف

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

                  مائیکرو ڈیٹا فیلڈز
                  مخصوص مائیکرو ڈیٹا قسم سے متعلق ڈیٹا فیلڈز پر مشتمل آبجیکٹس کی صف

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

                    مائیکرو ڈیٹا فیلڈز
                    مخصوص مائیکرو ڈیٹا قسم سے متعلق ڈیٹا فیلڈز پر مشتمل آبجیکٹس کی صف

                  • name
                    قسم: string | null

                    فیلڈ کا نام
                    ڈیٹا فیلڈ کا نام

                  • test_results
                    قسم: object | null · Response36Afe1097B20_MessageInfo

                    مائیکرو ڈیٹا توثیق کے ٹیسٹ نتائج
                    ذیلی قسم کے مائیکرو ڈیٹا ٹیسٹ نتائج جن میں پتہ چلی خرابیوں اور متعلقہ پیغامات شامل ہیں

                    • level
                      قسم: string | null

                      خرابی کی سطح درج ذیل اقدار اختیار کر سکتا ہے: fatal, error, warning, info

                    • message
                      قسم: string | null

                      خرابی سے منسلک پیغام پتہ چلی خرابی کی تفصیلات فراہم کرنے والا پیغام

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

                    مائیکرو ڈیٹا اقسام کی فہرست

                  • value
                    قسم: string | null

                    مائیکرو ڈیٹا قدر ہدف ویب صفحے پر متعین مائیکرو ڈیٹا قدر

                • name
                  قسم: string | null

                  فیلڈ کا نام
                  ڈیٹا فیلڈ کا نام

                • test_results
                  قسم: object | null · Response36Afe1097B20_MessageInfo

                  مائیکرو ڈیٹا توثیق کے ٹیسٹ نتائج
                  ذیلی قسم کے مائیکرو ڈیٹا ٹیسٹ نتائج جن میں پتہ چلی خرابیوں اور متعلقہ پیغامات شامل ہیں

                  • level
                    قسم: string | null

                    خرابی کی سطح درج ذیل اقدار اختیار کر سکتا ہے: fatal, error, warning, info

                  • message
                    قسم: string | null

                    خرابی سے منسلک پیغام پتہ چلی خرابی کی تفصیلات فراہم کرنے والا پیغام

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

                  مائیکرو ڈیٹا اقسام کی فہرست

                • value
                  قسم: string | null

                  مائیکرو ڈیٹا قدر ہدف ویب صفحے پر متعین مائیکرو ڈیٹا قدر

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

                والد مائیکرو ڈیٹا اقسام
                دستیاب اقسام کی مکمل فہرست کے لیے schema.org ملاحظہ کریں

            • type
              قسم: string | null

              عنصر کی قسم

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

            نتائج کی صف میں آئٹمز کی تعداد

          • test_summary
            قسم: object | null · Response36Afe1097B20_TestSummary

            مائیکرو ڈیٹا توثیق کے ٹیسٹ نتائج

            • error
              قسم: integer | null

              سنگین مائیکرو ڈیٹا خرابیوں کی تعداد

            • fatal
              قسم: integer | null

              مہلک مائیکرو ڈیٹا خرابیوں کی تعداد

            • info
              قسم: integer | null

              مائیکرو ڈیٹا معلوماتی فلیگز کی تعداد

            • warning
              قسم: integer | null

              مائیکرو ڈیٹا انتباہات کی تعداد

        • 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
Request Example for post/v1/beta/dataforseo/on_page/microdata
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/microdata \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "02241700-1535-0216-0000-034137259bc1",
    "url": "https://dataforseo.com/apis"
  }
]'
{
  "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
          },
          "test_summary": {
            "fatal": null,
            "error": null,
            "warning": null,
            "info": null
          },
          "items_count": null,
          "items": [
            {
              "type": null,
              "inspection_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
OnPage API Microdata