DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
תצוגה מסכמת של מילות מפתח
כל מה ש-Labs יודע על רשימת keywords בקריאה אחת: נפח, קושי, כוונה, תחרות ותכונות ה-SERP שהן מעוררות. מחזיר se_type, location_code, language_code, items_count ו-items. אין כאן פרמטר limit, אך התמחור לפי קריאה ולא לפי פריט, לכן שלחו את כל הרשימה בבת אחת. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התחילו כאן כשיש לכם מילות מפתח; post_dataforseo_labs_google_keyword_ideas_live היא היעד כשצריך עוד מהן.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.0254 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- includeסוג: boolean | null
_clickstream _data כלילה או החרגה של נתונים ממדדים מבוססי Clickstream בתגובה
שדה אופציונלי
אם הפרמטר מוגדר ל-true, תקבלו את השדותclickstream_keyword_info,keyword_info_normalized_with_clickstreamו-keyword_info_normalized_with_bingבתגובה
ברירת מחדל:false
כשהפרמטר מופעל, תחויבו במחיר כפול עבור הבקשהמידע נוסף על אופן חישוב המדדים מבוססי Clickstream מופיע במאמר במרכז העזרה
- includeסוג: boolean | null
_serp _info כלילת נתונים מ-SERP עבור כל מילת מפתח
שדה אופציונלי
אם הערך הואtrue, נחזיר מערךserp_infoהמכיל נתוני SERP (מספר תוצאות חיפוש, כתובת URL רלוונטית ותכונות SERP) עבור כל מילת מפתח בתגובה
ברירת מחדל:false - keywordsסוג: array string[]
keywords
שדה חובה
המספר המרבי של מילות מפתח שאפשר לציין: 700
המספר המרבי של תווים בכל מילת מפתח: 80
המספר המרבי של מילים בכל ביטוי מפתח: 10
מילות המפתח שצוינו יומרו לאותיות קטנות, והנתונים יסופקו במערך נפרדהערה שאם חלק ממילות המפתח שצוינו במערך זה מושמטות מהתוצאות שתקבלו, פירוש הדבר שמסד הנתונים שלנו אינו מכיל אותן מילות מפתח ואינו יכול להחזיר עליהן נתונים
לא תחויבו עבור מילות המפתח שהושמטו מהתוצאותמידע נוסף על הכללים והמגבלות של השדות
keywordו-keywordsב-DataForSEO API מופיע במאמר במרכז העזרה - 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 - 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 Kingdom - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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
מערך תוצאות
- itemsסוג: array (object | null)[] | null
מכיל מילות מפתח ונתונים קשורים
- avgסוג: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info נתוני קישורים נכנסים עבור מילת המפתח שהוחזרה
אובייקט זה מספק את המספר הממוצע של קישורים נכנסים, עמודים מפנים ודומיינים, וכן את ערכי הדירוג הממוצעים בקרב 10 האתרים המובילים שמדורגים אורגנית עבור מילת המפתח- backlinksסוג: number | null
מספר קישורים נכנסים ממוצע
- dofollowסוג: number | null
מספר ממוצע של קישורי dofollow
- lastסוג: string | null
_updated _time התאריך והשעה שבהם נתוני מילת המפתח עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - mainסוג: number | null
_domain _rank - rankסוג: number | null
- referringסוג: number | null
_domains מספר ממוצע של דומיינים מפנים
- referringסוג: number | null
_main _domains מספר ממוצע של דומיינים ראשיים מפנים
- referringסוג: number | null
_pages מספר ממוצע של דפים מפנים
- seסוג: string | null
_type סוג מנוע החיפוש
- clickstreamסוג: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info נתוני זרימת קליקים עבור מילת המפתח שהוחזרה
כדי לאחזר תוצאות עבור שדה זה, יש להגדיר את הפרמטרinclude_clickstream_dataל-true- ageסוג: object | null
_distribution - propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- genderסוג: object | null
_distribution - propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- lastסוג: string | null
_updated _time התאריך והשעה שבהם נתוני מילת המפתח עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - monthlyסוג: array (object | null)[] | null
_searches חיפושים חודשיים
מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הזה (כפי שזמין בשנים עשר החודשים האחרונים), הממוקדים במיקומים הגאוגרפיים שצוינו- monthסוג: integer | null
חודש
- searchסוג: integer | null
_volume שיעור נפח חיפוש חודשי ממוצע
- yearסוג: integer | null
שנה
- searchסוג: integer | null פורמט: int64
_volume שיעור נפח חיפוש חודשי ממוצע
מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com
- keywordסוג: string | null
מילת מפתח
מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח) - keywordסוג: object | null · Response36Afe1097B20_KeywordInfo
_info נתוני מילת מפתח עבור מילת המפתח שהוחזרה
- categoriesסוג: array integer[] | null
- competitionסוג: number | null
תחרות
מייצג את הכמות היחסית של תחרות הקשורה למילת המפתח הנתונה. הערך מבוסס על נתוני Google Ads ויכול לנוע בין 0 ל-1 (כולל) - competitionסוג: string | null
_level - cpcסוג: number | null
עלות לקליקה
מייצג את העלות הממוצעת לקליקה (בדולר ארה״ב) ששולמה היסטורית עבור מילת המפתח - highסוג: number | null
_top _of _page _bid ההצעה המקסימלית להצגת המודעה בראש העמוד הראשון
מציין ערך הגדול מכ-80% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST - lastסוג: string | null
_updated _time התאריך והשעה שבהם נתוני מילת המפתח עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - lowסוג: number | null
_top _of _page _bid ההצעה המינימלית להצגת המודעה בראש העמוד הראשון
מציין ערך הגדול מכ-20% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST - monthlyסוג: array (object | null)[] | null
_searches חיפושים חודשיים
מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הזה (כפי שזמין בשנים עשר החודשים האחרונים), הממוקדים במיקומים הגאוגרפיים שצוינו- monthסוג: integer | null
חודש
- searchסוג: integer | null
_volume שיעור נפח חיפוש חודשי ממוצע
- yearסוג: integer | null
שנה
- seסוג: string | null
_type סוג מנוע החיפוש
- searchסוג: integer | null פורמט: int64
_volume שיעור נפח חיפוש חודשי ממוצע
מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com - searchסוג: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend שינויים במגמת נפח החיפוש
מייצג את השינוי בנפח החיפוש באחוזים לעומת התקופה הקודמת- monthlyסוג: integer | null
שינוי בנפח החיפוש באחוזים לעומת החודש הקודם
- quarterlyסוג: integer | null
שינוי בנפח החיפוש באחוזים לעומת הרבעון הקודם
- yearlyסוג: integer | null
שינוי בנפח החיפוש באחוזים לעומת השנה הקודמת
- keywordסוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing מכיל נפח חיפוש של מילת מפתח מנורמל לנפח החיפוש ב-Bing
- isסוג: boolean | null
_normalized מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing
- lastסוג: string | null
_updated _time התאריך והשעה שבהם מערך הנתונים עודכן בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00” דוגמה: 2019-11-15 12:57:46 +00:00
- monthlyסוג: array (object | null)[] | null
_searches שיעורי נפח חיפוש חודשיים מערך אובייקטים עם שיעורי נפח חיפוש בחודש מסוים של השנה
- monthסוג: integer | null
חודש
- searchסוג: integer | null
_volume שיעור נפח חיפוש חודשי ממוצע
- yearסוג: integer | null
שנה
- searchסוג: integer | null
_volume שיעור נפח החיפוש הנוכחי של מילת מפתח
- keywordסוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream מכיל נפח חיפוש של מילת מפתח מנורמל לנתוני זרימת קליקים
- isסוג: boolean | null
_normalized מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing
- lastסוג: string | null
_updated _time התאריך והשעה שבהם מערך הנתונים עודכן בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00” דוגמה: 2019-11-15 12:57:46 +00:00
- monthlyסוג: array (object | null)[] | null
_searches שיעורי נפח חיפוש חודשיים מערך אובייקטים עם שיעורי נפח חיפוש בחודש מסוים של השנה
- monthסוג: integer | null
חודש
- searchסוג: integer | null
_volume שיעור נפח חיפוש חודשי ממוצע
- yearסוג: integer | null
שנה
- searchסוג: integer | null
_volume שיעור נפח החיפוש הנוכחי של מילת מפתח
- keywordסוג: object | null · Response36Afe1097B20_KeywordProperties
_properties מידע נוסף על מילת המפתח
- coreסוג: string | null
_keyword מילת המפתח הראשית בקבוצה
מכיל את מילת המפתח הראשית בקבוצה שנקבעת על ידי אלגוריתם אשכול המילים הנרדפות
אם הערך הואnull, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword - detectedסוג: string | null
_language השפה שזוהתה של מילת המפתח
מציין את השפה של מילת המפתח כפי שזוהתה על ידי המערכת שלנו - isסוג: boolean | null
_another _language השפה שזוהתה של מילת המפתח שונה מהשפה שהוגדרה
אםtrue, השפה שהוגדרה בבקשה אינה תואמת לשפה שהמערכת שלנו זיהתה עבור מילת מפתח נתונה - keywordסוג: integer | null
_difficulty - seסוג: string | null
_type סוג מנוע החיפוש
- synonymסוג: string | null
_clustering _algorithm האלגוריתם ששימש לזיהוי מילים נרדפות
ערכים אפשריים:keyword_metrics- מציין את האלגוריתם המבוסס על פרמטריkeyword_infotext_processing- מציין את האלגוריתם המבוסס על טקסט
אם הערך הואnull, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword - wordsסוג: integer | null פורמט: int64
_count מספר המילים במילת המפתח
מציין מכמה מילים מורכבת מילת המפתח
- languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- seסוג: string | null
_type סוג מנוע החיפוש
- searchסוג: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignסוג: array (string | null)[] | null
_intent כוונות חיפוש משלימות
ערכים אפשריים:informational,navigational,commercial,transactional - lastסוג: string | null
_updated _time התאריך והשעה שבהם נתוני מילת המפתח עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - mainסוג: string | null
_intent כוונת החיפוש הראשית
ערכים אפשריים:informational,navigational,commercial,transactional - seסוג: string | null
_type סוג מנוע החיפוש
- searchסוג: boolean | null
_partners מציין נתונים עבור Google ואתרים שותפים
אםtrue, התוצאות מוחזרות עבור רשתות בבעלות, מופעלות ומופצות ברחבי Google ואתרים שותפים שמארחים את חיפוש Google
אםfalse, התוצאות מוחזרות רק עבור אתרי חיפוש Google - serpסוג: object | null · Response36Afe1097B20_SerpInfo
_info נתוני SERP
הערך יהיהnullאם לא הגדרתם את השדהinclude_serp_infoל-trueבמערך POST או אם אין נתוני SERP עבור מילת מפתח זו במסד הנתונים שלנו- checkסוג: string | null
_url כתובת URL ישירה לתוצאות מנוע החיפוש
אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות - lastסוג: string | null
_updated _time התאריך והשעה שבהם נתוני מילת המפתח עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - previousסוג: string | null
_updated _time התאריך והשעה שלפני התאריך והשעה העדכניים ביותר שבהם נתוני SERP עודכנו
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-10-15 12:57:46 +00:00 - seסוג: integer | null פורמט: int64
_results _count מספר תוצאות החיפוש עבור מילת המפתח שהוחזרה
- seסוג: string | null
_type סוג מנוע החיפוש
- serpסוג: array (string | null)[] | null
_item _types סוגי תוצאות החיפוש ב-SERP
מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP
סוגי פריטים אפשריים:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
הערה שהתוצאות בפועל יוחזרו רק עבור רכיביorganic,paid,featured_snippetו-local_pack
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שהוחזרו במערך
items - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- seסוג: string | null
_type סוג מנוע החיפוש
- 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/google/keyword_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"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,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}