> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 广告搜索自动补全

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">4 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## 复制给 AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 为什么还要自己写代码？</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">让 AI 来处理重复工作。点击按钮即可复制一段整理好的提示词，用于 ChatGPT、Claude 或你常用的 AI 助手。</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`我需要调用下面的 KeyAPI 接口，请根据提供的接口信息生成一份完整、可直接运行的 Python 示例代码。

## 接口信息

Endpoint: GET https://api.keyapi.ai/v1/facebook/ads_autocomplete
摘要: 广告搜索自动补全

必需请求头:
- Authorization: Bearer <YOUR_API_KEY>

参数:
- query (必填): 搜索关键词. 示例: pizza
- country (必填): 国家或地区代码. 示例: US

## 代码要求

- 使用 Python \`requests\` 库
- 提供完整、可直接运行的示例
- 处理 HTTP 请求异常、超时以及非 2xx 响应
- 处理 JSON 解析异常
- 示例参数优先使用接口信息中提供的 Example
- 保持代码简单，避免不必要的封装和复杂设计`)}
    >
      <span>✨</span>
      <span>复制给 AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml /zh/facebook.zh.openapi.json get /v1/facebook/ads_autocomplete
openapi: 3.0.1
info:
  title: KeyAPI Facebook API 中文文档
  description: KeyAPI Facebook API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production-KeyAPI
security:
  - JWT Bearer: []
tags:
  - name: 公共主页
  - name: 个人主页
  - name: 群组
  - name: 帖子与评论
  - name: 广告库
  - name: 活动
  - name: 搜索
  - name: Marketplace
  - name: 游戏
paths:
  /v1/facebook/ads_autocomplete:
    get:
      tags:
        - 广告库
      summary: 广告搜索自动补全
      parameters:
        - name: query
          in: query
          description: 搜索关键词。
          required: true
          example: pizza
          schema:
            type: string
            example: pizza
        - name: country
          in: query
          description: 国家或地区代码。
          required: true
          example: US
          schema:
            type: string
            example: US
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  suggestions:
                    keyword_results:
                      - pizza dough for sale
                    page_results:
                      - page_id: '6657899956'
                        category: Restaurant
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/558468856_1263223535847483_7170231349500304194_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=BNHT1R-UtA0Q7kNvwFKm2OB&_nc_oc=AdqNw-lGIuqAYg4seXdAFtJgSG7LZNRWz9Kn8aYmHzODV2DekQQjITS-FsrF2lP5ijc&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQLQhm0-JXSV6MGalUU9doZ2kSvb3ulO-2nL9h8MLam4JA&oe=6AB81E58
                        likes: 22426882
                        verification: BLUE_VERIFIED
                        name: Domino's Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: dominos
                        ig_followers: 1930326
                        ig_verification: true
                        page_alias: Dominos
                        page_is_deleted: false
                      - page_id: '6053772414'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/793351709_1538614524965082_3987110670464606872_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=nVt6nj71mrcQ7kNvwGn0Xt3&_nc_oc=AdqxF0b1D-hsy4nsnigFxLbNbYy0whyQjAAAgte5DI1Y8TqGjtA1McE7nh82pARMAJ0&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQLLcfHQL4yx80q-34e_L8QkGHyqM0pu_VZ6r7BX1L1YwQ&oe=6AB80283
                        likes: 32596438
                        verification: BLUE_VERIFIED
                        name: Pizza Hut
                        country: US
                        entity_type: PERSON_PROFILE
                        ig_username: pizzahut
                        ig_followers: 1786636
                        ig_verification: true
                        page_alias: pizzahutus
                        page_is_deleted: false
                      - page_id: '209562942744'
                        category: Food and drinks company
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/386506892_704496975058440_2988027283655147303_n.png?stp=dst-png_s200x200&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=oSKPxs5788UQ7kNvwGoAoxF&_nc_oc=Adq5QgnrAGJjgeoRk1QCZj9C-cPnCnJpRBCoBjxU1EeIK7hk0jgRKriGkpj7dcmY7Uo&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQLkd0w9vcD-7Ipep9tZU9-9LUsDrxgQAQYhyn_-ZYQ33g&oe=6AB7F6DD
                        likes: 6449768
                        verification: BLUE_VERIFIED
                        name: Domino's Pizza India
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: dominos_india
                        ig_followers: 946879
                        ig_verification: true
                        page_alias: dominospizzaindia
                        page_is_deleted: false
                      - page_id: '112608265447380'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/554931681_1238035431696184_6162264506994979365_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=l-LSiaPXsWMQ7kNvwFK43Hj&_nc_oc=AdrTJCRTxtjYNmbecJv6SOBirb1vhcR-RzPalF5AIDXyN6TJL1ADziHA5rFkzgVmyJI&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQJidrjLQr1jHBK05tEblbFQxKWC7GHToHbQdHrwtd3AoQ&oe=6AB8054F
                        likes: 32596438
                        verification: BLUE_VERIFIED
                        name: Pizza Hut
                        country: IN
                        entity_type: PERSON_PROFILE
                        ig_username: null
                        ig_followers: null
                        ig_verification: null
                        page_alias: pizzahutindia
                        page_is_deleted: false
                      - page_id: '7344293495'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/277753188_10161671470778496_7767859162073384242_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=418b77&_nc_ohc=E7eeVldusK0Q7kNvwGB5M7z&_nc_oc=AdrO71_qqacwAoTGsoytlq8mM134uJOgOF3NqULdCbh-XbeJ0ttnk3dI6zm_hNGAwp0&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQLmw8ryY93z6hR5g01-68Ncbcy5vhKFuQ6i2ktcLH7l5w&oe=6AB81E92
                        likes: 45741
                        verification: BLUE_VERIFIED
                        name: Panago Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: panago_pizza
                        ig_followers: 30389
                        ig_verification: true
                        page_alias: panago
                        page_is_deleted: false
                      - page_id: '207571100452'
                        category: Restaurant
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/486388058_1002929492039152_331693617156547154_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=TJJHP1fV1vIQ7kNvwHqJP0G&_nc_oc=AdpslzkVcEv2CcNpya1j-iiHXV3r5cj79jZnPSdkKKfJwsDTs28fkkcKB8waZWew9uE&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQJvWwB96rJ-PowNJJbhhcXNo2DKe-WmvaFmdkslYa8GiQ&oe=6AB7FF68
                        likes: 22426882
                        verification: BLUE_VERIFIED
                        name: Domino's Pizza
                        country: GB
                        entity_type: PERSON_PROFILE
                        ig_username: dominos_uk
                        ig_followers: 283584
                        ig_verification: true
                        page_alias: DominosPizza
                        page_is_deleted: false
                      - page_id: '284314854066'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/274734737_10158963192004067_6679386350253704045_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=vA4GrtRfEcUQ7kNvwGP1yst&_nc_oc=AdqunhcVmgJr8OLyZJjijEVaarQ0YnssjnHLX6wshmVifRminXcOXS_sxf-Iwkbrlyg&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQIrLLSmF2XNNs_OV6GSLnSzqQVymDoHMq1eSv1ccsS9RA&oe=6AB7FF0D
                        likes: 1030217
                        verification: BLUE_VERIFIED
                        name: Papa Murphy's Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: papamurphys
                        ig_followers: 49899
                        ig_verification: true
                        page_alias: papamurphyspizza
                        page_is_deleted: false
                      - page_id: '178586090176'
                        category: Company
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/775995810_1536821288488260_188456380929748687_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=110&ccb=1-7&_nc_sid=418b77&_nc_ohc=h_NVdhPuscYQ7kNvwHMlhi2&_nc_oc=Adpmv8pRx124CO1U5-kJU7n2KUnKQxwadEiefRD0GFU3PbXg8Z4tyn2to_J9tPdozPY&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQJfZ33z5B4tf7Cf0ZwAc29VkBfa7_inyzGC6UJ0na29Kw&oe=6AB81EE5
                        likes: 289541
                        verification: BLUE_VERIFIED
                        name: Jet's Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: jetspizza
                        ig_followers: 90131
                        ig_verification: true
                        page_alias: JetsPizza
                        page_is_deleted: false
                      - page_id: '73140987277'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/518331047_1185045000332624_1466922643311221555_n.jpg?stp=dst-jpg_p200x200_tt6&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=11QReSF-hrsQ7kNvwGG0ipe&_nc_oc=AdrZ24ESdAUoNBRl_QzvM8zKikl8dkHYJ9KoRFWUw804FpdAoUQ4hHL1PCNrzAJnhTM&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQIdaaTOepBaTFHu8EVl06zbb7bydRzfNFIOn_q2-Z5zMg&oe=6AB82637
                        likes: 32596438
                        verification: BLUE_VERIFIED
                        name: Pizza Hut
                        country: GB
                        entity_type: PERSON_PROFILE
                        ig_username: pizzahutuk
                        ig_followers: 49063
                        ig_verification: true
                        page_alias: pizzahutuk
                        page_is_deleted: false
                      - page_id: '63322161215'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/645222052_1328131666009454_1983233496800396692_n.jpg?_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=UsFV9IZGiXAQ7kNvwG6NvCA&_nc_oc=AdrTul5ORVI_TJ4qN1pC5lBBkE4vBZwmOHreH3QOr8-cDv78bvOHN_dkG5bQ_bAgbFE&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQKJWKpbUFTl3HnkEVx2gu57OAKyYSxbX8JLA8SPvGRhWw&oe=6AB82573
                        likes: 1076368
                        verification: BLUE_VERIFIED
                        name: Cicis Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: cicisofficial
                        ig_followers: 75437
                        ig_verification: true
                        page_alias: CicisOfficial
                        page_is_deleted: false
                      - page_id: '76178448215'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/559070411_1247709940729431_3964929637271057526_n.jpg?stp=dst-jpg_p200x200_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=YOGzCWS0ad0Q7kNvwGSGAOT&_nc_oc=AdrJZB5qRlIw871p0fD5BaGRcRFEVjXrgeRbI0zxphL2NkBvf5CJ3x0ENPtUoharISI&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQJkn25foOBmPX-O69s3ecPLg0cx_AH1IlpLuYGtIxHpEw&oe=6AB7F4B1
                        likes: 319730
                        verification: NOT_VERIFIED
                        name: Marco's Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: marcospizza
                        ig_followers: 49199
                        ig_verification: true
                        page_alias: MarcosPizza
                        page_is_deleted: false
                      - page_id: '185915854791444'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/793901232_1516569033843672_1343453684932891754_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=108&ccb=1-7&_nc_sid=418b77&_nc_ohc=ZRFkXAThuMsQ7kNvwEDgIEV&_nc_oc=AdpSnrxCizt4-qv727F5pgxOo6PqcOjQu6NCLQgtCwYt3BA9WHjtx0xDstv2kGQTokc&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQKA5aF8yvMc-JFykLR4Cei-hBz0Cl5hDDovIAfHI-3ysg&oe=6AB81486
                        likes: 32596438
                        verification: BLUE_VERIFIED
                        name: Pizza Hut
                        country: CY
                        entity_type: PERSON_PROFILE
                        ig_username: pizzahutcyprus
                        ig_followers: 10945
                        ig_verification: true
                        page_alias: pizzahut.cy
                        page_is_deleted: false
                      - page_id: '36030051733'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/274351975_10158158403961734_9042799783606175125_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=3yFCZJSf8CIQ7kNvwH-jNWi&_nc_oc=AdpeVyVU4LNgWi_85Qp59Zd7W0ecqb_7zaDjiOrNOEoG8TTT3U50C7yMmibTlHKvg54&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQKKQ_te0Iio048oxkco_hUMRslwjAk2SVsAb88ixzhwVA&oe=6AB82653
                        likes: 6851136
                        verification: BLUE_VERIFIED
                        name: Papa John's Pizza
                        country: GB
                        entity_type: PERSON_PROFILE
                        ig_username: papajohnsuk
                        ig_followers: 66533
                        ig_verification: true
                        page_alias: papajohnsuk
                        page_is_deleted: false
                      - page_id: '1147417808621119'
                        category: Pizza place
                        image_uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/340633423_178707618376896_4747172808906013761_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=102&ccb=1-7&_nc_sid=418b77&_nc_ohc=GHCFnB_S5HkQ7kNvwHHDzo-&_nc_oc=AdqjJs7rC9HND4kIV6g2pBQbo98NNdz9B92EIsivDebt4NjgLu4vnbFR3ncg538Egl8&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQLgOBD7TEKclHwtZscAJD9-JpAKEqZoQrpadVUYTlwjIQ&oe=6AB824B3
                        likes: 23141
                        verification: BLUE_VERIFIED
                        name: Fireaway Pizza
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: fireawaypizza
                        ig_followers: 93057
                        ig_verification: true
                        page_alias: fireawaypizza
                        page_is_deleted: false
                      - page_id: '76708263289'
                        category: Food and drinks company
                        image_uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/384774483_634763032049773_8205159923466202411_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=106&ccb=1-7&_nc_sid=418b77&_nc_ohc=ZiLFociwKn8Q7kNvwE9IF50&_nc_oc=AdrfxiPsvQH5UaENeMNmzkUZW61w40VqzLGrnUoaXzl9SpvwaVrhdP6PI-HeRfNOess&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=2y1uUngmLbtOgDf4LtlB9w&_nc_ss=7d289&oh=00_AQIOLucL1qE4XTYLAZS8zEug_dXkvhoab8_69J_gHhtLwA&oe=6AB82522
                        likes: 407100
                        verification: BLUE_VERIFIED
                        name: Domino's Pizza France
                        country: null
                        entity_type: PERSON_PROFILE
                        ig_username: dominospizza_france
                        ig_followers: 53172
                        ig_verification: true
                        page_alias: dominospizzafrance
                        page_is_deleted: false
                    location_results: []
                    exact_phrase_results: '"pizza"'
                requestId: 5f92ec23-7b7d-40d6-aa89-7cd98263a803
          headers: {}
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '402':
          $ref: '#/components/responses/402'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/facebook/profile_details_url?url=https%3A%2F%2Fwww.facebook.com%2Fmantraindianfolsom' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
components:
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            example:
              code: 400
              data: null
              message: 'Missing required parameter: handle'
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            example:
              code: 401
              data: null
              message: apiKey is null
    '402':
      description: Payment Required
      content:
        application/json:
          schema:
            type: object
            example:
              code: 402
              data: null
              message: apiKey quota is not enough
    '429':
      description: Too Many Requests
      content:
        application/json:
          schema:
            type: object
            example:
              code: 429
              data: null
              message: qps limit exceeded
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            example:
              code: 500
              data: null
              message: Internal server error
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````