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

공개 GitHub 데이터 API

SocialCrawl API 키로 공개 GitHub 프로필, 저장소, 이슈, 릴리스, 검색 결과를 구조화 JSON으로 가져옵니다. Author, Post, Comment 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
GitHub logo
/v1/github

활성 엔드포인트는 11개입니다. dossier 컴포지트는 1개입니다.

  • GET /v1/github/profile
  • GET /v1/github/repo
  • GET /v1/github/profile/repos
  • GET /v1/github/repo/readme
  • GET /v1/github/repo/releases
  • GET /v1/github/repo/issues
  • GET /v1/github/issue
  • GET /v1/github/issue/comments
  • GET /v1/github/search
  • GET /v1/github/repo/top-issues
  • GET /v1/github/repo/dossier
  • GET /v1/github/user/profile-velocity

GitHub 엔드포인트

공개 GitHub 읽기 엔드포인트는 11개이며 dossier 컴포지트는 1개입니다. 사용자 프로필, 저장소, README, 릴리스, 이슈, 댓글, 검색, 기여 속도를 제공합니다. 데이터 API만 지원하며 비공개 저장소, 쓰기, GitHub OAuth 앱은 포함되지 않습니다.

사용자 프로필

1 크레딧
/v1/github/profile

공개 사용자 프로필을 반환합니다. 로그인, 이름, 아바타, 소개, 팔로워와 팔로잉 수, 공개 저장소 수, 계정 생성일이 포함됩니다.

handle

저장소

1 크레딧
/v1/github/repo

저장소 하나를 반환합니다. 전체 이름, 설명, 스타, 포크, 열린 이슈, 워처, 주 언어, 생성일이 포함됩니다.

url

프로필 저장소 목록

1 크레딧
/v1/github/profile/repos

사용자가 소유한 공개 저장소를 반환합니다. 이름, 설명, 주 언어, 스타와 포크 수, 생성일과 마지막 푸시 날짜가 포함됩니다.

handle, type, sort, direction, per_page, page

저장소 README

1 크레딧
/v1/github/repo/readme

저장소 README를 파일 원문으로 반환합니다. 바로 읽거나 모델에 넣을 수 있습니다.

url

저장소 릴리스

1 크레딧
/v1/github/repo/releases

최근 릴리스를 최신순으로 반환합니다. 태그, 이름, 릴리스 노트, 배포일, 프리릴리스 여부, 첨부 파일이 포함됩니다.

url, per_page, page

저장소 이슈 목록

1 크레딧
/v1/github/repo/issues

저장소의 이슈를 반환합니다. 제목, 본문, 작성자, 라벨, 상태, 날짜가 포함됩니다. 풀 리퀘스트도 같은 목록에 표시됩니다. type, state, label, date로 필터합니다.

url, type, state, labels, sort, direction, since, per_page, page

이슈 또는 풀 리퀘스트

1 크레딧
/v1/github/issue

URL로 이슈 또는 풀 리퀘스트 1건을 가져옵니다. 제목, 본문, 작성자, 라벨, 상태, 리액션 수, 댓글 수, 날짜가 포함됩니다.

url

이슈 댓글

1 크레딧
/v1/github/issue/comments

이슈 또는 풀 리퀘스트의 댓글을 오래된 순으로 반환합니다. id, 작성자, 본문, 리액션 수, 작성 시각이 포함됩니다.

url, since, per_page, page

이슈 검색

1 크레딧
/v1/github/search

GitHub 전체에서 질의와 맞는 이슈와 풀 리퀘스트를 전체 매칭 건수와 함께 반환합니다. GitHub 검색 문법을 사용합니다.

query, sort, order, per_page, page

상위 이슈

5 크레딧
/v1/github/repo/top-issues

저장소에서 이슈 두 건을 반환합니다. 리액션이 가장 많은 기능 요청 하나와 논의가 가장 많은 불만 하나입니다.

url

프로필 기여 속도

10 크레딧
/v1/github/user/profile-velocity

사용자 기여 dossier를 반환합니다. 연 풀 리퀘스트와 머지된 풀 리퀘스트, 외부 저장소 기여, 본인 저장소가 포함됩니다. depth로 상세를 붙일 저장소 수를 조절합니다.

handle, depth

저장소 dossier

5 크레딧
/v1/github/repo/dossier

저장소 하나를 기본 정보, README 발췌, 최근 릴리스 3건, 최다 요청 기능, 최다 불만으로 묶어 한 번에 반환합니다. repo, readme, releases, issues를 따로 호출하지 않을 때 사용합니다.

구성은 저장소 메타데이터, README 발췌, 최근 릴리스, 상위 기능 요청, 상위 불만입니다. 선택 레그 실패는 나머지 dossier를 막지 않습니다.

GitHub API12개 엔드포인트 지원
문서 보기

GitHub 사용자의 공개 프로필을 로그인 아이디, 이름, 아바타, 소개, 팔로워와 팔로잉 수, 공개 저장소 수, 가입일과 함께 반환합니다.

사용자명을 알고 있고 저장소 목록을 뽑기 전에 사람부터 파악할 때 사용하세요.

GET/v1/github/profile?handle=octocat

handle · GitHub username — 1–39 chars, alphanumeric + non-consecutive hyphens, no leading/trailing hyphen.

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

GitHub API 동작

GitHub도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/github/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. GitHub OAuth 앱과 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. GitHub OAuth 앱과 클라이언트 personal access token은 필요 없습니다. 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

GitHub 라우트는 모두 GET입니다. handle, url, query, depth, 필터를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

표준 읽기는 1 크레딧입니다. 상위 이슈와 저장소 dossier는 5 크레딧입니다. 프로필 기여 속도는 10 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 목록 응답은 라우트가 지원할 때 페이지네이션을 가집니다.

연동 순서

대부분 제품은 매 틱마다 전 엔드포인트를 호출하지 않습니다. 사용자나 저장소를 확인한 뒤 표면 목록을 보고 필요한 이슈만 깊게 읽습니다.

01프로필 또는 저장소
GET /v1/github/repo?url=…

Author 형태 사용자 또는 저장소 카드입니다. 스타, 언어, 카운터가 포함됩니다.

콘텐츠 목록 전에 핸들이나 저장소 URL을 한 번 확정합니다.

02저장소 목록과 README
GET /v1/github/repo/issues?url=…&state=open

사용자 저장소 목록, 또는 한 프로젝트의 README와 릴리스입니다.

이슈를 열기 전에 인벤토리와 프로젝트 설명을 확보합니다.

03이슈
GET /v1/github/issue?url=…

저장소 이슈 목록, 또는 URL로 이슈 1건입니다.

라벨, 본문, 상태 필터가 필요할 때 목록 행만으로는 부족합니다.

04댓글 또는 dossier
GET /v1/github/issue/comments?url=…

이슈 댓글, top-issues 쌍, 또는 전체 저장소 dossier입니다.

논의나 프로젝트 요약은 해당 항목이 중요할 때만 펼칩니다.

요청
GET /v1/github/repo
  ?url=https://github.com/octocat/Hello-World
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# deepen issues
GET /v1/github/repo/issues?url=https://github.com/octocat/Hello-World&state=open
GET /v1/github/repo/dossier?url=https://github.com/octocat/Hello-World
응답 봉투
{
  "success": true,
  "data": {
    "id": "octocat/Hello-World",
    "username": "octocat/Hello-World",
    "display_name": "Hello-World",
    "followers": 2800,
    "url": "https://github.com/octocat/Hello-World",
    "ext": {
      "language": "C",
      "forks": 1400,
      "open_issues": 12
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다. 저장소 카드와 이슈 스레드는 다른 플랫폼과 같은 리프를 사용합니다.

Authorprofile, repo

id, username(login), display_name, avatar_url, bio, followers, following, url, ext(공개 저장소 수, created_at)

PostList / Postprofile/repos, repo/releases, repo/issues

저장소 또는 이슈 레코드: id, url, content.text, engagement(스타/리액션, 댓글), author, published_at, ext(언어, 라벨, 상태, 포크)

CommentListissue, issue/comments, search

items[]: author, content.text, engagement, published_at. 이슈 또는 풀 리퀘스트 토론

Analyticsdossier, top-issues, profile-velocity

top-issues 쌍, 저장소 dossier(info, readme, releases, top_issues), 또는 profile-velocity(velocity, contributed_repos, own_repos)

게이트웨이

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. GitHub 전용 사이드카가 아닙니다.

  1. 01

    엣지 수신

    Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 github/profile 등을 찾습니다. 필수 파라미터와 URL·핸들 형식 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 조회

    platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 표준 읽기는 GitHub REST(api.github.com)를 직접 호출하고 컴포지트는 여러 GitHub 호출을 펼칩니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.

  4. 04

    정규화 후 반환

    업스트림 JSON을 Author, Post, PostList, CommentList, Analytics로 매핑합니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.

과금 규칙

  • 표준 라이브 미스는 1 크레딧입니다.
  • 상위 이슈는 고정 5 크레딧입니다.
  • 저장소 dossier는 고정 5 크레딧입니다.
  • 프로필 기여 속도는 10 크레딧입니다.
  • 캐시 히트는 0 크레딧입니다.
  • 빈 응답과 하드 실패는 자동 환불됩니다.
  • 잘못된 파라미터는 400이며 과금하지 않습니다.
  • 잔액이 없으면 402이며 과금하지 않습니다.
  • 비활성 라우트는 503이며 과금하지 않습니다.

데이터 수집

GitHub는 공개 읽기 개발자 데이터입니다. SocialCrawl 스키마로 정규화하므로 두 번째 OAuth나 GitHub 전용 응답 형태를 코드에 넣을 필요가 없습니다.

API에서의 GitHub

공개 프로필, 저장소, README, 릴리스, 이슈, 풀 리퀘스트, 댓글을 읽기 전용으로 제공합니다. 리서치, 모니터링, 제품 작업에 사용합니다. 비공개 저장소와 쓰기 접근은 없습니다.

업스트림

SocialCrawl 게이트웨이 뒤에서 GitHub REST API(api.github.com)를 직접 호출합니다. top-issues, dossier, profile-velocity 컴포지트는 여러 GitHub 호출을 펼친 뒤 결과를 합칩니다.

응답 형태

success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 사용자는 Author로, 저장소와 이슈는 아키타입이 맞는 범위에서 Post 리프로 정규화됩니다.

미제공 항목

쓰기 엔드포인트는 없습니다. 비공개 저장소 콘텐츠는 없습니다. GitHub Actions 로그와 조직 관리 표면은 없습니다. 활성 목록은 레지스트리 문서를 따릅니다.

필드 매핑
user / repo card→ author.*login, 소개, 팔로워, 공개 저장소, 아바타
issue / PR title + body→ post.content.text + ext.*스타, 포크, 언어, 열린 이슈, 설명
issue comments list→ CommentList items[]이슈 제목, 라벨, 상태, 리액션, 댓글

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

12active GitHub endpoints in the registry
1 / 5 / 10표준, advanced, premium 크레딧 사다리

저장소 인텔리전스와 개발자 기여 모니터링

호출은 프로필·저장소 카드, 이슈 목록, README·릴리스 조회, 그리고 프로젝트나 사람을 밀집 요약할 때의 dossier·velocity 컴포지트에 집중됩니다. 공유 스키마의 공개 GitHub 읽기와 크레딧 과금입니다. 스택에 GitHub OAuth 앱이 필요 없습니다. 컴포지트는 다중 호출 dossier를 한 청구 라우트로 묶습니다.

표준 프로필, 저장소, 이슈 호출은 라이브 미스 시 보통 수 초입니다. top-issues, dossier, profile-velocity 컴포지트는 업스트림 호출이 여러 번이라 더 느립니다.

GitHub API 활용 사례

GitHub 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

오픈소스 모니터

Python, cron, Slack 봇

고정 프로젝트 집합의 저장소 카드, 릴리스, 이슈 목록을 폴링합니다. 스타, 열린 이슈, 릴리스 노트가 바뀌면 알립니다.

제품 리서치 팀

Node, 노트북, BI 적재

GitHub 전체 이슈 검색 후 본문, 댓글, top-issues 또는 dossier를 펼쳐 기능 요청과 불만을 확인합니다.

백엔드 제품 잡

Go, 워커, Explorer

프로필, 저장소, README, 이슈를 파이프라인에 연결합니다. 기여자 점수에는 profile-velocity를 씁니다. 카탈로그와 같은 API 키를 사용합니다.

호출 예시

표준 티어는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다. 상위 이슈, dossier, 프로필 기여 속도는 상위 티어입니다.

curl "https://www.socialcrawl.dev/v1/github/repo?url=https://github.com/octocat/Hello-World" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/github/search?query=is:issue+label:bug" \
  -H "x-api-key: sc_your_api_key_here"
GitHub logoSocialCrawl GitHub

카탈로그와 같은 API 키

플랫폼 문서API 키 받기
엔드포인트

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

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

ProfileGet a GitHub user profileRepoGet a GitHub repositoryProfile ReposList a GitHub user's repositoriesRepo ReadmeGet a repository's READMERepo ReleasesList a repository's releasesRepo IssuesList a repository's issues (and PRs)IssueGet a single issue or pull requestIssue CommentsGet comments on an issue or pull requestSearchSearch GitHub issues and pull requestsRepo Top IssuesTop feature request and top complaint for a repositoryRepo DossierFull project dossier for a repositoryUser Profile VelocityUser contribution velocity dossier
비교

SocialCrawl과 공식 GitHub REST API, 뭐가 다른가요?

같은 GitHub 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증

SocialCrawl
48개 플랫폼을 아우르는 x-api-key 하나면 돼요
공식 GitHub REST API
개인 액세스 토큰(PAT)을 직접 발급·범위 지정·교체해야 해요

시작하기

SocialCrawl
가입하고 키를 복사해 GET 요청 하나면 끝이에요
공식 GitHub REST API
무료지만 프로젝트마다 토큰을 따로 관리해야 해요

레이트리밋

SocialCrawl
업스트림에서 알아서 처리해 드려서 403 재시도 코드가 필요 없어요
공식 GitHub REST API
인증 토큰당 시간당 5,000회, 재시도 로직을 직접 짜야 해요

응답 스키마

SocialCrawl
48개 플랫폼과 같은 통합 data.items 구조예요
공식 GitHub REST API
리소스마다 형태가 달라요. README는 Base64, 페이지네이션은 Link 헤더

요금

SocialCrawl
표준 1·어드밴스드 5·프리미엄 10 크레딧, 신용카드 없이 100 크레딧 무료
공식 GitHub REST API
레이트리밋 안에서는 무료

데이터 범위

SocialCrawl
원본 리소스에 AI 종합 리포트·핵심 이슈·기여 속도까지 더했어요
공식 GitHub REST API
원본 리소스는 풍부하지만 합성·AI 엔드포인트는 없어요

유지보수

SocialCrawl
업스트림 변경은 SocialCrawl이 따라가요
공식 GitHub REST API
토큰 교체와 스키마 변경을 직접 챙겨야 해요
자주 묻는 질문

자주 묻는 질문

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

문의하기
SocialCrawl GitHub API는 어떤 서비스인가요?
api.github.com을 감싼 통합 API로, 프로필·저장소·이슈·PR·README·릴리스까지 엔드포인트 12종을 제공해요. x-api-key 하나로 호출하고, 다른 SocialCrawl 플랫폼과 똑같은 data.items 스키마로 응답을 받아볼 수 있어서 플랫폼마다 SDK를 따로 익힐 필요가 없어요.
SocialCrawl은 어떤 GitHub 엔드포인트를 지원하나요?
엔드포인트 12종이에요: Profile, Repo, Profile Repos, Repo Readme, Repo Releases, Repo Issues, Issue, Issue Comments, Search, Repo Top Issues, Repo Dossier, and User Profile Velocity.
GitHub 개인 액세스 토큰(PAT)이 필요한가요?
필요 없어요. SocialCrawl이 GitHub 인증을 대신 처리하니 개인 액세스 토큰(PAT)을 발급·범위 지정·교체할 일이 없어요. SocialCrawl x-api-key와 핸들이나 저장소 URL만 넘기면, 통합 스키마로 응답을 바로 받아보실 수 있어요.
GitHub API는 요금이 얼마인가요?
대부분의 엔드포인트는 1 크레딧(스탠다드 티어)이에요. AI 어드밴스드 엔드포인트(핵심 이슈, 종합 리포트)는 각각 5 크레딧, 기여 속도는 프리미엄 10 크레딧이고요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받아 모든 엔드포인트를 시험해 보실 수 있어요.
GitHub 레이트리밋이나 페이지네이션을 직접 처리해야 하나요?
아니요, SocialCrawl이 GitHub REST 레이트리밋과 페이지네이션을 업스트림에서 알아서 처리해 드려요. 리소스만 요청하면 깔끔한 JSON으로 돌아와요. 403 레이트리밋 재시도나 Link 헤더 커서 파싱 없이, 늘 쓰던 동일한 응답 형식 그대로 받아볼 수 있어요.
종합 리포트·핵심 이슈·기여 속도 엔드포인트는 일반 GitHub API와 뭐가 다른가요?
GitHub REST API는 한 번에 리소스 하나만 원본 그대로 돌려줘요. 이 합성 엔드포인트 세 종은 여러 호출을 한 답으로 묶어서, 저장소 전체를 아우르는 종합 분석, 핵심 기능 요청과 핵심 불만, 사용자 기여 속도 리포트를 한 번에 받아볼 수 있어요. 100 크레딧으로 바로 시작해 봐요.
가장 좋은 GitHub 스크레이퍼 API는 무엇인가요?
PAT 관리 없이 GitHub 데이터를 받고 싶다면 SocialCrawl이 좋은 선택이에요. 프로필·저장소·이슈·릴리스·검색까지 엔드포인트 12종에, 공식 REST API에는 없는 AI 종합 리포트·핵심 이슈·기여 속도 엔드포인트까지 더했어요. 표준 호출은 1 크레딧이고, 신용카드 없이 100 크레딧으로 바로 시작할 수 있어요.
GitHub 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 GitHub 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. GitHub 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
GitHub 스크래핑 API와 공식 GitHub API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 GitHub 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

GitHub API 레퍼런스 문서 보기

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