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 کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: 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قسم: string
_code سرچ انجن زبان کا کوڈ
اگر آپlanguage_nameمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlanguage_nameمتعین کرنے کی ضرورت نہیں
آپ دستیاب زبانوں کی فہرست ان کےlanguage_code_پیرامیٹرز کے ساتھhttps://api.dataforseo.com/v3/merchant/amazon/languagesپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:en_GB - languageقسم: string
_name سرچ انجن زبان کا پورا نام
اگر آپlanguage_codeمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlanguage_codeمتعین کرنے کی ضرورت نہیں
آپ دستیاب زبانوں کی فہرست ان کےlanguage_nameپیرامیٹرز کے ساتھhttps://api.dataforseo.com/v3/merchant/amazon/languagesپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:English (United Kingdom) - locationقسم: integer
_code سرچ انجن مقام کا کوڈ
اگر آپlocation_name_یاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlocation_nameیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ دستیاب مقامات کی فہرست ان کےlocation_codeپیرامیٹرز کے ساتھhttps://api.dataforseo.com/v3/merchant/amazon/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:9045969 - locationقسم: string
_coordinate مقام کے 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قسم: string
_name سرچ انجن مقام کا پورا نام
اگر آپlocation_codeیاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlocation_codeیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ دستیاب مقامات کی فہرست ان کےlocation_nameپیرامیٹرز کے ساتھhttps://api.dataforseo.com/v3/merchant/amazon/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:HA1,England,United Kingdom - maxقسم: integer | null
_crawl _pages - pingbackقسم: string | null
_url مکمل شدہ ٹاسک کا اطلاعی URL
اختیاری فیلڈ
جب ٹاسک مکمل ہو جائے گا تو ہم آپ کے متعین کردہ URL پر GET درخواست بھیج کر آپ کو مطلع کریں گے
آپ ‘$id’ اسٹرنگ کو$idویری ایبل کے طور پر اور ‘$tag’ کو urlencoded$tagویری ایبل کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم مطلوبہ اقدار سیٹ کریں گے۔
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
نوٹ:pingback_urlمیں خصوصی حروف urlencode کیے جائیں گے؛
مثلاً#حرف%23میں انکوڈ کیا جائے گا - postbackقسم: string
_data postback_url ڈیٹا ٹائپ
اگر آپpostback_urlمتعین کریں تو درکار فیلڈ
اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا
ممکنہ اقدار:advanced,html - postbackقسم: string | null
_url ٹاسک کے نتائج بھیجنے کے لیے URL
اختیاری فیلڈ
ٹاسک مکمل ہونے پر ہم اس کے نتائجgzipفارمیٹ میں کمپریس کر کے آپ کے متعین کردہpostback_urlپر POST درخواست کے ذریعے بھیجیں گے
آپ ‘$id’ اسٹرنگ کو$idویری ایبل کے طور پر اور ‘$tag’ کو urlencoded$tagویری ایبل کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم مطلوبہ اقدار سیٹ کریں گے۔
مثال:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
نوٹ:postback_urlمیں خصوصی حروف urlencode کیے جائیں گے؛
مثلاً#حرف%23میں انکوڈ کیا جائے گا - priceقسم: integer | null
_max زیادہ سے زیادہ پروڈکٹ قیمت
اختیاری فیلڈ
متعین کردہ استفسار کے لیے Amazon پر درج واپس کیے گئے پروڈکٹس کی زیادہ سے زیادہ قیمت
مثال:100
نوٹ: اگر آپprice_maxمتعین کریں توsearch_paramپیرامیٹر نظر انداز کر دیا جائے گا - priceقسم: integer | null
_min کم از کم پروڈکٹ قیمت
اختیاری فیلڈ
متعین کردہ استفسار کے لیے Amazon پر درج واپس کیے گئے پروڈکٹس کی کم از کم قیمت
مثال:5
نوٹ: اگر آپprice_minمتعین کریں توsearch_paramپیرامیٹر نظر انداز کر دیا جائے گا - priorityقسم: integer | null
- seقسم: string | null
_domain سرچ انجن ڈومین
اختیاری فیلڈ
ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
مثال:amazon.com,amazon.co.uk,amazon.fr, وغیرہ۔ - searchقسم: string | null
_param تلاش کے استفسار کے اضافی پیرامیٹرز
اختیاری فیلڈ
تلاش کو حسب ضرورت بنانے کے لیے آپ درج ذیل 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قسم: string | null
_by نتائج کی ترتیب کے قواعد
اختیاری فیلڈ
درج ذیل ترتیب کے قواعد معاون ہیں: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
- قسم: object | null · Response36Afe1097B20_MerchantAmazonProductsTaskPostResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_MerchantAmazonProductsTaskPostTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: object | null
نتائج کی صف
اس صورت میں قدرnullہوگی - 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/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
}
]
}