100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
PyPI logoPyPI API

PyPI 프로젝트 릴리스 데이터 API

SocialCrawl API 키로 PyPI 프로젝트 릴리스별 의존성, 지원 Python 버전, 링크, 모든 파일의 sha256 다이제스트를 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.

PyPI logo
/v1/pypi

활성 엔드포인트는 1개입니다. 프로젝트 릴리스 상세를 지원합니다.

  • GET /v1/pypi/project

PyPI 엔드포인트

공개 PyPI 프로젝트를 읽는 엔드포인트는 1개입니다. 최신 릴리스나 원하는 버전을 전체로 읽습니다.

/v1/pypi/project

이름이나 링크로 프로젝트 릴리스 하나를 반환하며 기본값은 최신 릴리스입니다. 요약, 긴 설명, 버전, 지원 Python 버전, 선언된 의존성, 프로젝트 링크, 라이선스, yanked 여부, 그리고 다운로드 링크, 크기, sha256 다이제스트, 패키지 유형, 업로드 시각이 담긴 모든 파일이 포함됩니다. PyPI에 없는 프로젝트나 버전은 404를 반환하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.

project or url, version

PyPI API1개 엔드포인트 지원
문서 보기
Packages

PyPI 프로젝트의 릴리스 하나를 의존성, 지원 Python 버전, 링크, sha256 다이제스트가 포함된 모든 파일과 함께 반환합니다.

Python 의존성을 확인하거나 릴리스가 요구하는 항목을 보고 내려받은 파일을 검증할 때 사용하세요.

1크레딧

GET/v1/pypi/project?project=requests
$ curl https://www.socialcrawl.dev/v1/pypi/project?project=requests \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

PyPI API 동작

PyPI도 SocialCrawl의 일반 데이터 표면입니다. API 키로 GET /v1/pypi/…를 호출하고, 실시간 조회에만 크레딧을 쓰며, 하나의 JSON 응답 형식을 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 PyPI 계정은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

쿼리 파라미터로 GET 호출

프로젝트는 project나 url과 version을 받습니다. 과금 전에 형식을 검증합니다.

좌석이 아닌 크레딧 과금

모든 PyPI 경로는 1 크레딧입니다. 캐시 적중은 0 크레딧입니다.

하나의 JSON 응답 형식

모든 응답은 success, data, credits_used, credits_remaining, request_id, cached로 같은 형태입니다. 페이지가 있는 경로의 목록에는 pagination이 함께 담깁니다.

일반적인 연동 흐름

대부분 제품은 의존하는 릴리스를 읽고 새 릴리스가 나오면 다시 확인합니다.

01최신 릴리스 읽기
GET /v1/pypi/project?project=…

버전, requires_dist, 파일이 담긴 Post

한 번의 호출로 프로젝트가 필요로 하는 항목과 배포 파일을 확인합니다.

02고정 버전 읽기
GET /v1/pypi/project?project=…&version=…

설치하는 정확한 릴리스의 Post

각 파일을 sha256 다이제스트로 검증합니다.

03릴리스 비교
GET /v1/pypi/project?url=…

다음 버전의 Post

업그레이드 전에 바뀐 의존성을 확인합니다.

요청
GET /v1/pypi/project?project=requests
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/pypi/project?project=requests&version=2.31.0
응답 봉투
{
  "success": true,
  "data": {
    "post": {
      "id": "requests",
      "url": "https://pypi.org/project/requests/2.31.0/",
      "content": { "text": "Python HTTP for Humans." },
      "ext": {
        "title": "requests",
        "pypi": {
          "version": "2.31.0",
          "requires_python": ">=3.7",
          "files": [{ "filename": "requests-2.31.0-py3-none-any.whl", "sha256": "58cd2187…" }]
        }
      }
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data에 담기는 내용

아키타입이 같으면 필드 이름도 SocialCrawl 전체와 같습니다. 한 번 파싱해 모든 플랫폼에 재사용합니다.

Postproject

post.id(이름), ext.title, url, content.text(요약), ext.description, ext.pypi version, requires_python, requires_dist, sha256이 담긴 files[]

게이트웨이 내부 처리

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기를 따릅니다. PyPI는 별도 부가 기능이 아닙니다.

  1. 01

    엣지에서 호출 수신

    Next.js catch-all 경로가 Hono social API로 전달합니다. request_id를 발급하고 키를 인증한 뒤 속도 제한(분당 600회)과 동시성(키당 50건)을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 pypi 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 실행합니다. 잘못된 입력은 과금 없이 400을 반환합니다. 유효한 호출은 조회 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 조회

    platform, resource, params로 결정적 캐시 키를 만듭니다. 적중하면 즉시 반환하고 credits_used는 0입니다. 미스이면 공개 데이터를 실시간으로 읽으며, 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커가 작동합니다.

  4. 04

    정규화 후 반환

    PyPI 데이터를 Post 아키타입으로 매핑하고 PyPI 고유 정보는 ext.pypi에 담아 검증한 뒤, 성공 응답으로 감싸 과금 감사용으로 기록합니다.

운영에서 중요한 과금 규칙

  • project: 1 크레딧
  • 캐시 적중: 0 크레딧
  • 빈 결과나 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • 없는 프로젝트나 버전: 404, 과금 없음
  • 모든 릴리스 파일과 sha256 제공
  • 작성자 이메일 주소 미제공
  • 게시, 계정 데이터 미지원

PyPI 데이터 수집 방식

PyPI 데이터는 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 공급사 SDK를 익힐 필요가 없습니다.

이 API에서 PyPI의 의미

Python Package Index의 공개 프로젝트와 릴리스, 각 릴리스의 의존성과 배포 파일입니다.

SocialCrawl의 수집 방식

공개 데이터를 요청 시 각 소스의 공개 이용 규칙 안에서 읽어 서버에서 정규화합니다.

엣지에서 나가는 데이터

릴리스는 Post로 공통 형태입니다. PyPI 고유 정보는 ext.pypi에 담깁니다.

실시간으로 제공하지 않는 데이터

게시, 비공개 인덱스, 작성자 이메일 주소, 계정 데이터는 제공하지 않습니다.

필드 매핑
name, version, summary→ post.*이름, 버전, 요약, 링크
requires_python, requires_dist→ post.ext.pypirequires_python, requires_dist, 라이선스
release files with sha256→ post.ext.pypi.filessha256이 담긴 릴리스 파일

이 API의 활용 분야

이 API가 가장 많이 쓰이는 작업입니다.

1active PyPI endpoints in the registry
1모든 PyPI 경로의 호출당 크레딧

의존성 조사, 릴리스 모니터링, 공급망 점검

호출하는 쪽은 코드가 의존하는 릴리스를 읽고 새 버전이 나오면 다시 읽습니다. 선언된 의존성과 모든 파일의 sha256 다이제스트가 담긴 릴리스를 공통 Post 스키마에 담아 카탈로그 전체와 같은 키로 제공합니다.

캐시 미스는 공개 소스를 요청 시 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 처리됩니다.

활용 사례

팀이 이 데이터를 활용하는 대표적인 방식과 주로 쓰는 기술 스택입니다.

의존성 검토

Python, CI 작업

프로젝트가 고정한 릴리스마다 project를 호출해 지원 Python 버전과 requires_dist를 확인합니다.

릴리스 모니터링

Node, 예약 작업

추적하는 프로젝트의 최신 릴리스를 주기적으로 project로 읽어 새 버전을 파악합니다.

공급망 점검

Go, 보안 도구

project로 릴리스 파일을 읽어 각 sha256 다이제스트를 설치된 파일과 비교합니다.

PyPI API 호출 방법

모든 PyPI 경로는 1 크레딧입니다. 캐시 적중은 무료입니다.

curl "https://www.socialcrawl.dev/v1/pypi/project?project=requests" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/pypi/project?project=requests&version=2.31.0" \
  -H "x-api-key: sc_your_api_key_here"
PyPI logoSocialCrawl의 PyPI

카탈로그 전체와 같은 키

엔드포인트

PyPI API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
SocialCrawl PyPI API는 무엇을 제공하나요?
1개 엔드포인트, Project를 제공해요. PyPI 프로젝트의 릴리스 하나를 의존성과 파일까지 읽으며, 다른 94개 플랫폼과 같은 통합 JSON으로 와요.
예전 릴리스도 읽을 수 있나요?
네. 2.31.0처럼 version을 넣거나 릴리스의 PyPI 링크를 넣으면 돼요. 기본값은 최신 릴리스예요.
파일을 검증할 수 있나요?
네. post.ext.pypi.files의 파일마다 sha256 다이제스트, 크기, 다운로드 링크가 담겨요.
작성자 이메일 주소도 오나요?
아니요. 작성자와 관리자 이메일 주소는 오지 않아요.
비용은 얼마인가요?
호출마다 1 크레딧이고 캐시 적중은 무료예요. 없는 프로젝트나 버전은 404로 응답하고 과금되지 않아요. 무료 100 크레딧으로 시작해요.
PyPI 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 PyPI 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. PyPI 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
PyPI 스크래핑 API와 공식 PyPI API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 PyPI 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

PyPI API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요