apipick
[ reference · logos ]● 2 cr · 120 req/min

로고 검색 API

키워드로 브랜드 로고를 검색하고, 필요하면 카테고리로 좁히고, 사용 가능한 에셋을 확인한 뒤, 깔끔한 요청·응답 워크플로 한 번으로 원하는 파일을 가져오세요.

브랜드 마크워드마크에셋 가져오기
auth · x-api-key

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리

요청

필수 검색어를 입력하고, 필요하면 카테고리로 좁힌 뒤 요청 한 번을 제출하세요.

GET /api/logos
카테고리
빠른 예시
요청 형태
이 search 매개변수는 필수입니다.
GET /api/logos?search=openai&limit=24

응답

일치 항목을 검토하고, 선택한 에셋을 확인한 뒤 복사하거나 다운로드하세요.

준비됨
아직 응답이 없습니다

검색 요청을 제출해 일치하는 로고를 불러오고 응답을 확인하세요.

[ 02 · integrate ]

통합 가이드

스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.

spec
GET/api/logos?search=vercel&limit=12
base
https://www.apipick.com

Search logo metadata by required keyword and optional category filter. The response is an array of matching logo records with asset details.

매개변수
searchstring필수

Required keyword for case-insensitive title/slug matching. openai

categorystring선택

Restrict search to a specific category. AI

limitnumber선택

Maximum results to return. 1-100. 24

curl -X GET "https://www.apipick.com/api/logos?search=vercel&limit=12" \
  -H "x-api-key: YOUR_API_KEY"
● 200 · 응답
[
  {
    "id": 371,
    "title": "Vercel",
    "categories": [
      "Vercel"
    ],
    "url": "https://vercel.com",
    "assets": [
      {
        "kind": "logo",
        "theme": "light",
        "filename": "vercel.svg",
        "url": "https://www.apipick.com/logo-library/vercel.svg",
        "width": 76,
        "height": 65,
        "aspectRatio": "76:65",
        "suggestedUseCases": [
          "app icons",
          "favicons",
          "avatars",
          "navigation bars",
          "mobile headers"
        ]
      },
      {
        "kind": "logo",
        "theme": "dark",
        "filename": "vercel_dark.svg",
        "url": "https://www.apipick.com/logo-library/vercel_dark.svg",
        "width": 76,
        "height": 65,
        "aspectRatio": "76:65",
        "suggestedUseCases": [
          "app icons",
          "favicons",
          "avatars",
          "navigation bars",
          "mobile headers"
        ]
      }
    ]
  }
]
[ 03 · limits ]

요청 제한

스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.

요청 속도

120req/min

API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.

동시성

3concurrent

API 키당 동시에 처리 중인 최대 요청 수.

응답 헤더
X-RateLimit-Limit분당 허용되는 최대 요청 수
X-RateLimit-Remaining현재 윈도우에 남은 요청 수
X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초
Retry-After재시도 전 대기 초 (429일 때만)
● 429 · 요청이 너무 많음
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

자주 묻는 질문

Q: 검색 엔드포인트는 무엇을 반환하나요?

A: 핵심 필드(id, title, categories, url, assets)와 종횡비, 추천 활용 사례 같은 에셋 메타데이터를 담은 간결한 로고 레코드 배열을 반환합니다.

Q: 검색어 없이 전체 로고 카탈로그를 나열할 수 있나요?

A: 아니요. GET /api/logos는 비어 있지 않은 search 매개변수를 요구합니다. 이 엔드포인트는 전체 라이브러리 내보내기가 아닌 타깃 조회를 위해 설계되었습니다.

Q: 로고 파일은 어떻게 가져오나요?

A: GET /api/logos로 검색한 뒤, 각 에셋의 url 필드를 사용해 파일을 직접 가져오거나 임베드하세요 — 추가 API 호출이 필요 없습니다.

Q: SVG 로고만 제공하나요?

A: 아니요. 현재는 SVG가 주요 형식이며 PNG, WebP를 비롯한 추가 에셋 형식이 더해지고 있습니다. 검색 응답은 이미 일반적인 에셋 메타데이터를 중심으로 구조화되어 있어 클라이언트가 둘 이상의 파일 형식을 깔끔하게 지원할 수 있습니다.