DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
מתחרי אפליקציות App Store (בזמן אמת)
אפליקציות App Store שמתחרות באפליקציה נתונה על מילות מפתח משותפות. עימוד עם limit, offset ו-offset_token; השתמשו בטוקן לאחר העמודים הראשונים. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התאום ב-Google Play: post_dataforseo_labs_google_app_competitors_live.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.1356 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- appסוג: string
_id מזהה האפליקציה
שדה חובה
המזהה של אפליקציית המובייל ב-App Store;
אפשר למצוא את המזהה בכתובת ה-URL של כל אפליקציה הרשומה ב-App Store;
דוגמה:
בכתובת ה-URLhttps://apps.apple.com/us/app/id835599320
המזהה הוא835599320 - filtersסוג: array (object | null)[] | null
מערך של פרמטרים לסינון תוצאות
שדה אופציונלי
אפשר להוסיף כמה מסננים בבת אחת (8 מסננים לכל היותר)
יש להגדיר אופרטור לוגיandאוorבין התנאים
האופרטורים הבאים נתמכים:<,<=,>,>=,=,<>,in,not_in
דוגמה:["intersections",">",500][["competitor_metrics.app_store_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]][[["intersections",">=",50],"and",["competitor_metrics.app_store_search_organic.pos_1","in",[1,5]]],
"or",
["sum_position",">=","10000"]]מידע נוסף על מסננים מופיע בDataforseo Labs - Filters או במדריך במרכז העזרה
אובייקט ריק - languageסוג: string | null
_code קוד שפה
שדה חובה אם לא מצייניםlanguage_name
הערה: יש לצייןlanguage_nameאוlanguage_code
אפשר לקבל את רשימת השפות הזמינות עםlanguage_codeשלהן באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
הערה: נקודת קצה זו תומכת כרגע רק בשפה האנגלית
דוגמה:en - languageסוג: string
_name השם המלא של השפה
שדה חובה אם לא מצייניםlanguage_code
הערה: יש לצייןlanguage_nameאוlanguage_code
אפשר לקבל את רשימת השפות הזמינות עםlanguage_nameשלהן באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
הערה: נקודת קצה זו תומכת כרגע רק בשפה האנגלית;
דוגמה:English - limitסוג: integer | null
המספר המרבי של אפליקציות מוחזרות
שדה אופציונלי
ברירת מחדל:100
הערך המרבי:1000 - locationסוג: integer
_code קוד מיקום
שדה חובה אם לא מצייניםlocation_name
הערה: יש לצייןlocation_nameאוlocation_code
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_codeשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
הערה: נקודת קצה זו תומכת כרגע רק במיקום ארצות הברית;
דוגמה:2840 - locationסוג: string
_name השם המלא של המיקום
שדה חובה אם לא מצייניםlocation_code
הערה: יש לצייןlocation_nameאוlocation_code
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_nameשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
הערה: נקודת קצה זו תומכת כרגע רק במיקום ארצות הברית;
דוגמה:United States - offsetסוג: integer | null
היסט במערך התוצאות של האפליקציות המוחזרות
שדה אופציונלי
ברירת מחדל:0
אם תציינו את הערך10, עשר האפליקציות הראשונות במערך התוצאות יושמטו והנתונים יסופקו עבור מילות המפתח העוקבות - orderסוג: array string[] | null
_by כללי מיון תוצאות
שדה אופציונלי
אפשר להשתמש באותם ערכים כמו במערךfiltersכדי למיין את התוצאות;
סוגי מיון אפשריים:asc- התוצאות ימוינו בסדר עולה;desc- התוצאות ימוינו בסדר יורד;
יש להשתמש בפסיק כדי לציין סוג מיון;
דוגמה:["intersections,asc"]
הערה: לא ניתן להגדיר יותר משלוש כללי מיון בבקשה אחת;
יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון;
דוגמה:["intersections,desc","sum_position,asc"]כלל ברירת מחדל:
["intersections,desc"]
הערה: אם מערךitem_typesמכיל סוגי פריטים שונים מ-organic, התוצאות ימוינו לפי סוג הפריט הראשון במערך - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_DataforseoLabsAppleAppCompetitorsLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_DataforseoLabsAppleAppCompetitorsLiveTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: array (object | null)[] | null
מערך תוצאות
- appסוג: string | null
_id מזהה האפליקציה במערך POST
- itemsסוג: array (object | null)[] | null
מכיל נתונים הנוגעים ל-
app_idולאפליקציות מתחרות- appסוג: string | null
_id מזהה האפליקציה במערך POST
- avgסוג: number | null פורמט: float
_position המיקום הממוצע של האפליקציה ב-SERP של Google Play
הערה: המיקום הממוצע מחושב רק עבור מילות מפתח חופפות
הערך עבור אפליקציה נתונה עשוי להשתנות בשילוב עם אפליקציות יעד שונות - competitorסוג: object | null
_metrics מדדים עבור מילות מפתח חופפות
נתוני דירוג הנוגעים למילות המפתח שאפליקציית המתחרה שסופקה חולקת עם האפליקציה בבקשת POST
הערה: במערך זה, נתוני הדירוג מסופקים עבור ה-app_idשל המתחרה שהוחזר- propertyסוג: object · Response36Afe1097B20_AppMetricsInfo
Name - countסוג: integer | null פורמט: int64
ספירה כוללת של SERP אורגניים ב-Amazon שמכילים את המוצר
- posסוג: integer | null
_1 מספר ה-SERP האורגניים שבהם המוצר מדורג #1
- posסוג: integer | null
_11 _100 מספר ה-SERP האורגניים שבהם המוצר מדורג #11-100
- posסוג: integer | null
_2 _3 מספר ה-SERP האורגניים שבהם המוצר מדורג #2-3
- posסוג: integer | null
_4 _10 מספר ה-SERP האורגניים שבהם המוצר מדורג #4-10
- searchסוג: integer | null פורמט: int64
_volume נפח החיפוש הכולל של מילות המפתח שבהן המוצר מדורג ב-SERP אורגני
- fullסוג: object | null
_metrics מדדים עבור כל מילות המפתח של האפליקציה
סקירה מלאה של נתוני הדירוג הנוגעים לכל מילות המפתח שה-app_idשסופק מדורג עבורן- propertyסוג: object · Response36Afe1097B20_AppMetricsInfo
Name - countסוג: integer | null פורמט: int64
ספירה כוללת של SERP אורגניים ב-Amazon שמכילים את המוצר
- posסוג: integer | null
_1 מספר ה-SERP האורגניים שבהם המוצר מדורג #1
- posסוג: integer | null
_11 _100 מספר ה-SERP האורגניים שבהם המוצר מדורג #11-100
- posסוג: integer | null
_2 _3 מספר ה-SERP האורגניים שבהם המוצר מדורג #2-3
- posסוג: integer | null
_4 _10 מספר ה-SERP האורגניים שבהם המוצר מדורג #4-10
- searchסוג: integer | null פורמט: int64
_volume נפח החיפוש הכולל של מילות המפתח שבהן המוצר מדורג ב-SERP אורגני
- intersectionsסוג: integer | null
מספר מילות המפתח החופפות
- seסוג: string | null
_type סוג מנוע החיפוש
- sumסוג: integer | null
_position סכום כל מיקומי האפליקציה ב-SERP של Google Play
הערה: סכום המיקומים מחושב רק עבור מילות מפתח חופפות
הערך עבור אפליקציה נתונה עשוי להשתנות בשילוב עם אפליקציות יעד שונות
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שהוחזרו במערך
items - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- seסוג: string | null
_type סוג מנוע החיפוש
- totalסוג: integer | null פורמט: int64
_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
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_id": "686449807",
"language_name": "English",
"location_code": 2840,
"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": [
{
"se_type": null,
"app_id": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"app_id": null,
"avg_position": null,
"sum_position": null,
"intersections": null,
"competitor_metrics": null,
"full_metrics": null
}
]
}
]
}
]
}