DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Gemini LLM Scraper מתקדם בזמן אמת
שואל את Gemini על keyword כפי שמשתמש היה עושה, ומחזיר את התשובה מפוענחת. מחזיר keyword, location_code, language_code, model, datetime, markdown, sources, se_results_count, item_types, items_count ו-items. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התאום ב-ChatGPT הוא post_dataforseo_ai_chat_gpt_llm_scraper_live; הרצת שניהם והשוואתם היא המטרה של המשפחה הזו.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.701 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- keywordסוג: string
keyword
שדה חובה
אפשר לציין עד 2000 תווים בשדהkeyword
כל קידודי %## יפענחו (גם התו ‘+’ יפענח לרווח)
אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”;
אם אתם צריכים להשתמש בתו “+” ב-keyword, ציינו אותו כ-“%2B”מידע נוסף על הכללים והמגבלות של השדות
keywordו-keywordsב-DataForSEO API מופיע במאמר במרכז העזרה - languageסוג: string
_code קוד שפת מנוע החיפוש
שדה חובה אם לא מצייניםlanguage_name;
אם משתמשים בשדה הזה, אין צורך לצייןlanguage_name;
אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עםlanguage_codeשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
דוגמה:en - languageסוג: string
_name השם המלא של שפת מנוע החיפוש
שדה חובה אם לא מצייניםlanguage_code;
אם משתמשים בשדה הזה, אין צורך לצייןlanguage_code;
אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עםlanguage_nameשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
דוגמה:English - locationסוג: integer
_code קוד מיקום מנוע החיפוש
שדה חובה אם לא מצייניםlocation_nameאוlocation_coordinate
אם משתמשים בשדה הזה, אין צורך לצייןlocation_nameאוlocation_coordinate
אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עםlocation_codeשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
דוגמה:2840 - locationסוג: string
_coordinate קואורדינטות GPS של מיקום
שדה חובה אם לא מציינים
location_nameאוlocation_codeאם משתמשים בשדה הזה, אין צורך לציין
location_nameאוlocation_codeאת הפרמטר
location_coordinateיש לציין בפורמט "latitude,longitude,radius"המספר המרבי של ספרות עשרוניות ב-"latitude" וב-"longitude": 7
הערך המזערי של "radius": 199 (מ״מ)
הערך המרבי של "radius": 199999 (מ״מ)
דוגמה:
53.476225,-2.243572,200 - locationסוג: string
_name השם המלא של מיקום מנוע החיפוש
שדה חובה אם לא מצייניםlocation_codeאוlocation_coordinate
אם משתמשים בשדה הזה, אין צורך לצייןlocation_codeאוlocation_coordinate
אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עםlocation_nameשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
דוגמה:United States - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo
- 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
מערך תוצאות
- 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 סוגי תוצאות החיפוש
מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP.
סוגי פריטים אפשריים:gemini_text,gemini_table,gemini_images - itemsסוג: array (object | null)[] | null
רכיבים של תוצאות Gemini
- markdownסוג: string | null
- rankסוג: integer | null
_absolute דירוג מוחלט ב-SERP
מיקום מוחלט מבין כל הרכיבים ב-SERP - rankסוג: integer | null
_group דירוג קבוצה ב-SERP
מיקום בתוך קבוצה של רכיבים עם ערכיtypeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - typeסוג: string | null
סוג הרכיב
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שמוחזרו במערך
items - keywordסוג: string | null
מילת המפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם קידוד %## מפוענח (הסמל '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- markdownסוג: string | null
- modelסוג: string | null
מציין את גרסת המודל
- seסוג: integer | null פורמט: int64
_results _count המספר הכולל של תוצאות
- sourcesסוג: array (object | null)[] | null
מערך של מקורות
המקורות שהמודל ציטט או הסתמך עליהם בפועל בתשובתו הסופית- domainסוג: string | null
דומיין המקור ב-SERP
- markdownסוג: string | null
- publicationסוג: string | null
_date התאריך והשעה שבהם התוצאה פורסמה
בפורמט: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
דוגמה:2019-11-15 12:57:46 +00:00 - snippetסוג: string | null
תיאור המקור
- sourceסוג: string | null
_name שם המקור
- thumbnailסוג: string | null
תמונה ממוזערת של המקור
- titleסוג: string | null
כותרת המקור
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL של המקור
- 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/ai_optimization/gemini/llm_scraper/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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,
"location_code": null,
"language_code": null,
"model": null,
"datetime": null,
"markdown": null,
"sources": [
{
"type": null,
"title": null,
"snippet": null,
"domain": null,
"url": null,
"thumbnail": null,
"source_name": null,
"publication_date": null,
"markdown": null
}
],
"se_results_count": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"markdown": null
}
]
}
]
}
]
}