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

# 로고 검색

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "ok": true,
    "data": [
      {
        "id": "efc3943a-ddac-4f59-a2cc-47a67583068b",
        "search_key": "TSLA",
        "created_at": "2022-05-18T05:19:45.008547Z",
        "updated_at": "2025-02-05T09:43:14.303261Z",
        "colors": {
          "background_light": "#FFFFFF",
          "background_dark": "#000000"
        },
        "files": {
          "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_light.png?x-bz-cred=...",
          "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_dark.png?x-bz-cred=...",
          "logo_vector_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_vector_light.svg?x-bz-cred=...",
          "logo_vector_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_vector_dark.svg?x-bz-cred=...",
          "mark_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_light.png?x-bz-cred=...",
          "mark_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_dark.png?x-bz-cred=...",
          "mark_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_composite_light.png?x-bz-cred=...",
          "mark_composite_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_composite_dark.png?x-bz-cred=...",
          "mark_vector_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_light.svg?x-bz-cred=...",
          "mark_vector_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_dark.svg?x-bz-cred=...",
          "mark_vector_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_composite_light.svg?x-bz-cred=...",
          "mark_vector_composite_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_composite_dark.svg?x-bz-cred=..."
        },
        "securities": [
          {
            "symbol": "TSLA",
            "name": "TESLA INC",
            "cik": "1318605",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "exchange_name": "NASDAQ Global Select Consolidated",
            "cusip": "88160R101",
            "isin": "US88160R1014",
            "country": "US",
            "figi_share_class": "BBG001SQKGD7",
            "figi": "BBG000N9MNX3",
            "security_type": "Common Stock"
          },
          {
            "symbol": "TL0",
            "name": "TESLA INC",
            "cik": "1318605",
            "exchange": "MUN",
            "mic_code": "XMUN",
            "exchange_name": "Munich Stock Exchange",
            "cusip": "88160R101",
            "isin": "US88160R1014",
            "country": "DE",
            "figi_share_class": "BBG001SQKGD7",
            "figi": "BBG000WGWVP7",
            "security_type": "Common Stock"
          }
        ]
      }
    ]
  }
  ```

  ```json Response (400 Bad Request) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "bad_request",
        "id": "invalid_parameter",
        "value": "유효하지 않은 search_keys_type 매개변수"
      }
    ]
  }
  ```

  ```json Response (401 Unauthorized) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "인증 토큰이 유효하지 않거나 누락되었습니다"
      }
    ]
  }
  ```

  ```json Response (404 Not Found) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "지정된 검색 키에 해당하는 로고를 찾을 수 없습니다"
      }
    ]
  }
  ```

  ```json Response (500 Internal Server Error) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "요청 처리 중 예기치 않은 오류가 발생했습니다"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml ko/openapi/logo-api.spec.yml GET /api/v2/logos/search
openapi: 3.0.0
info:
  contact: {}
  description: >-
    توفّر واجهة برمجة التطبيقات REST هذه نقاط نهاية للبحث عن الشعارات واسترجاع
    تفاصيلها.
  termsOfService: http://swagger.io/terms/
  title: Logo API
  version: 2.1.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v2/logos/search:
    get:
      tags:
        - logos
      summary: البحث عن الشعارات
      description: البحث عن الشعارات
      operationId: get-search-logos
      parameters:
        - description: >-
            قائمة بمعرّفات أوراق مالية مفصولة بفواصل. الحد الأقصى هو 100 معرّف.
            يعتمد النوع على معامل search_keys_type.
          in: query
          name: search_keys
          required: true
          schema:
            type: string
        - description: >-
            نوع المعرّف الذي يتم البحث عنه. الأنواع المدعومة: symbol
            (الافتراضي)، cik، cusip، رقم التعريف الدولي للأوراق المالية ISIN
          in: query
          name: search_keys_type
          schema:
            type: string
        - description: >-
            قائمة مفصولة بفواصل لحقول الشعارات المطلوب إرجاعها. الحد الأقصى 12
            حقلًا. المتاح: logo_light, logo_dark, logo_vector_light,
            logo_vector_dark, mark_light, mark_dark, mark_vector_light,
            mark_vector_dark, mark_composite_light, mark_composite_dark,
            mark_vector_composite_light, mark_vector_composite_dark, colors
          in: query
          name: fields
          required: true
          schema:
            type: string
        - description: >-
            إذا كانت القيمة true ولا يوجد شعار، يتم إنشاء صورة تركيبية استنادًا
            إلى اسم الشركة وألوان علامتها التجارية
          in: query
          name: composite_auto
          schema:
            type: boolean
        - description: >-
            نصف قطر حافة الصور المركّبة كنسبة مئوية. النطاق من 0 إلى 50، حيث
            تُنشئ القيمة 50 دائرة. القيمة الافتراضية: 0
          in: query
          name: composite_radius
          schema:
            type: integer
        - description: >-
            قم بضبط أبعاد الصورة بتنسيق WIDTHxHEIGHT (مثلًا: 300x300). يتم تصغير
            الصور فقط ولا يتم تكبيرها مطلقًا. القيمة الافتراضية: 300x300
          in: query
          name: scale
          schema:
            type: string
        - description: الحد الأقصى لعرض الصور بعد تحجيمها بالبكسل
          in: query
          name: max_width
          schema:
            type: string
        - description: >-
            إذا كانت القيمة true، فسيُضاف معامل الاستعلام
            flutter_compatible=true إلى عناوين URL لملفات SVG لضمان التوافق مع
            مكتبة flutter_svg
          in: query
          name: flutter_compatible
          schema:
            type: boolean
      responses:
        '200':
          description: >-
            استجابة ناجحة تتضمن مصفوفة من كائنات LogoClientResponse ضمن الحقل
            data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '400':
          description: طلب غير صالح - معلمات غير صحيحة أو مفقودة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '404':
          description: غير موجود - لم يتم العثور على شعارات لمفاتيح البحث المحددة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    bzhttp.Resp:
      properties:
        data:
          additionalProperties: true
          type: object
        errors:
          items:
            $ref: '#/components/schemas/bzhttp.Error'
          type: array
        ok:
          type: boolean
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - json_unmarshaling_error
        - no_data_found
        - no_matching_endpoint
        - bad_request
        - db_error
        - internal_server_error
        - auth_failed
        - forbidden
        - failed_dependency
        - service_unavailable
        - upstream_api_error
        - unsupported_message_type
        - database_query_error
      type: string
      x-enum-varnames:
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````