DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
การวิเคราะห์เนื้อหา – API ค้นหา
แสดงรายการหน้าแต่ละหน้าที่อ้างอิงคำค้น แทนยอดรวม แต่ละรายการมี url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score และ page_category พร้อม total_count และ items_count filters ยอมรับฟิลด์ที่ระบุใน get_dataforseo_content_available_filters หากต้องการจำนวนและการกระจายแทนรายการหน้า ให้ใช้ post_dataforseo_content_summary_live
ข้อมูลอ้างอิงราคา
- การวัดปริมาณ: ต้นทุนการตอบกลับที่รายงาน
- ประมาณการคำขออ้างอิง: USD 0.0276
- ตัวคูณลูกค้าอ้างอิง: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่ตัดบัญชีของลูกค้าแล้ว
เป็นเพียงข้อมูลเมตาอ้างอิง ไม่ใช่ใบเสนอราคาของบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตทรัพยากรไม่ใช่เครดิต Felo การเรียกเก็บเงินขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- ประเภท: array (object | null)[]
- filtersประเภท: array (object | null)[] | null
อาร์เรย์ของพารามิเตอร์การกรองผลลัพธ์
ฟิลด์ที่ไม่บังคับ
เพิ่มตัวกรองได้หลายรายการพร้อมกัน (สูงสุด 8 ตัวกรอง)
ต้องกำหนดโอเปอเรเตอร์ทางตรรกะand,orระหว่างเงื่อนไข
รองรับโอเปอเรเตอร์ต่อไปนี้:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,match,not_match
ใช้โอเปอเรเตอร์%ร่วมกับlikeและnot_likeเพื่อจับคู่สตริงใด ๆ ที่มีอักขระศูนย์ตัวขึ้นไป
ตัวอย่าง:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองได้ที่ Content Analysis API - Filtersออบเจ็กต์ว่าง - keywordประเภท: string
คีย์เวิร์ดเป้าหมาย
ฟิลด์ที่จำเป็น
การเข้ารหัส UTF-8
คีย์เวิร์ดจะถูกแปลงเป็นตัวพิมพ์เล็ก;
หมายเหตุ: หากต้องการจับคู่วลีที่ตรงทั้งหมดแทนคีย์เวิร์ดเดี่ยว ให้ใช้เครื่องหมายอัญประกาศคู่และแบ็กสแลช;
ตัวอย่าง:"keyword": "\"tesla palo alto\""ดูรายละเอียดกฎและข้อจำกัดของฟิลด์
keywordและkeywordsใน DataForSEO API ได้ในบทความ Help Center - keywordประเภท: object | null
_fields ฟิลด์คีย์เวิร์ดเป้าหมายและคีย์เวิร์ดเป้าหมาย
ฟิลด์ที่ไม่บังคับ
ใช้พารามิเตอร์นี้เพื่อกรองชุดข้อมูลตามคีย์เวิร์ดที่ฟิลด์บางฟิลด์ควรมี;
ฟิลด์ที่ระบุได้:title,main_title,previous_title,snippet
ระบุได้หลายฟิลด์;
หมายเหตุ: หากต้องการจับคู่วลีที่ตรงทั้งหมดแทนคีย์เวิร์ดเดี่ยว ให้ใช้เครื่องหมายอัญประกาศคู่และแบ็กสแลช;
ตัวอย่าง:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyประเภท: string | null
Name
- limitประเภท: integer | null
จำนวนการอ้างอิงสูงสุดที่คืน
ฟิลด์ที่ไม่บังคับ
ค่าเริ่มต้น:100
ค่าสูงสุด:1000 - offsetประเภท: integer | null
ออฟเซตในอาร์เรย์ผลลัพธ์ของการอ้างอิงที่คืน
ฟิลด์ที่ไม่บังคับ
ค่าเริ่มต้น:0
หากระบุค่า10การอ้างอิงสิบรายการแรกในอาร์เรย์ผลลัพธ์จะถูกข้ามไป และข้อมูลจะเริ่มจากรายการอ้างอิงถัดไป
หมายเหตุ: แนะนำให้ใช้พารามิเตอร์นี้เฉพาะเมื่อดึงผลลัพธ์ไม่เกิน 10,000 รายการ
สำหรับการดึงผลลัพธ์เกิน 10,000 รายการ ให้ใช้offset_tokenแทน - offsetประเภท: string | null
_token โทเคนออฟเซตสำหรับคำขอถัดไป
ฟิลด์ที่ไม่บังคับ
มีให้ในฟิลด์เดียวกันของการตอบกลับสำหรับแต่ละคำขอ;
ใช้พารามิเตอร์นี้เพื่อหลีกเลี่ยงการหมดเวลาเมื่อพยายามรับผลลัพธ์เกิน 10,000 รายการในคำขอเดียว;
เมื่อระบุค่าoffset_tokenที่ไม่ซ้ำกันจากอาร์เรย์การตอบกลับ คุณจะได้รับผลลัพธ์ถัดไปของงานเริ่มต้น;
ค่าoffset_tokenไม่ซ้ำกันสำหรับแต่ละงานถัดไป
หมายเหตุ: หากระบุoffset_tokenในคำขอ พารามิเตอร์อื่นทั้งหมดยกเว้นlimitจะไม่ถูกนำมาพิจารณาเมื่อประมวลผลงาน
ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์นี้ได้ที่ Help Center ของเรา - orderประเภท: array string[] | null
_by กฎการเรียงลำดับผลลัพธ์
ฟิลด์ที่ไม่บังคับ
ใช้ค่าเดียวกับในอาร์เรย์filtersเพื่อเรียงลำดับผลลัพธ์ได้
ประเภทการเรียงลำดับที่เป็นไปได้:asc- เรียงผลลัพธ์จากน้อยไปมากdesc- เรียงผลลัพธ์จากมากไปน้อย
ใช้เครื่องหมายจุลภาคเพื่อกำหนดประเภทการเรียงลำดับ
ตัวอย่าง:["content_info.sentiment_connotations.anger,desc"]
กฎเริ่มต้น:["content_info.sentiment_connotations.anger,desc"]
โปรดทราบว่าตั้งกฎการเรียงลำดับได้ไม่เกินสามข้อต่อหนึ่งคำขอ
ใช้เครื่องหมายจุลภาคแยกกฎการเรียงลำดับหลายข้อ
ตัวอย่าง:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - pageประเภท: array string[] | null
_type ประเภทหน้าเป้าหมาย
ฟิลด์ที่ไม่บังคับ
ใช้พารามิเตอร์นี้เพื่อกรองชุดข้อมูลตามประเภทหน้า
ค่าที่เป็นไปได้:"ecommerce","news","blogs","message-boards","organization" - rankประเภท: string | null
_scale กำหนดสเกลที่ใช้คำนวณและแสดงค่า
domain_rankและurl_rank
ฟิลด์ที่ไม่บังคับใช้พารามิเตอร์นี้เพื่อเลือกว่าจะแสดงค่าอันดับในช่วง 0–100 หรือ 0–1000
ค่าที่เป็นไปได้:
one_hundred— แสดงค่าอันดับในช่วง 0–100one_thousand— แสดงค่าอันดับในช่วง 0–1000ค่าเริ่มต้น:
one_thousandดูรายละเอียดว่าพารามิเตอร์นี้ทำงานอย่างไรได้ในบทความ Help Center นี้
- searchประเภท: string | null
_mode ประเภทการจัดกลุ่มผลลัพธ์
ฟิลด์ที่ไม่บังคับ
ประเภทการจัดกลุ่มที่เป็นไปได้:as_is- คืนการอ้างอิงทั้งหมดสำหรับkeywordเป้าหมายone_per_domain- คืนหนึ่งการอ้างอิงของkeywordต่อโดเมน
ค่าเริ่มต้น:as_is - tagประเภท: string | null
ตัวระบุงานที่ผู้ใช้กำหนด
ฟิลด์ไม่บังคับ
จำกัด 255 อักขระ
ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
คุณจะพบค่าtagที่ระบุในออบเจ็กต์dataของการตอบกลับ
- ประเภท: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- ประเภท: number | null รูปแบบ: doublecost
ค่าใช้จ่ายรวมของงาน, USD
- ประเภท: integer | nullstatus
_code รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่
- ประเภท: string | nullstatus
_message ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่
- ประเภท: array (object | null)[] | nulltasks
อาร์เรย์ของงาน
- ประเภท: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
- costประเภท: number | null รูปแบบ: double
ค่าใช้จ่ายรวมของงาน, USD
- 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
มีการอ้างอิงและข้อมูลที่เกี่ยวข้อง
- contentประเภท: object | null · Response36Afe1097B20_AnalysisContentInfo
_info มีข้อมูลเกี่ยวกับการอ้างอิงจาก
urlที่กำหนด- authorประเภท: string | null
ผู้เขียนเนื้อหา
- connotationประเภท: object | null
_types ประเภทความหมายแฝง
มีประเภทของอารมณ์ (ขั้วอารมณ์) ที่เกี่ยวข้องกับการอ้างอิงที่กำหนด และดัชนีความน่าจะเป็นของแต่ละประเภทอารมณ์
ประเภทความหมายแฝงที่เป็นไปได้:positive,negative,neutral- propertyประเภท: integer | null รูปแบบ: int64
Name Signed 64-bit integers (long type).
- contentประเภท: integer | null
_quality _score คะแนนคุณภาพเนื้อหา
ค่านี้คำนวณจากจำนวนคำ ประโยค และอักขระที่เนื้อหามี - contentประเภท: string | null
_type ประเภทของเนื้อหา
ตัวอย่าง:page_content,comment - dateประเภท: string | null
_published วันที่และเวลาที่เนื้อหาถูกเผยแพร่
ในรูปแบบ UTC: "yyyy-mm-dd hh-mm-ss +00:00"
ตัวอย่าง:2017-01-24 13:20:59 +00:00 - groupประเภท: string | null
_date วันที่และเวลาของกลุ่มการอ้างอิง
ระบุวันที่เผยแพร่เนื้อหา หรือวันที่และเวลาที่ crawler ของเราเข้าชมหน้าเป็นครั้งแรก;
ฟิลด์นี้ใช้จัดกลุ่มการอ้างอิงตามวันที่และแสดงแนวโน้มการอ้างอิงได้;
วันที่และเวลามาในรูปแบบ UTC: "yyyy-mm-dd hh-mm-ss +00:00"
ตัวอย่าง:2017-01-24 13:20:59 +00:00 - highlightedประเภท: string | null
_text ข้อความที่ไฮไลต์จาก
snippet - languageประเภท: string | null
- levelประเภท: integer | null
ระดับหัวข้อของ
title
ระบุระดับแท็ก h ตั้งแต่1(บนสุด) ถึง6(ล่างสุด) - mainประเภท: string | null
_title ชื่อเรื่องของหน้า
- previousประเภท: string | null
_title ชื่อเรื่องของบล็อกเนื้อหาก่อนหน้า
- ratingประเภท: object | null · Response36Afe1097B20_ContententRatingInfo
คะแนนเนื้อหา
คะแนนที่เกี่ยวข้องกับcontent_info- maxประเภท: number | null รูปแบบ: double
_rating _value ค่าสูงสุดสำหรับชื่อการให้คะแนน
- nameประเภท: string | null
ชื่อการให้คะแนน ที่นี่คุณจะพบองค์ประกอบต่อไปนี้: Max5, Percents, CustomMax
- ratingประเภท: integer | null รูปแบบ: int64
_count จำนวนโหวต
- ratingประเภท: number | null รูปแบบ: double
_value ค่าของคะแนน
- relativeประเภท: number | null รูปแบบ: double
_rating คะแนนสัมพัทธ์
- semanticประเภท: string | null
_location ตำแหน่งเชิงความหมาย
ระบุองค์ประกอบเชิงความหมายใน HTML ที่การอ้างอิงคีย์เวิร์ดเป้าหมายอยู่
ตัวอย่าง:article,header - sentimentประเภท: object | null
_connotations ความหมายแฝงทางอารมณ์
มีอารมณ์ (ปฏิกิริยาทางอารมณ์) ที่เกี่ยวข้องกับการอ้างอิงที่กำหนด และดัชนีความน่าจะเป็นของแต่ละอารมณ์
ความหมายแฝงทางอารมณ์ที่เป็นไปได้:anger,happiness,love,sadness,share,fun- propertyประเภท: integer | null รูปแบบ: int64
Name Signed 64-bit integers (long type).
- snippetประเภท: string | null
สแนปเปตเนื้อหา
- snippetประเภท: integer | null
_length ความยาวเป็นอักขระของสแนปเปต
- socialประเภท: array (object | null)[] | null
_metrics ตัวชี้วัดการมีส่วนร่วมบนโซเชียลมีเดีย
ข้อมูลเกี่ยวกับการโต้ตอบบนโซเชียลมีเดียที่เกี่ยวข้องกับเนื้อหา โดยอ้างอิงจาก embed บนเว็บไซต์ที่พัฒนาและสนับสนุนโดยแพลตฟอร์มโซเชียลมีเดีย- likeประเภท: integer | null รูปแบบ: int64
_count จำนวนไลก์
- typeประเภท: string | null
ประเภทขององค์ประกอบ
- textประเภท: array integer[] | null
_category - titleประเภท: string | null
ชื่อเรื่องของผลลัพธ์
- countryประเภท: string | null
- domainประเภท: string | null
ชื่อโดเมน
- domainประเภท: integer | null
_rank - fetchประเภท: string | null
_time วันที่และเวลาที่ครอว์เลอร์ของเราเข้าชมหน้าเว็บ
ในรูปแบบ UTC: "yyyy-mm-dd hh-mm-ss +00:00"
ตัวอย่าง:2017-01-24 13:20:59 +00:00 - languageประเภท: string | null
- mainประเภท: string | null
_domain โดเมนหลัก
- pageประเภท: array integer[] | null
_category - pageประเภท: array string[] | null
_types ประเภทหน้าเว็บ
- ratingsประเภท: array (object | null)[] | null
คะแนนที่พบบนหน้าเว็บ
คะแนนทั้งหมดที่พบบนหน้าเว็บตามไมโครเดตา- maxประเภท: number | null รูปแบบ: double
_rating _value ค่าสูงสุดสำหรับชื่อการให้คะแนน
- nameประเภท: string | null
ชื่อการให้คะแนน ที่นี่คุณจะพบองค์ประกอบต่อไปนี้: Max5, Percents, CustomMax
- ratingประเภท: integer | null รูปแบบ: int64
_count จำนวนโหวต
- ratingประเภท: number | null รูปแบบ: double
_value ค่าของคะแนน
- relativeประเภท: number | null รูปแบบ: double
_rating คะแนนสัมพัทธ์
- scoreประเภท: number | null
คะแนนความเด่นของการอ้างอิง
ค่านี้อ้างอิงจากurl_rank,domain_rank, การปรากฏของkeywordในtitle,main_title,url,snippet
ยิ่งscoreสูง การอ้างอิงที่เกี่ยวข้องก็ยิ่งมีคุณค่ามากขึ้น - socialประเภท: array (object | null)[] | null
_metrics ตัวชี้วัดการมีส่วนร่วมบนโซเชียลมีเดีย
ข้อมูลเกี่ยวกับการโต้ตอบบนโซเชียลมีเดียที่เกี่ยวข้องกับเนื้อหา โดยอ้างอิงจาก embed บนเว็บไซต์ที่พัฒนาและสนับสนุนโดยแพลตฟอร์มโซเชียลมีเดีย- likeประเภท: integer | null รูปแบบ: int64
_count จำนวนไลก์
- typeประเภท: string | null
ประเภทขององค์ประกอบ
- spamประเภท: integer | null
_score - typeประเภท: string | null
ประเภทขององค์ประกอบ
- urlประเภท: string | null
URL ที่พบการอ้างอิง
- urlประเภท: integer | null
_rank
- itemsประเภท: integer | null รูปแบบ: int64
_count จำนวนผลลัพธ์ที่ส่งคืนในอาร์เรย์
items - offsetประเภท: string | null
_token โทเคนออฟเซ็ตสำหรับคำขอถัดไป
คุณสามารถใช้สตริงที่ให้ไว้ในฟิลด์นี้เพื่อรับผลลัพธ์ถัดไปของงานเริ่มต้น;
หมายเหตุ: ค่าoffset_tokenไม่ซ้ำกันสำหรับแต่ละงานถัดไป - 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/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}