Felo API PlatformFelo API Platform
Tất cả endpoint của DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

LLM Mentions 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

LLM Mentions trực tiếp

​

Các câu trả lời riêng lẻ mà trợ lý đã nhắc đến mục tiêu của bạn. Trả về total_count, current_offset, search_after_token và items - với các trang sau trang đầu, hãy phân trang bằng token chứ không phải offset. ⚠️ 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. Nếu chỉ cần số lượng thay vì chính các lượt nhắc, hãy dùng post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

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,701 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[]
    • 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; bạn có thể chỉ định tối đa 10 thực thể (đối tượng) trong trường target; một thực thể mục tiêu có thể chứa một domain hoặc một keyword và các tham số liên quan; ví dụ: mảng target với thực thể domain [{"domain": "en.wikipedia.org", "search_filter": "exclude"}]; mảng target với thực thể keyword [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}]; mảng target với nhiều thực thể [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          Kiểu: string
          bắt buộc

          domain mục tiêu; trường bắt buộc nếu bạn không chỉ định keyword; bạn có thể chỉ định tối đa 63 ký tự trong trường domain; domain phải được chỉ định không kèm 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

          keyword mục tiêu; trường bắt buộc nếu bạn không chỉ định domain; 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ự dấu cách); nếu bạn cần dùng ký tự “%” cho keyword, hãy chỉ định nó là “%25”; nếu bạn cần dùng ký tự “+” cho keyword, hãy chỉ định nó là “%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.

    • filters
      Kiểu: array

      mảng tham số lọc kết quả trường tùy chọn 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, 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 mọi chuỗi có 0 hoặc nhiều ký tự ví dụ: ["ai_search_volume",">","1000"] Danh sách đầy đủ các bộ lọc khả dụng có tại đây.

    • 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

    • limit
      Kiểu: integer

      số đối tượng trả về tối đa trường tùy chọn giá trị mặc định: 100 giá trị tối đa: 1000

    • 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

    • offset
      Kiểu: integer

      độ lệch trong mảng kết quả của dữ liệu mentions trả về trường tùy chọn giá trị mặc định: 0 ví dụ: nếu bạn chỉ định giá trị 10, mười đối tượng mentions đầu tiên trong mảng kết quả sẽ bị bỏ qua và dữ liệu sẽ được cung cấp cho các đối tượng tiếp theo; Lưu ý: giá trị tối đa là 9.000, hãy dùng search_after_token nếu bạn muốn lấy thêm kết quả

    • order_by
      Kiểu: array string[]

      quy tắc sắp xếp kết quả trường tùy chọn bạn có thể dùng các giá trị giống như trong mảng filters để sắp xếp kết quả các kiểu sắp xếp khả dụng: asc - kết quả được sắp xếp theo thứ tự tăng dần desc - kết quả được sắp xếp theo thứ tự giảm dần bạn nên dùng dấu phẩy để thiết lập kiểu sắp xếp ví dụ: ["ai_search_volume,desc"] lưu ý bạn không thể đặt quá ba quy tắc sắp xếp trong một yêu cầu bạn nên dùng dấu phẩy để phân tách nhiều quy tắc sắp xếp

    • 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

    • search_after_token
      Kiểu: string

      token cho các yêu cầu tiếp theo trường tùy chọn được cung cấp trong trường tương ứng của phản hồi cho mỗi yêu cầu; dùng tham số này để tránh hết thời gian chờ khi cố lấy hơn 20.000 kết quả trong một yêu cầu; bằng cách chỉ định giá trị search_after_token duy nhất từ mảng phản hồi, bạn sẽ nhận được các kết quả tiếp theo của tác vụ ban đầu; giá trị search_after_token là duy nhất cho mỗi tác vụ tiếp theo ; Lưu ý: nếu search_after_token được chỉ định trong yêu cầu, mọi tham số khác phải giống với yêu cầu trước

    • 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.current_offset
      Kiểu: integer

      số đối tượng mentions bị bỏ qua trong mảng items

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

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

    • tasks.result.items_count
      Kiểu: integer

      số kết quả được trả về trong mảng items

    • tasks.result.items.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.answer
      Kiểu: string

      câu trả lời liên quan ở định dạng markdown nội dung của kết quả được định dạng bằng ngôn ngữ đánh dấu markdown

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

      mảng thực thể thương hiệu chứa thông tin về các thương hiệu được nhắc đến trong phản hồi

    • tasks.result.items.brand_entities.category
      Kiểu: string

      danh mục của thương hiệu

    • tasks.result.items.brand_entities.position
      Kiểu: integer

      vị trí trong kết quả

    • tasks.result.items.brand_entities.title
      Kiểu: string

      tên của thương hiệu

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

      mảng truy vấn fan-out chứa các truy vấn tìm kiếm liên quan được dẫn xuất từ truy vấn chính nhằm cung cấp câu trả lời toàn diện hơn

    • tasks.result.items.first_response_at
      Kiểu: string

      ngày và giờ dữ liệu phản hồi được ghi nhận lần đầu ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      Kiểu: string

      mã ngôn ngữ trong mảng POST

    • tasks.result.items.last_response_at
      Kiểu: string

      ngày và giờ dữ liệu phản hồi được cập nhật lần cuối ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      Kiểu: integer

      mã vị trí trong mảng POST

    • tasks.result.items.model_name
      Kiểu: string

      tên mô hình AI mà dữ liệu được truy xuất từ đó Lưu ý: với loại nền tảng google, giá trị luôn là google_ai_overview

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

      tỷ lệ khối lượng tìm kiếm AI hàng tháng mảng đối tượng chứa tỷ lệ khối lượng tìm kiếm AI trong một tháng nhất định của năm

    • tasks.result.items.monthly_searches.month
      Kiểu: integer

      tháng

    • tasks.result.items.monthly_searches.search_volume
      Kiểu: integer

      tỷ lệ khối lượng tìm kiếm AI trong một tháng nhất định của năm tìm hiểu thêm về chỉ số này tại đây

    • tasks.result.items.monthly_searches.year
      Kiểu: integer

      năm

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

      nền tảng nhận được trong mảng POST

    • tasks.result.items.question
      Kiểu: string

      câu hỏi liên quan

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

      mảng kết quả tìm kiếm toàn bộ đầu ra tìm kiếm web mà mô hình truy xuất khi tra cứu thông tin, bao gồm cả bản trùng lặp và mục không được sử dụng

    • tasks.result.items.search_results.breadcrumb
      Kiểu: string

      đường dẫn breadcrumb

    • tasks.result.items.search_results.description
      Kiểu: string

      mô tả kết quả

    • tasks.result.items.search_results.domain
      Kiểu: string

      tên miền của kết quả

    • tasks.result.items.search_results.position
      Kiểu: integer

      vị trí trong kết quả

    • tasks.result.items.search_results.publication_date
      Kiểu: string

      ngày và giờ kết quả được xuất bản ở định dạng: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” ví dụ: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.search_results.title
      Kiểu: string

      tiêu đề kết quả

    • tasks.result.items.search_results.url
      Kiểu: string

      URL của kết quả

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

      mảng nguồn các nguồn mà mô hình đã trích dẫn hoặc dựa vào trong câu trả lời cuối cùng

    • tasks.result.items.sources.domain
      Kiểu: string

      tên miền nguồn

    • tasks.result.items.sources.markdown
      Kiểu: string

      nội dung của phần tử ở định dạng markdown nội dung của kết quả được định dạng bằng ngôn ngữ đánh dấu markdown

    • tasks.result.items.sources.position
      Kiểu: integer

      vị trí trong kết quả

    • tasks.result.items.sources.publication_date
      Kiểu: string

      ngày và giờ kết quả được xuất bản ở định dạng: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” ví dụ: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.sources.snippet
      Kiểu: string

      mô tả nguồn

    • tasks.result.items.sources.source_name
      Kiểu: string

      tên nguồn

    • tasks.result.items.sources.thumbnail
      Kiểu: string

      hình thu nhỏ của nguồn

    • tasks.result.items.sources.title
      Kiểu: string

      tiêu đề nguồn

    • tasks.result.items.sources.url
      Kiểu: string

      URL nguồn

    • tasks.result.search_after_token
      Kiểu: string

      token cho các yêu cầu tiếp theo bằng cách chỉ định search_after_token duy nhất khi thiết lập tác vụ mới, bạn sẽ nhận được các kết quả tiếp theo của tác vụ ban đầu; giá trị search_after_token là duy nhất cho mỗi tác vụ tiếp theo

    • tasks.result.total_count
      Kiểu: integer

      tổng số kết quả liên quan đến yêu cầu

    • 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
Request Example for post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

{
  "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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

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

Live LLM Mentions