v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions Cross Aggregated Metrics trực tiếp

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Thao tác

post/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live

LLM Mentions Cross Aggregated Metrics trực tiếp

So sánh chỉ số mentions giữa nhiều mục tiêu trong một lần gọi, nhóm theo aggregation_key. Nhận targets là danh sách các mảng mục tiêu thay vì target đơn lẻ như các endpoint cùng nhóm - hình dạng khác nhau, trộn lẫn sẽ bị từ chối vì trường không xác định. ⚠️ target là mảng các đối tượng, mỗi phần tử là {"domain": "..."} hoặc {"keyword": "..."}; một chuỗi trần sẽ bị từ chối vì sai kiểu, còn mảng chuỗi sẽ bị từ chối với thông báo 'Each target item must be an object'. Các trường lọc lấy từ get_dataforseo_ai_llm_mentions_available_filters. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Chạy post_dataforseo_ai_llm_mentions_aggregated_metrics_live lần lượt cho từng mục tiêu có cùng chi phí mỗi lần gọi, nên hãy dùng công cụ này khi bản thân việc so sánh là mục đích.

Tham chiếu giá

Cách tính: chi phí phản hồi được báo cáo.
Ước tính tham chiếu mỗi yêu cầu: 0,101 USD.
Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân

bắt buộc

application/json

Kiểu: array object[]
- targets
  Kiểu: array object[]
  bắt buộc
  
  mảng các đối tượng chứa thực thể mục tiêu kèm khóa tổng hợp; trường bắt buộc; bạn có thể chỉ định tối đa 10 nhưng không ít hơn 2 bộ tham số mục tiêu, mỗi bộ có aggregation_key; ví dụ về mảng targets với nhiều thực thể: [{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match"}]}]
  
  aggregation_key
  Kiểu: string
  bắt buộc
  
  khóa tổng hợp để nhóm kết quả; trường bắt buộc; nhóm kết quả để so sánh và đóng vai trò nhãn cho nhóm; bạn có thể chỉ định tối đa 250 ký tự trong trường aggregation_key
  
  target
  Kiểu: array object[]
  bắt buộc
  
  mảng các đối tượng chứa thực thể mục tiêu; trường bắt buộc; một target có thể chứa tối đa 10 thực thể domain và/hoặc keyword
  
  domain
  Kiểu: string
  bắt buộc
  
  tên miền mục tiêu trường bắt buộc nếu bạn không chỉ định từ khóa, bạn có thể chỉ định tối đa 63 ký tự trong trường domain; tên miền phải được chỉ định mà không có https:// và www.
  
  include_subdomains
  Kiểu: boolean
  
  cho biết các tên miền con của domain mục tiêu có được đưa vào tìm kiếm hay không; trường tùy chọn; nếu đặt thành true, các tên miền con sẽ được đưa vào tìm kiếm; giá trị mặc định: false
  
  keyword
  Kiểu: string
  
  từ khóa mục tiêu trường bắt buộc nếu bạn không chỉ định tên miền, bạn có thể chỉ định tối đa 250 ký tự trong trường keyword; mọi %## sẽ được giải mã (ký tự ‘+’ cũng sẽ được giải mã thành ký tự khoảng trắng); nếu bạn cần dùng ký tự “%” cho từ khóa, hãy chỉ định dưới dạng “%25”; nếu bạn cần dùng ký tự “+” cho từ khóa, hãy chỉ định dưới dạng “%2B”. Tìm hiểu thêm về quy tắc và giới hạn của các trường keyword và keywords trong API DataForSEO tại bài viết Trung tâm trợ giúp này
  
  match_type
  Kiểu: string
  
  kiểu khớp của từ khóa mục tiêu xác định cách khớp từ khóa đã chỉ định trường tùy chọn giá trị khả dụng: word_match - tìm kiếm toàn văn các thuật ngữ khớp với từ khóa hạt giống đã chỉ định kèm thêm từ đứng trước, sau hoặc bên trong cụm khóa (ví dụ: tìm "light" sẽ trả về kết quả có "light bulb", "light switch"); partial_match - tìm kiếm chuỗi con, tìm mọi lần xuất hiện chứa chuỗi ký tự đã chỉ định, kể cả khi nằm trong một từ dài hơn (ví dụ: tìm "light" sẽ trả về kết quả có "lighting", "highlight"); giá trị mặc định: word_match
  
  search_filter
  Kiểu: string
  
  Bộ lọc tìm kiếm thực thể: include hoặc exclude; mặc định là include.
  
  search_scope
  Kiểu: array string[]
  
  Phạm vi tìm kiếm. Thực thể domain: any, sources, search_results. Thực thể keyword: any, question, answer, brand_entities, fan_out_queries. Mặc định: any.
- initial_dataset_filters
  Kiểu: array
  
  mảng biểu thức lọc được áp dụng trước khi tổng hợp; trường tùy chọn; bạn có thể dùng mảng này để lọc các biểu thức áp dụng cho cơ sở dữ liệu đề cập thô trước khi tổng hợp, nhằm giới hạn các hàng đóng góp vào kết quả; bạn có thể thêm nhiều bộ lọc cùng lúc (tối đa 8 bộ lọc); bạn nên đặt toán tử logic and hoặc or giữa các điều kiện; các toán tử sau được hỗ trợ: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match; bạn có thể dùng toán tử % với like và not_like để khớp bất kỳ chuỗi nào có 0 ký tự trở lên; ví dụ: ["ai_search_volume",">","1000"]; danh sách đầy đủ các bộ lọc khả dụng có tại đây. Tìm hiểu thêm về bộ lọc tập dữ liệu ban đầu trong bài viết trung tâm trợ giúp này.
- internal_list_limit
  Kiểu: integer
  
  số phần tử tối đa trong các mảng nội bộ; trường tùy chọn; bạn có thể dùng trường này để giới hạn số phần tử trong các mảng sau: sources_domain, search_results_domain; giá trị tối thiểu: 1; giá trị tối đa: 10; giá trị mặc định: 5
- language_code
  Kiểu: string
  
  mã ngôn ngữ tìm kiếm; trường tùy chọn; nếu bạn dùng trường này, bạn không cần chỉ định language_name; bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm cùng language_code của chúng bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; giá trị mặc định: en; Lưu ý: dữ liệu chat_gpt chỉ khả dụng cho en
- language_name
  Kiểu: string
  
  tên đầy đủ của ngôn ngữ tìm kiếm; trường tùy chọn; nếu bạn dùng trường này, bạn không cần chỉ định language_code; nếu bạn không chỉ định trường này, language_code với giá trị en sẽ được dùng mặc định; bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm cùng language_name của chúng bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Lưu ý: dữ liệu chat_gpt chỉ khả dụng cho tiếng Anh
- location_code
  Kiểu: integer
  
  mã vị trí tìm kiếm; trường tùy chọn; nếu bạn dùng trường này, bạn không cần chỉ định location_name; bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm cùng location_code của chúng bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; giá trị mặc định: 2840; Lưu ý: dữ liệu chat_gpt chỉ khả dụng cho 2840
- location_name
  Kiểu: string
  
  tên đầy đủ của vị trí tìm kiếm; trường tùy chọn; nếu bạn dùng trường này, bạn không cần chỉ định location_code; nếu bạn không chỉ định trường này, location_code với giá trị 2840 sẽ được dùng mặc định; bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm cùng location_name của chúng bằng cách gửi một yêu cầu riêng đến https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Lưu ý: dữ liệu chat_gpt chỉ khả dụng cho United States
- platform
  Kiểu: string
  
  nền tảng mục tiêu; trường tùy chọn; giá trị khả dụng: chat_gpt, google; giá trị mặc định: google; Lưu ý: dữ liệu trả về phụ thuộc vào nền tảng đã chọn; Lưu ý #2: dữ liệu chat_gpt chỉ khả dụng cho United States và tiếng Anh
- tag
  Kiểu: string
  
  mã định danh tác vụ do người dùng xác định; trường tùy chọn; giới hạn ký tự là 255; bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả; bạn sẽ thấy giá trị tag đã chỉ định trong đối tượng data của phản hồi

Phản hồi

200
Kiểu: object

Phản hồi thành công
cost
Kiểu: number

tổng chi phí tác vụ, USD

status_code
Kiểu: integer

mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây; Lưu ý: chúng tôi khuyến nghị mạnh mẽ việc thiết kế một hệ thống cần thiết để xử lý các tình trạng ngoại lệ hoặc lỗi liên quan

status_message
Kiểu: string

thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

tasks
Kiểu: array string[]

mảng tác vụ

tasks_count
Kiểu: integer

số lượng tác vụ trong mảng tasks

tasks_error
Kiểu: integer

số lượng tác vụ trong mảng tasks được trả về kèm lỗi

tasks.cost
Kiểu: number

chi phí của tác vụ, USD

tasks.data
Kiểu: object

chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST

tasks.id
Kiểu: string

mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID

tasks.path
Kiểu: array string[]

Đường dẫn URL

tasks.result
Kiểu: array string[]

mảng kết quả

tasks.result_count
Kiểu: integer

số phần tử trong mảng kết quả

tasks.result.items
Kiểu: array string[]

chứa dữ liệu mentions liên quan

tasks.result.items.brand_entities_category
Kiểu: array string[]

dữ liệu về các thực thể thương hiệu liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về danh mục thực thể thương hiệu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.items.brand_entities_category.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.brand_entities_category.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.brand_entities_category.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị danh mục thực thể thương hiệu được tìm thấy

tasks.result.items.brand_entities_category.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.items.brand_entities_category.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.brand_entities_title
Kiểu: array string[]

dữ liệu về các thực thể thương hiệu liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về tiêu đề thực thể thương hiệu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.items.brand_entities_title.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.brand_entities_title.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.brand_entities_title.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tiêu đề thực thể thương hiệu được tìm thấy

tasks.result.items.brand_entities_title.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.items.brand_entities_title.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.key
Kiểu: string

khóa tổng hợp nhận được trong mảng POST

tasks.result.items.language
Kiểu: array string[]

nhóm theo ngôn ngữ; mảng các đối tượng chứa chỉ số đề cập được phân đoạn theo ngôn ngữ nội dung

tasks.result.items.language.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.language.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.language.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.items.language.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.items.language.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.location
Kiểu: array string[]

nhóm theo vị trí; mảng các đối tượng chứa chỉ số đề cập được phân đoạn theo vị trí địa lý

tasks.result.items.location.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.location.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.location.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.items.location.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.items.location.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.platform
Kiểu: array string[]

nhóm theo nền tảng; mảng các phần tử nhóm chứa chỉ số đề cập được phân đoạn theo nền tảng AI

tasks.result.items.platform.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.platform.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.platform.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.items.platform.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.items.platform.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.search_results_domain
Kiểu: array string[]

các domain kết quả tìm kiếm hàng đầu được tìm thấy liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về các domain hàng đầu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.items.search_results_domain.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.search_results_domain.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.search_results_domain.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tên domain được tìm thấy

tasks.result.items.search_results_domain.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.items.search_results_domain.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.items.sources_domain
Kiểu: array string[]

các domain nguồn hàng đầu được tìm thấy liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về các domain hàng đầu được trích dẫn làm nguồn trong phản hồi LLM

tasks.result.items.sources_domain.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.items.sources_domain.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.items.sources_domain.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tên domain được tìm thấy

tasks.result.items.sources_domain.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.items.sources_domain.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total
Kiểu: object

tóm tắt chỉ số đề cập tổng hợp; chứa các chỉ số đề cập LLM tổng hợp tổng thể trên tất cả domain được tìm thấy, được nhóm theo nhiều chiều khác nhau

tasks.result.total.brand_entities_category
Kiểu: array string[]

dữ liệu về các thực thể thương hiệu liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về danh mục thực thể thương hiệu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.total.brand_entities_category.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.brand_entities_category.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.brand_entities_category.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị danh mục thực thể thương hiệu được tìm thấy

tasks.result.total.brand_entities_category.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.total.brand_entities_category.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.brand_entities_title
Kiểu: array string[]

dữ liệu về các thực thể thương hiệu liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về tiêu đề thực thể thương hiệu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.total.brand_entities_title.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.brand_entities_title.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.brand_entities_title.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tiêu đề thực thể thương hiệu được tìm thấy

tasks.result.total.brand_entities_title.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.total.brand_entities_title.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.language
Kiểu: array string[]

nhóm theo ngôn ngữ; mảng các đối tượng chứa chỉ số đề cập được phân đoạn theo ngôn ngữ nội dung

tasks.result.total.language.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.language.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.language.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.total.language.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.total.language.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.location
Kiểu: array string[]

nhóm theo vị trí; mảng các đối tượng chứa chỉ số đề cập được phân đoạn theo vị trí địa lý

tasks.result.total.location.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.location.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.location.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.total.location.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.total.location.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.platform
Kiểu: array string[]

nhóm theo nền tảng; mảng các phần tử nhóm chứa chỉ số đề cập được phân đoạn theo nền tảng AI

tasks.result.total.platform.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.platform.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.platform.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm

tasks.result.total.platform.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến khóa nhóm cụ thể này

tasks.result.total.platform.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.search_results_domain
Kiểu: array string[]

các domain kết quả tìm kiếm hàng đầu được tìm thấy liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về các domain hàng đầu xuất hiện trong kết quả tìm kiếm liên quan đến truy vấn LLM

tasks.result.total.search_results_domain.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.search_results_domain.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.search_results_domain.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tên domain được tìm thấy

tasks.result.total.search_results_domain.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.total.search_results_domain.type
Kiểu: string

loại phần tử = 'group_element'

tasks.result.total.sources_domain
Kiểu: array string[]

các domain nguồn hàng đầu được tìm thấy liên quan đến mục tiêu; mảng các đối tượng chứa dữ liệu về các domain hàng đầu được trích dẫn làm nguồn trong phản hồi LLM

tasks.result.total.sources_domain.ai_search_volume
Kiểu: integer

tốc độ khối lượng tìm kiếm AI hiện tại của một từ khóa; tìm hiểu thêm về chỉ số này tại đây

tasks.result.total.sources_domain.impressions
Kiểu: integer

tốc độ hiển thị AI hiện tại của một từ khóa

tasks.result.total.sources_domain.key
Kiểu: string

mã định danh nhóm; mã định danh cụ thể cho chiều nhóm; trong trường hợp này, trường hiển thị tên domain được tìm thấy

tasks.result.total.sources_domain.mentions
Kiểu: integer

tổng số đề cập LLM; số lần từ khóa hoặc domain mục tiêu được đề cập liên quan đến domain cụ thể

tasks.result.total.sources_domain.type
Kiểu: string

loại phần tử = 'group_element'

tasks.status_code
Kiểu: integer

mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

tasks.status_message
Kiểu: string

thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

tasks.time
Kiểu: string

thời gian thực thi, giây

time
Kiểu: string

thời gian thực thi, giây

version
Kiểu: string

phiên bản hiện tại của API
application/json
400

Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
401

Cần có khóa API Felo hợp lệ.
402

Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
403

Tài khoản không được phép thực hiện thao tác này.
429

Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
502

Dịch vụ không thể hoàn tất yêu cầu.
503

API hoặc dịch vụ thanh toán tạm thời không khả dụng.
504

Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
default

Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      {
        "aggregation_key": "",
        "target": [
          {}
        ]
      }
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "initial_dataset_filters": [],
    "internal_list_limit": 1,
    "tag": ""
  }
]'

Hiện schema

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.key": "string",
  "tasks.result.items.location": [
    "string"
  ],
  "tasks.result.items.location.type": "string",
  "tasks.result.items.location.key": "string",
  "tasks.result.items.location.mentions": 1,
  "tasks.result.items.location.ai_search_volume": 1,
  "tasks.result.items.location.impressions": 1,
  "tasks.result.items.language": [
    "string"
  ],
  "tasks.result.items.language.type": "string",
  "tasks.result.items.language.key": "string",
  "tasks.result.items.language.mentions": 1,
  "tasks.result.items.language.ai_search_volume": 1,
  "tasks.result.items.language.impressions": 1,
  "tasks.result.items.platform": [
    "string"
  ],
  "tasks.result.items.platform.type": "string",
  "tasks.result.items.platform.key": "string",
  "tasks.result.items.platform.mentions": 1,
  "tasks.result.items.platform.ai_search_volume": 1,
  "tasks.result.items.platform.impressions": 1,
  "tasks.result.items.sources_domain": [
    "string"
  ],
  "tasks.result.items.sources_domain.type": "string",
  "tasks.result.items.sources_domain.key": "string",
  "tasks.result.items.sources_domain.mentions": 1,
  "tasks.result.items.sources_domain.ai_search_volume": 1,
  "tasks.result.items.sources_domain.impressions": 1,
  "tasks.result.items.search_results_domain": [
    "string"
  ],
  "tasks.result.items.search_results_domain.type": "string",
  "tasks.result.items.search_results_domain.key": "string",
  "tasks.result.items.search_results_domain.mentions": 1,
  "tasks.result.items.search_results_domain.ai_search_volume": 1,
  "tasks.result.items.search_results_domain.impressions": 1,
  "tasks.result.items.brand_entities_title": [
    "string"
  ],
  "tasks.result.items.brand_entities_title.type": "string",
  "tasks.result.items.brand_entities_title.key": "string",
  "tasks.result.items.brand_entities_title.mentions": 1,
  "tasks.result.items.brand_entities_title.ai_search_volume": 1,
  "tasks.result.items.brand_entities_title.impressions": 1,
  "tasks.result.items.brand_entities_category": [
    "string"
  ],
  "tasks.result.items.brand_entities_category.type": "string",
  "tasks.result.items.brand_entities_category.key": "string",
  "tasks.result.items.brand_entities_category.mentions": 1,
  "tasks.result.items.brand_entities_category.ai_search_volume": 1,
  "tasks.result.items.brand_entities_category.impressions": 1
}

Phản hồi thành công

LLM Mentions Cross Aggregated Metrics trực tiếp

Xác thựcRequired

DataForSEO

LLM Mentions Cross Aggregated Metrics trực tiếp

Tham chiếu giá