DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
שליפת תוצאות Google Ads Search מתקדמות לפי id
מאחזר תוצאת חיפוש פרסומות של Google שנכנסה לתור, לפי id. מחזיר keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ו-items. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskGetAdvancedResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo
- 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
מערך תוצאות
- checkסוג: string | null
_url כתובת URL ישירה לתוצאות מנוע החיפוש
במקרה זה, שווה ל-null - datetimeסוג: string | null
התאריך והשעה שבהם התוצאה התקבלה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2019-11-15 12:57:46 +00:00 - itemסוג: array (string | null)[] | null
_types סוגי תוצאות החיפוש ב-SERP
מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP.
סוגי פריטים אפשריים:ads_search - itemsסוג: array (object | null)[] | null
פריטים בתוך הרכיב
- advertiserסוג: string | null
_id מזהה ייחודי של חשבון המפרסם
- creativeסוג: string | null
_id מזהה ייחודי של המודעה
- firstסוג: string | null
_shown התאריך והשעה שבהם המודעה הוצגה לראשונה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00” - formatסוג: string | null
הפורמט של המודעה
ערכים אפשריים:text,image,video - lastסוג: string | null
_shown התאריך והשעה שבהם המודעה הוצגה בפעם האחרונה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00” - previewסוג: object | null · Response36Afe1097B20_PreviewImage
_image תמונת תצוגה מקדימה של המודעה
- heightסוג: integer | null
גובה תמונת התצוגה המקדימה
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- widthסוג: integer | null פורמט: int64
רוחב תמונת התצוגה המקדימה
- previewסוג: string | null
_url כתובת URL שמצביעה לתצוגה המקדימה של המודעה
- rankסוג: integer | null
_absolute דירוג מוחלט ב-SERP
מיקום מוחלט מבין כל הרכיבים ב-SERP - rankסוג: integer | null
_group דירוג קבוצה ב-SERP
מיקום בתוך קבוצה של רכיבים עם ערכיtypeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - titleסוג: string | null
הכותרת של הרכיב
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- verifiedסוג: boolean | null
חשבון מפרסם מאומת
שווה ל-trueאם חשבון המפרסם מאומת על ידי Google Ads
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שמוחזרו במערך
items - keywordסוג: string | null
מילת המפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם קידוד %## מפוענח (הסמל '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- refinementסוג: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips שבבי עידון חיפוש
- itemsסוג: array (object | null)[] | null
הפריטים של הרכיב
- domainסוג: string | null
דומיין ב-SERP
- optionsסוג: array (object | null)[] | null
אפשרויות עידון חיפוש נוספות
- domainסוג: string | null
דומיין ב-SERP
- titleסוג: string | null
הכותרת של הרכיב
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- titleסוג: string | null
הכותרת של הרכיב
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של החיפוש עם פרמטרי עידון
- typeסוג: string | null
סוג הרכיב
- xpathסוג: string | null
ה-XPath של הרכיב
- seסוג: string | null
_domain דומיין מנוע החיפוש במערך POST
- seסוג: integer | null פורמט: int64
_results _count המספר הכולל של תוצאות ב-SERP
- spellסוג: object | null · Response36Afe1097B20_SpellInfo
תיקון אוטומטי של מנוע החיפוש
אם מנוע החיפוש סיפק תוצאות עבור מילת מפתח שתוקנה, נציין את מילת המפתח שתוקנה על ידי מנוע החיפוש ואת סוג התיקון האוטומטי;
במקרה זה, שווה ל-null- keywordסוג: string | null
מילת מפתח שהתקבלה כתוצאה מתיקון אוטומטי של מנוע החיפוש התוצאות יסופקו עבור מילת המפתח המתוקנת
- typeסוג: string | null
סוג התיקון האוטומטי ערכים אפשריים: did_you_mean, showing_results_for, no_results_found_for, including_results_for הערה: Yahoo ו-Yandex תומכים רק בסוג התיקון האוטומטי הבא: including_results_for
- typeסוג: string | 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
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"advertiser_id": null,
"creative_id": null,
"title": null,
"url": null,
"verified": null,
"format": null,
"preview_image": "[Max Depth Exceeded]",
"preview_url": null,
"first_shown": null,
"last_shown": null
}
]
}
]
}
]
}