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

Amazon Products ٹاسکس سیٹ کرنا

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

DataForSEO

​

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

Amazon Products ٹاسکس سیٹ کرنا

​

keyword کے لیے Amazon تلاش قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ location_code، depth اور se_domain اس کی شکل طے کرتے ہیں۔ یہ فیملی مکمل طور پر async ہے: submit tasks[0].id میں ایک ٹاسک id واپس کرتا ہے، اور fetch ٹول تیار ہونے پر نتیجہ دیتا ہے۔ ⚠️ Amazon endpoints لوکیل کی شکل والی زبان مانگتے ہیں - en_US، یا English (United States) - اور Google endpoints جو ننگا en قبول کرتے ہیں، اسے مسترد کرتے ہیں۔ اسے بالکل چھوڑ دینے پر بھی Invalid Field: 'language_name' ملتا ہے، اس لیے یہ پیغام غلط یا غائب، دونوں کے لیے ہے، صرف غلط کے لیے نہیں۔ get_dataforseo_merchant_amazon_languages 27 درست جوڑے بتاتا ہے۔ get_dataforseo_merchant_amazon_products_fetch سے حاصل کریں۔

قیمت کا حوالہ

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

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

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

      Amazon پروڈکٹ ڈیپارٹمنٹ
      اختیاری فیلڈ
      پروڈکٹ لسٹنگز نکالنے کے لیے درج ذیل Amazon ڈیپارٹمنٹس میں سے ایک متعین کریں:
      "Arts & Crafts", "Automotive", "Baby", "Beauty & Personal Care", "Books", "Computers", "Digital Music", "Electronics", "Kindle Store", "Prime Video", "Women's Fashion", "Men's Fashion", "Girls' Fashion", "Boys' Fashion", "Deals", "Health & Household", "Home & Kitchen", "Industrial & Scientific", "Luggage", "Movies & TV", "Music, CDs & Vinyl", "Pet Supplies", "Software", "Sports & Outdoors", "Tools & Home Improvement", "Toys & Games", "Video Games"

    • depth
      قسم: integer | null

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

    • keyword
      قسم: string

      کی ورڈ
      درکار فیلڈ
      آپ اس فیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
      تمام %## ڈی کوڈ ہوں گے (‘+’ حرف اسپیس حرف میں ڈی کوڈ ہوگا)
      اگر آپ کو اپنے keyword کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛

      DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں

    • language_code
      قسم: string

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

    • language_name
      قسم: string

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

    • location_code
      قسم: integer

      سرچ انجن مقام کا کوڈ
      اگر آپ location_name_یا location_coordinate متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات کی فہرست ان کے location_code پیرامیٹرز کے ساتھ
      https://api.dataforseo.com/v3/merchant/amazon/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      9045969

    • location_coordinate
      قسم: string

      مقام کے GPS نقاط
      اگر آپ location_name_یا location_code متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_code متعین کرنے کی ضرورت نہیں
      location_coordinate پیرامیٹر "latitude,longitude,radius" کی شکل میں متعین کرنا چاہیے
      "latitude" اور "longitude" کے لیے زیادہ سے زیادہ اعشاری ہندسے: 7
      "radius" کے لیے کم از کم قدر: 199.9
      مثال:
      53.476225,-2.243572,200

    • location_name
      قسم: string

      سرچ انجن مقام کا پورا نام
      اگر آپ location_code یا location_coordinate متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_code یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات کی فہرست ان کے location_name پیرامیٹرز کے ساتھ https://api.dataforseo.com/v3/merchant/amazon/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      HA1,England,United Kingdom

    • max_crawl_pages
      قسم: integer | null

      صفحہ کرال کی حد
      اختیاری فیلڈ
      کرال کیے جانے والے تلاش کے نتائج کے صفحات کی تعداد
      زیادہ سے زیادہ قدر: 7
      نوٹ: max_crawl_pages اور depth پیرامیٹرز ایک دوسرے کی تکمیل کرتے ہیں؛
      ہمارے help center پر مزید جانیں

    • 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 میں خصوصی حروف urlencode کیے جائیں گے؛
      مثلاً # حرف %23 میں انکوڈ کیا جائے گا

      مزید جانیں ہمارے Help Center پر

    • postback_data
      قسم: string

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

    • 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 میں خصوصی حروف urlencode کیے جائیں گے؛
      مثلاً # حرف %23 میں انکوڈ کیا جائے گا

      مزید جانیں ہمارے Help Center پر

    • price_max
      قسم: integer | null

      زیادہ سے زیادہ پروڈکٹ قیمت
      اختیاری فیلڈ
      متعین کردہ استفسار کے لیے Amazon پر درج واپس کیے گئے پروڈکٹس کی زیادہ سے زیادہ قیمت
      مثال:
      100
      نوٹ: اگر آپ price_max متعین کریں تو search_param پیرامیٹر نظر انداز کر دیا جائے گا

    • price_min
      قسم: integer | null

      کم از کم پروڈکٹ قیمت
      اختیاری فیلڈ
      متعین کردہ استفسار کے لیے Amazon پر درج واپس کیے گئے پروڈکٹس کی کم از کم قیمت
      مثال:
      5
      نوٹ: اگر آپ price_min متعین کریں تو search_param پیرامیٹر نظر انداز کر دیا جائے گا

    • priority
      قسم: integer | null

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

    • se_domain
      قسم: string | null

      سرچ انجن ڈومین
      اختیاری فیلڈ
      ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
      تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
      مثال:
      amazon.com, amazon.co.uk, amazon.fr, وغیرہ۔

    • search_param
      قسم: string | null

      تلاش کے استفسار کے اضافی پیرامیٹرز
      اختیاری فیلڈ
      تلاش کو حسب ضرورت بنانے کے لیے آپ درج ذیل Amazon سرچ URL پیرامیٹرز استعمال کر سکتے ہیں
      مثال:
      &low-price=52 - 52 USD سے زیادہ قیمت والے پروڈکٹس تلاش کریں؛
      &high-price=45 - 45 USD سے کم قیمت والے پروڈکٹس تلاش کریں؛
      &sort=relevancerank - نتائج کو متعلقہ کے حساب سے ترتیب دیں؛
      &sort=featured-rank - نتائج کو نمایاں پروڈکٹس کے حساب سے ترتیب دیں؛
      &sort=price-asc-rank - صعودی قیمت کے حساب سے ترتیب دیں؛
      &sort=price-desc-rank - نزولی قیمت کے حساب سے ترتیب دیں؛
      &sort=review-rank - اوسط صارف جائزے قدر کے حساب سے ترتیب دیں؛
      &sort=date-desc-rank - تازہ ترین آمد کے حساب سے ترتیب دیں
      نوٹ کریں کہ اگر درج ذیل پیرامیٹرز میں سے کوئی بھی استعمال ہو تو search_param قدریں نظر انداز کر دی جائیں گی: price_min, price_max, sort_by

    • sort_by
      قسم: string | null

      نتائج کی ترتیب کے قواعد
      اختیاری فیلڈ
      درج ذیل ترتیب کے قواعد معاون ہیں:
      relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival
      مثال:
      sort_by:"relevance"
      نوٹ: اگر آپ sort_by متعین کریں تو search_param پیرامیٹر نظر انداز کر دیا جائے گا

    • tag
      قسم: string | null

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

    • url
      قسم: string | null

      تلاش کے استفسار کا براہ راست URL
      اختیاری فیلڈ
      آپ براہ راست URL متعین کر سکتے ہیں اور ہم اسے مطلوبہ فیلڈز میں ترتیب دے دیں گے۔ نوٹ کریں کہ یہ طریقہ ہماری API کے لیے پروسیس کرنا سب سے مشکل ہے اور اس کے لیے URL میں درست زبان اور مقام متعین کرنا بھی لازم ہے۔ زیادہ تر صورتوں میں ہم یہ طریقہ استعمال کرنے کی تجویز نہیں دیتے۔
      مثال:
      https://www.amazon.com/s/?field-keywords=shoes&language=en_US

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

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_MerchantAmazonProductsTaskPostTaskInfo
        • 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/merchant/amazon/products/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/products/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en_US",
    "location_code": 2840,
    "keyword": "shoes"
  }
]'
{
  "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 Amazon Products Tasks

مدد چاہیے؟