> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # API 요청 로그 목록 > 워크스페이스에서 실행된 API 요청 로그를 페이지네이션 형식으로 조회합니다. 각 항목은 `pubrio-api-key`로 실행된 단일 요청을 의미하며, 경로, 메서드, 상태 코드, 소요 시간, 응답 크기, 사용 크레딧을 포함합니다. 특정 로그의 전체 요청 및 응답 본문을 확인하려면 [로그 상세 조회](/ko/api-reference/endpoint/api-keys/logs_lookup) 엔드포인트를 사용하세요. ## OpenAPI ````yaml ko-openapi POST /api_keys/logs openapi: 3.0.0 info: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /api_keys/logs: post: tags: - API Keys summary: API 요청 로그 목록 조회 description: >- 워크스페이스에서 실행된 API 요청 로그를 페이지네이션 형식으로 조회합니다. 각 항목은 `pubrio-api-key`로 실행된 단일 요청을 의미하며, 경로, 메서드, 상태 코드, 소요 시간, 응답 크기, 사용 크레딧을 포함합니다. 특정 로그의 전체 요청 및 응답 본문을 확인하려면 [로그 상세 조회](/ko/api-reference/endpoint/api-keys/logs_lookup) 엔드포인트를 사용하세요. operationId: api_keys_get_logs requestBody: required: true content: application/json: schema: type: object properties: profile_id: $ref: '#/components/schemas/profile_id' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' order_by: type: string enum: - created_at - duration_ms - status_code default: created_at description: 로그 목록 정렬에 사용할 필드. is_ascending_order: type: boolean default: false description: 정렬 방향. `true`는 오름차순, `false`(기본값)는 내림차순. search_term: type: string description: 요청 경로, 로그 타입 슬러그, 원본 요청 본문에 대한 자유 검색. log_types: type: array items: type: integer description: 로그 타입 ID로 필터링. log_type_slugs: type: array items: type: string description: '로그 타입 슬러그로 필터링(예: `people_search`, `company_search`).' status_codes: type: array items: type: integer description: 'HTTP 상태 코드로 필터링(예: `[200, 400, 500]`).' methods: type: array items: type: string description: 'HTTP 메서드로 필터링(예: `["POST", "GET"]`).' responses: '200': description: 페이지네이션된 API 요청 로그를 반환하는 성공 응답. content: application/json: schema: type: object properties: metadata: type: object properties: filters: type: object description: 이 응답을 생성하는 데 사용된 요청 필터의 반환값(빈 값은 제거됨). additionalProperties: true data: type: object properties: pagination: type: object properties: page: type: integer description: 현재 페이지 번호. per_page: type: integer description: 페이지당 결과 수. total_entries: type: integer description: 전체 로그 항목 수. total_pages: type: integer description: 전체 페이지 수. total_display_pages: type: integer description: 현재 플랜에서 표시 가능한 최대 페이지 수. is_timeout: type: boolean description: 카운트 쿼리 시간 초과 여부. query_logs: type: array items: type: object properties: query_log_id: type: string format: uuid description: >- 로그 항목의 고유 식별자. 전체 내용을 조회하려면 `/api_keys/logs/lookup`에 전달합니다. created_at: type: string description: 요청 수신 시각(UTC). profile_id: type: integer description: 요청과 연결된 워크스페이스 프로필 ID. user_id: type: string format: uuid description: API 키와 연결된 사용자 ID. method: type: string description: 요청의 HTTP 메서드. path: type: string description: 요청 경로. status_code: type: integer description: 반환된 HTTP 상태 코드. duration_ms: type: integer description: 요청 처리 시간(밀리초). log_type_id: type: integer description: 내부 로그 타입 ID. 청구 대상 로그 타입에 매핑되지 않은 요청은 `0`. log_type_slug: type: string nullable: true description: >- 로그 타입 슬러그(예: `people_search`). 청구 대상이 아닌 요청은 `null`. log_type_name: type: string nullable: true description: 사람이 읽을 수 있는 로그 타입 이름. authentication_type: type: string description: 사용된 인증 방식. API 키 요청은 항상 `pubrio-api-key`. authentication_type_name: type: string description: 사람이 읽을 수 있는 인증 방식 이름. masked_authentication: type: string description: 이 요청에 사용된 API 키의 마스킹된 표현. response_size: type: integer description: 응답 본문 크기(바이트). credits: type: number description: 이 요청에서 차감된 총 크레딧. ip: type: string description: 호출자의 클라이언트 IP 주소. email: type: string description: API 키 소유 사용자의 이메일. nickname: type: string description: API 키 소유 사용자의 닉네임. user: type: object properties: user_id: type: string format: uuid nickname: type: string email: type: string example: metadata: filters: page: 1 per_page: 3 status_codes: - 200 data: pagination: page: 1 per_page: 3 total_entries: 1109 total_pages: 370 total_display_pages: 250 is_timeout: false query_logs: - query_log_id: fc1ce3dd-39f7-4fbd-9d22-569a17115c11 created_at: '2026-05-14 12:04:32.243' profile_id: 1 user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf method: POST path: /api_keys/usage/daily status_code: 200 duration_ms: 1821 log_type_id: 0 authentication_type: pubrio-api-key masked_authentication: 0••••••••••••••••f39 response_size: 2180 ip: 127.0.0.1 email: you@example.com nickname: Example User user: user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf nickname: Example User email: you@example.com log_type_slug: null credits: 0 log_type_name: null authentication_type_name: API Key '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: profile_id: type: integer description: >- 선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다. 자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요. page: type: integer example: 1 description: 조회할 데이터 페이지 번호입니다. per_page: type: integer example: 25 description: 페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다. responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````