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

ChatGPT LLM Scraper trực tiếp

Máy chủ:https://openapi.felo.ai
Thư viện client

DataForSEO

​

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

ChatGPT LLM Scraper trực tiếp

​

Hỏi ChatGPT một keyword như người dùng và trả về câu trả lời đã phân tích. Trả về keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries và brand_entities - markdown là câu trả lời như trợ lý đã hiển thị, sources là các trang được trích dẫn, và brand_entities là các thương hiệu được nêu tên. force_web_search khiến mô hình duyệt web thay vì trả lời từ dữ liệu huấn luyện. Được bọc trong phong bì của DataForSEO: dữ liệu ở tasks[0].result, kết quả ở tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Đây là endpoint cho câu hỏi 'ChatGPT nói gì về chúng ta'; để đếm lượt nhắc đến trên nhiều câu trả lời, dùng post_dataforseo_ai_llm_mentions_aggregated_metrics_live thay vì thu thập lặp lại. Dạng thô là post_dataforseo_ai_chat_gpt_llm_scraper_live_html.

Tham chiếu giá

  • Đo lường: Chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.004.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại 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
application/json
  • Kiểu: array (object | null)[]
    • force_web_search
      Kiểu: boolean | null

      buộc tác nhân AI dùng tìm kiếm web
      trường tùy chọn
      khi bật, mô hình AI bị buộc truy cập và trích dẫn thông tin web hiện tại;
      giá trị mặc định: false;
      Lưu ý: ngay cả khi tham số được đặt thành true, không có gì bảo đảm các nguồn web sẽ được trích dẫn trong phản hồi

    • keyword
      Kiểu: string

      từ khóa
      trường bắt buộc
      bạn có thể chỉ định tối đa 2000 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

    • language_code
      Kiểu: string

      mã ngôn ngữ của công cụ tìm kiếm
      trường bắt buộc nếu bạn không chỉ định language_name;
      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/chat_gpt/llm_scraper/languages

    • language_name
      Kiểu: string

      tên đầy đủ của ngôn ngữ công cụ tìm kiếm
      trường bắt buộc nếu bạn không chỉ định language_code;
      nếu bạn dùng trường này, bạn không cần chỉ định language_code;
      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/chat_gpt/llm_scraper/languages

    • location_code
      Kiểu: integer

      mã vị trí của công cụ tìm kiếm
      trường bắt buộc nếu bạn không chỉ định location_name
      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/chat_gpt/llm_scraper/locations
      ví dụ:
      2840

    • location_name
      Kiểu: string

      tên đầy đủ của vị trí công cụ tìm kiếm
      trường bắt buộc nếu bạn không chỉ định location_code
      nếu bạn dùng trường này, bạn không cần chỉ định location_code
      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/chat_gpt/llm_scraper/locations
      ví dụ:
      United States

    • tag
      Kiểu: string | null

      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 | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo
    • cost
      Kiểu: number | null Định dạng: double

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

    • status_code
      Kiểu: integer | null

      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

    • status_message
      Kiểu: string | null

      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 (object | null)[] | null

      mảng tác vụ

      • Kiểu: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
        • cost
          Kiểu: number | null Định dạng: double

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

        • data
          Kiểu: object | null

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

          • propertyName
            Kiểu: object | null
        • id
          Kiểu: string | null

          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

        • path
          Kiểu: array (string | null)[] | null

          Đường dẫn URL

        • result
          Kiểu: array (object | null)[] | null

          mảng kết quả

          • brand_entities
            Kiểu: array (object | null)[] | null

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

            • category
              Kiểu: string | null

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

            • markdown
              Kiểu: string | null

              tên thương hiệu ở định dạng markdown
              chứa tên thương hiệu được định dạng bằng ngôn ngữ đánh dấu markdown

            • title
              Kiểu: string | null

              tên thương hiệu

            • type
              Kiểu: string | null

              loại phần tử

            • urls
              Kiểu: object | null

              mảng URL và tên miền liên quan đến thương hiệu

          • check_url
            Kiểu: string | null

            URL trực tiếp đến kết quả công cụ tìm kiếm
            bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác

          • datetime
            Kiểu: string | null

            ngày và giờ nhận được kết quả
            theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            ví dụ:
            2019-11-15 12:57:46 +00:00

          • fan_out_queries
            Kiểu: array (string | null)[] | null

            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 để cung cấp phản hồi toàn diện hơn

          • item_types
            Kiểu: array (string | null)[] | null

            các loại kết quả tìm kiếm
            chứa các loại kết quả tìm kiếm (items) được tìm thấy trong SERP.
            các loại mục khả dụng:
            chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products

          • items
            Kiểu: array (object | null)[] | null

            các phần tử của kết quả ChatGPT

            • rank_absolute
              Kiểu: integer | null

              thứ hạng tuyệt đối trong SERP
              vị trí tuyệt đối trong tất cả phần tử

            • rank_group
              Kiểu: integer | null

              thứ hạng nhóm trong SERP
              vị trí trong một nhóm các phần tử có cùng giá trị type
              vị trí của các phần tử có giá trị type khác bị bỏ qua khỏi rank_group

            • type
              Kiểu: string | null

              loại phần tử

          • items_count
            Kiểu: integer | null Định dạng: int64

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

          • keyword
            Kiểu: string | null

            từ khóa nhận được trong mảng POST
            từ khóa được trả về với %## đã giải mã (ký hiệu cộng '+' sẽ được giải mã thành dấu cách)

          • language_code
            Kiểu: string | null

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

          • location_code
            Kiểu: integer | null

            mã vị trí trong mảng POST

          • markdown
            Kiểu: string | null

            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

          • model
            Kiểu: string | null

            cho biết phiên bản mô hình

          • se_results_count
            Kiểu: integer | null Định dạng: int64

            tổng số kết quả

          • search_results
            Kiểu: array (object | null)[] | null

            mảng kết quả tìm kiếm
            tất cả đầ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 dùng

            • breadcrumb
              Kiểu: string | null

              đường dẫn breadcrumb

            • description
              Kiểu: string | null

              mô tả kết quả

            • domain
              Kiểu: string | null

              tên miền kết quả

            • title
              Kiểu: string | null

              tiêu đề kết quả

            • type
              Kiểu: string | null

              loại phần tử

            • url
              Kiểu: string | null

              URL kết quả

          • sources
            Kiểu: array (object | null)[] | null

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

            • domain
              Kiểu: string | null

              tên miền nguồn trong SERP

            • markdown
              Kiểu: string | null

              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

            • publication_date
              Kiểu: string | null

              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

            • snippet
              Kiểu: string | null

              mô tả nguồn

            • source_name
              Kiểu: string | null

              tên nguồn

            • thumbnail
              Kiểu: string | null

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

            • title
              Kiểu: string | null

              tiêu đề nguồn

            • type
              Kiểu: string | null

              loại phần tử

            • url
              Kiểu: string | null

              URL nguồn

        • result_count
          Kiểu: integer | null Định dạng: int64

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

        • status_code
          Kiểu: integer | null

          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

        • status_message
          Kiểu: string | null

          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

        • time
          Kiểu: string | null

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

    • tasks_count
      Kiểu: integer | null Định dạng: int64

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

    • tasks_error
      Kiểu: integer | null Định dạng: int64

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

    • time
      Kiểu: string | null

      tổng thời gian thực thi, giây

    • version
      Kiểu: string | null

      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/chat_gpt/llm_scraper/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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,
          "check_url": null,
          "datetime": null,
          "markdown": null,
          "search_results": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "title": null,
              "description": null,
              "breadcrumb": null
            }
          ],
          "sources": [
            {
              "type": null,
              "title": null,
              "snippet": null,
              "domain": null,
              "url": null,
              "thumbnail": null,
              "source_name": null,
              "publication_date": null,
              "markdown": null
            }
          ],
          "fan_out_queries": [
            null
          ],
          "brand_entities": [
            {
              "type": null,
              "title": null,
              "category": null,
              "markdown": null,
              "urls": null
            }
          ],
          "se_results_count": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null
            }
          ]
        }
      ]
    }
  ]
}
Live ChatGPT LLM Scraper