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

Apple App List ٹاسکس سیٹ کریں

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

Apple App List ٹاسکس سیٹ کریں

​

App Store کے منتخب مجموعوں میں سے ایک کو قطار میں ڈالتا ہے، جسے app_collection سے چنا جاتا ہے، اور ٹاسک id واپس کرتا ہے۔ depth حد مقرر کرتا ہے کہ چارٹ میں کتنی نیچے تک پڑھنا ہے۔ غیر ہم وقت (async): سبمٹ tasks[0].id میں ٹاسک id واپس کرتا ہے اور fetch ٹول تیار ہونے پر نتیجہ واپس کرتا ہے۔ get_dataforseo_app_apple_app_list_fetch سے حاصل کریں۔ Apple حصے میں کوئی HTML ورژن موجود نہیں۔

قیمت کا حوالہ

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

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

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

      App Store پر ایپلیکیشن کا زمرہ۔ اختیاری فیلڈ۔ آپ نتائج کو ایپ کے زمرے کے لحاظ سے فلٹر کر سکتے ہیں؛ مثال: lifestyle؛ آپ دستیاب زمروں کی مکمل فہرست یہاں دیکھ سکتے ہیں یا https://api.dataforseo.com/v3/app_data/apple/categories پر الگ درخواست بھیج کر حاصل کر سکتے ہیں

    • app_collection
      قسم: string

      ایپ مجموعہ۔ درکار فیلڈ۔ App Store پر ایپ مجموعہ جس سے ایپس جمع کی جائیں گی؛ آپ درج ذیل اقدار متعین کر سکتے ہیں: top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios

    • depth
      قسم: integer | null

      پارسنگ ڈیپتھ۔ اختیاری فیلڈ۔ App Store SERP سے واپس کیے جانے والے ایپس کی تعداد؛ ڈیفالٹ قدر: 100۔ زیادہ سے زیادہ قدر: 100۔ آپ کے اکاؤنٹ سے ہر اس SERP کے لیے بل لیا جائے گا جس میں زیادہ سے زیادہ 100 نتائج ہوں؛ لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔

    • language_code
      قسم: string | null

      سرچ انجن زبان کا کوڈ۔ اگر آپ language_name متعین نہ کریں تو درکار فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں۔ آپ دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: https://api.dataforseo.com/v3/app_data/apple/languages۔ مثال: en

    • language_name
      قسم: string | null

      سرچ انجن زبان کا پورا نام۔ اگر آپ language_code متعین نہ کریں تو درکار فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں۔ آپ دستیاب زبانوں کی فہرست language_name کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: https://api.dataforseo.com/v3/app_data/apple/languages۔ مثال: English

    • location_code
      قسم: integer | null

      سرچ انجن مقام کا کوڈ۔ اگر آپ location_name متعین نہ کریں تو درکار فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو location_name متعین کرنے کی ضرورت نہیں۔ آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: https://api.dataforseo.com/v3/app_data/apple/locations۔ مثال: 9061121

    • location_name
      قسم: string | null

      سرچ انجن مقام کا پورا نام۔ اگر آپ location_code متعین نہ کریں تو درکار فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو location_code متعین کرنے کی ضرورت نہیں۔ آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: https://api.dataforseo.com/v3/app_data/apple/locations۔ مثال: West Los Angeles,California,United States

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا نوٹیفکیشن URL۔ اختیاری فیلڈ۔ ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے۔ آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔ مثال: http://your-server.com/pingscript?id=$id۔ http://your-server.com/pingscript?id=$id&tag=$tag۔ نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛ یعنی، # حرف %23 میں انکوڈ ہو جائے گا۔ ہمارے Help Center پر مزید جانیں

    • postback_data
      قسم: string | null

      postback_url ڈیٹا ٹائپ۔ اگر آپ postback_url متعین کریں تو درکار فیلڈ۔ اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا۔ ممکنہ اقدار: advanced

    • postback_url
      قسم: string | null

      ٹاسک کے نتائج بھیجنے کے لیے URL۔ اختیاری فیلڈ۔ ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو gzip فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے۔ آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔ مثال: http://your-server.com/postbackscript?id=$id۔ http://your-server.com/postbackscript?id=$id&tag=$tag۔ نوٹ: postback_url میں خصوصی حروف urlencoded ہو جائیں گے؛ یعنی، # حرف %23 میں انکوڈ ہو جائے گا۔ ہمارے Help Center پر مزید جانیں

    • priority
      قسم: integer | null

      ٹاسک کی ترجیح۔ اختیاری فیلڈ۔ درج ذیل اقدار لے سکتا ہے: 1 – معمول کی عمل درآمد کی ترجیح (ڈیفالٹ طور پر سیٹ)۔ 2 – اعلیٰ عمل درآمد کی ترجیح۔ اعلیٰ عمل درآمد کی ترجیح والے ٹاسکس پر آپ سے اضافی چارج لیا جائے گا۔ لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔

    • tag
      قسم: string | null

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

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

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

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

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

        • data
          قسم: object | null

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

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

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

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

          URL پاتھ

        • result
          قسم: object | null

          نتائج کی صف؛ اس صورت میں قدر 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/app_data/apple/app_list/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "top_free_ios",
    "location_code": 2840,
    "language_code": "en",
    "app_category": "games"
  }
]'

{
  "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": null
    }
  ]
}

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

Setting Apple App List Tasks