> ## 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.

# Search people

<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">per request</span></span>
</div>

## Copy for 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">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</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(`I need to call the following KeyAPI endpoint. Please generate a complete and directly runnable Python example based on the API information provided below.

## API Information

Endpoint: GET https://api.keyapi.ai/v1/facebook/search_people
Summary: Search people

Required Headers:
- Authorization: Bearer <YOUR_API_KEY>

Parameters:
- query (Required): No description. Example: pizza
- cursor (Optional): No description.

## Code Requirements

- Use the Python \`requests\` library
- Provide a complete and directly runnable example
- Handle HTTP request errors, timeouts, and non-2xx responses
- Handle JSON parsing errors
- Prefer the Example values provided in the API information for sample parameters
- Keep the code simple and avoid unnecessary abstractions or complexity`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml /en/facebook.openapi.json get /v1/facebook/search_people
openapi: 3.0.1
info:
  title: Facebook API English documentation
  description: >-
    The english reference documentation of the Facebook API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production-KeyAPI
security:
  - JWT Bearer: []
tags:
  - name: Pages
  - name: Prefiles
  - name: Groups
  - name: Posts and comments
  - name: Evebts
  - name: Ads Library
  - name: Search
  - name: Marketplace
  - name: Games
paths:
  /v1/facebook/search_people:
    get:
      tags:
        - Search
      summary: Search people
      parameters:
        - name: query
          in: query
          description: ''
          required: true
          example: pizza
          schema:
            type: string
            example: pizza
        - name: cursor
          in: query
          description: ''
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  results:
                    - type: search_profile
                      profile_id: >-
                        pfbid0zJZM7gLMAze4WrdjGaZCfyAtsUUStSSDY53gghrf58xMMLh7YNK92dVPBNmetaewl
                      url: >-
                        https://www.facebook.com/people/Pizza-Bite-Glubahar/pfbid0zJZM7gLMAze4WrdjGaZCfyAtsUUStSSDY53gghrf58xMMLh7YNK92dVPBNmetaewl/
                      name: Pizza-Bite Glubahar
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc3-1.xx.fbcdn.net/v/t39.30808-1/685017572_122098233866355492_5742355866779105826_n.jpg?stp=dst-jpg_p120x120_tt6&_nc_cat=103&ccb=1-7&_nc_sid=e99d92&_nc_ohc=EqsDY3vEK3AQ7kNvwF4hSSH&_nc_oc=AdqOWrXG4IGmLUhRjwAM7Bn5JC7LEJcJS3P_hTtVKQQ-9SXkKjvJei-0CUQ8IpmanJY&_nc_zt=24&_nc_ht=scontent-sjc3-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQL5BaIZ27zT62swudT73txteKZa5ZCkyMAF4AR7l0YVpw&oe=6AB80FDA
                        width: 120
                        height: 121
                        scale: 2
                    - type: search_profile
                      profile_id: >-
                        pfbid02sRcWG7PUQTcB55osg2zckXLybYMUQfLS3pcfHcjFiehMteGfyheHgW5dEWomeiuKl
                      url: >-
                        https://www.facebook.com/people/Pi-Zza/pfbid02sRcWG7PUQTcB55osg2zckXLybYMUQfLS3pcfHcjFiehMteGfyheHgW5dEWomeiuKl/
                      name: Pi Zza
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc6-1.xx.fbcdn.net/v/t39.30808-1/790284026_122101876563456811_3919870053041254275_n.jpg?stp=dst-jpg_s120x120_tt6&_nc_cat=100&ccb=1-7&_nc_sid=e99d92&_nc_ohc=HdQ_qp_t9QAQ7kNvwFDhL66&_nc_oc=Adr5IxPeJgv8pPV8PxdWnesGLa-4jJ3DD_fzB_Mg_mKequ8EMYW4Fv6vq455uWgvZeY&_nc_zt=24&_nc_ht=scontent-sjc6-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQLw8kv0lMG3VW18iadkB_FOBiPzzzYgT6Twls6Kc6lpWw&oe=6AB8234F
                        width: 120
                        height: 120
                        scale: 2
                    - type: search_profile
                      profile_id: >-
                        pfbid02Lxhhs9XnKDaELRkxvC2um7az9DPPijLV8ufvs6TF33zMwTJDkyV1BrsT7NYuLh15l
                      url: >-
                        https://www.facebook.com/people/Pi-Zza/pfbid02Lxhhs9XnKDaELRkxvC2um7az9DPPijLV8ufvs6TF33zMwTJDkyV1BrsT7NYuLh15l/
                      name: Pi Zza
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc3-1.xx.fbcdn.net/v/t39.30808-1/762446716_122113901487363904_2355231886248766615_n.jpg?stp=dst-jpg_s120x120_tt6&_nc_cat=110&ccb=1-7&_nc_sid=e99d92&_nc_ohc=tpUL9Qw7FysQ7kNvwEj7-S2&_nc_oc=Adr1OUdi9gXYhYZ3dcqiDW2_gGewrxecd23V_OEVgoVyAU1iQC6L5ru-w3jbeQAzZS8&_nc_zt=24&_nc_ht=scontent-sjc3-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQJmn0-mV97XfkhdK1Ff5PN4_dBeohvS6PUi_338gGrDQA&oe=6AB82428
                        width: 120
                        height: 120
                        scale: 2
                    - type: search_profile
                      profile_id: >-
                        pfbid02vkogSdWnh67so66j94yAmwahrL5Hzaxm9Z8epdBbUguqEBNBHLNgmjtxhEPmxgWKl
                      url: https://www.facebook.com/Midapizzabd
                      name: Mida House
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc6-1.xx.fbcdn.net/v/t39.30808-1/815250395_122136427809220730_6117827838920217051_n.jpg?stp=dst-jpg_s120x120_tt6&_nc_cat=101&ccb=1-7&_nc_sid=e99d92&_nc_ohc=EdjGYR-3zyoQ7kNvwEmpIZa&_nc_oc=Adp57loAaNTm2PuakxL9Xi8QQimPwCWDf1VpgzD0kmVGZVAqAnUHK4WjkmKrawg-UYA&_nc_zt=24&_nc_ht=scontent-sjc6-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQIKxFvFnA1pPIcdd2V_dpXmdM7TphNuXesYzDYjfz_rUA&oe=6AB807F9
                        width: 120
                        height: 120
                        scale: 2
                    - type: search_profile
                      profile_id: '61555828377931'
                      url: https://www.facebook.com/lmhv.2024
                      name: MVMV
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc6-1.xx.fbcdn.net/v/t39.30808-1/658218695_122275509866194279_8639321646638687372_n.jpg?stp=dst-jpg_s120x120_tt6&_nc_cat=102&ccb=1-7&_nc_sid=111fe6&_nc_ohc=oTHSHkIHqSsQ7kNvwG5EiAr&_nc_oc=AdqBwv4kiswiBzo65QfM67k1DZkZsWOEDSj2wFkiuoJcP5PJtCrfiaRLvIha5R5653E&_nc_zt=24&_nc_ht=scontent-sjc6-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQJpvwn9slLGe8nbsXkcoFXDQt_skDe9vjPriXoIf_CT1Q&oe=6AB81A75
                        width: 120
                        height: 120
                        scale: 2
                    - type: search_profile
                      profile_id: '61569838665934'
                      url: https://www.facebook.com/ngo.gia.hieu.571424
                      name: pizza
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc3-1.xx.fbcdn.net/v/t39.30808-1/486732500_122132090708661288_4311154042797628494_n.jpg?stp=dst-jpg_p120x120_tt6&_nc_cat=111&ccb=1-7&_nc_sid=111fe6&_nc_ohc=OH2RvzKaIs4Q7kNvwGwdZ2L&_nc_oc=AdqAUetoozvbef6Cy_sECB1cu06zuz6EFn8BPmsuFfUKV2yP_Y31JDL78ulp5DAhVZg&_nc_zt=24&_nc_ht=scontent-sjc3-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQJqyTN-rqSoEykY-0y6hFaGvk10QMhlELaLmX054b-igQ&oe=6AB82776
                        width: 122
                        height: 120
                        scale: 2
                    - type: search_profile
                      profile_id: >-
                        pfbid0ViCjEAgdt5JRvRUQMedwxjeZQ3XCgzeQVdv6ZLtLV4rRie5Jmu7AnUmjSJzwNsYRl
                      url: >-
                        https://www.facebook.com/people/Maher-Hassan-Maher-Hassan/pfbid0ViCjEAgdt5JRvRUQMedwxjeZQ3XCgzeQVdv6ZLtLV4rRie5Jmu7AnUmjSJzwNsYRl/
                      name: Maher Hassan Maher Hassan
                      is_verified: false
                      profile_picture:
                        uri: >-
                          https://scontent-sjc6-1.xx.fbcdn.net/v/t39.30808-1/786158139_122099246529458166_6215106665509206191_n.jpg?stp=dst-jpg_p120x120_tt6&_nc_cat=101&ccb=1-7&_nc_sid=e99d92&_nc_ohc=PUZ-6MdCs1MQ7kNvwH1fujC&_nc_oc=AdqRUT6cDSD5RdaDI6pMgEjsS-QcO_PXHzY0ZBgIlkGz0fGvc_ELXNLZfwfLZsW3ubo&_nc_zt=24&_nc_ht=scontent-sjc6-1.xx&_nc_gid=1u4_rrL8LZ8NIimqngRRFg&_nc_ss=73289&oh=00_AQJS9q2jnC6fOLFNJnQi4WOm_Tc2Fp1DFGnc8VZgSjyrXA&oe=6AB82CCB
                        width: 120
                        height: 121
                        scale: 2
                  cursor: >-
                    {"page_number": 0, "flow_cursors_serialized":
                    {"INTERNAL_DEBUG_MODULE": "{}", "SEARCH_CONTROLS_INTERCEPT":
                    "{}", "INTEGRITY":
                    "{\"has_more_results\":false,\"processed_unicorn_ids\":[],\"is_end_of_serp\":false}",
                    "SPELLER": "{}", "SOCIAL_RAG": "{}",
                    "XE_LINK_GROWTH_UPSELL_PEOPLE_TAB": "{}",
                    "PEOPLE_TAB_UNICORN_CACHE": "{}", "PEOPLE_TAB":
                    "{\"has_more_results\": true, \"browse_cursor_serialized\":
                    \"Abp2SMj8NMm95B6JAQAApXUAZ-6Osg5TMP3JH5LHZl-3Hr1OtszU6pzPAJ74kDJC5Z_osdYp5FEkFsYZFKljWiiMRoWlcLCS1jIaM3Ud32XCRlkSfrv1jJfKhWCQaZgivsdDDTEQEeIeXBfgI7cSu74zzUCpOPu47ql_NzT5oeqegfFf1uqS460ChYMVXjJ3vpXMuAi-paGZv0jdEVQvlYaW-tpryxEvuoJ2_UHgDZ-Ww60TfSCxBhSmcW5sR_HfvWLQ6pvpuXYtZ9WZbKFu4vwCCVJTlQE_Q7YrsYQ8HQcnZ5KCA_2ulUikbZmjQejUm6RCA3gpvntKxW43ED6V_PO7WfMJWcXZrfy4Q76up8RY55NuH6FCdfag8zjlvH1uTF1aiWXSmW3bTc_g8f05B0CU_98A11sNEMmBkjjLrVvJgMN_6xhldkWEXBHBzP_aDQzKR5T3f00CtwUIE_5DqJ1jYBaKPfxVlT02FXRQ6HHXcC5lpFUN2ReRDauw3F0k_XR_6a91KBZAhc7-fJuHnRCwCoYQZ4NFnjAGhpOYaSbNBg\",
                    \"processed_unicorn_ids\": [], \"is_end_of_serp\": false}"},
                    "result_ids_shown": [], "unit_id_logging_fields":
                    {"num_total_modules": 1, "num_total_results": 7,
                    "num_total_vertical_results": 7},
                    "entity_ids_shown_by_type": {}, "processed_unicorn_ids": [],
                    "completed_flows": ["INTERNAL_DEBUG_MODULE",
                    "SEARCH_CONTROLS_INTERCEPT", "INTEGRITY", "SPELLER",
                    "SOCIAL_RAG", "XE_LINK_GROWTH_UPSELL_PEOPLE_TAB",
                    "PEOPLE_TAB_UNICORN_CACHE"]}
                requestId: 3f288341-e7b0-4a70-aed0-10ea4dc5d6d2
          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: []
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: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````