Utility API

SocialCrawl 유틸리티 API

Name: Utility Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 엔드포인트 카탈로그, 라우트별 사용 가이드, 퀵스타트 규칙, 에이전트 레퍼런스 텍스트를 구조화 JSON으로 가져옵니다. 유틸리티 라우트는 모두 0 크레딧입니다.

/v1/utility

활성 엔드포인트는 4개입니다. 무료 카탈로그와 에이전트 컨텍스트입니다.

GET /v1/utility/endpoints
GET /v1/utility/endpoint
GET /v1/utility/quickstart
GET /v1/utility/llms

유틸리티 엔드포인트

SocialCrawl API 자체를 위한 무료 메타 라우트는 4개입니다. 카탈로그 목록, 엔드포인트 가이드, 첫 호출 규칙, LLM용 레퍼런스 텍스트를 제공합니다. 개발자 경험 전용이며 소셜 스크레이프 페이로드는 없습니다.

엔드포인트 카탈로그

0 크레딧

/v1/utility/endpoints

활성 엔드포인트 전체를 경로, 메서드, 플랫폼, 크레딧 비용, 필수와 선택 파라미터, 사용 가이드 링크와 함께 기계 판독 목록으로 반환합니다. platform, search, method로 필터합니다.

platform, search, method

엔드포인트 가이드

0 크레딧

/v1/utility/endpoint

엔드포인트 하나의 사용 가이드를 파라미터 타입과 예시, 크레딧 비용, 캐싱, 페이지네이션, 샘플 호출까지 담아 반환합니다. id 또는 경로로 지정합니다.

id or url, method

퀵스타트

0 크레딧

/v1/utility/quickstart

첫 호출에 필요한 것을 한 응답으로 반환합니다. 인증, 기본 URL, 응답 형태, 크레딧 과금, 에러 코드, 레이트 리밋, 샘플이 포함됩니다.

platform

LLM 레퍼런스

0 크레딧

/v1/utility/llms

AI 에이전트용 SocialCrawl 레퍼런스 텍스트를 전체 또는 플랫폼 단위로, 마크다운 또는 구조화 객체로 반환합니다. 브라우저 문서가 아니라 에이전트 컨텍스트용입니다.

platform, format

Utility API4개 엔드포인트 지원

문서 보기

Developer Experience

호출할 수 있는 모든 엔드포인트를 경로, 메서드, 플랫폼, 크레딧 비용, 필수와 선택 파라미터, 사용 가이드 링크까지 담아 반환합니다.

엔드포인트 하나의 전체 설명은 endpoint가 담당합니다. 무엇이 있는지 훑거나 플랫폼별로 걸러 볼 때 무료로 사용하세요.

0크레딧

GET/v1/utility/endpoints?platform=tiktok

$ curl https://www.socialcrawl.dev/v1/utility/endpoints?platform=tiktok \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

유틸리티 API 동작

유틸리티는 SocialCrawl의 무료 개발자 메타 표면입니다. API 키로 GET /v1/utility/… 를 호출하면 동일한 JSON 봉투를 받습니다. 이 라우트에서는 크레딧이 차감되지 않습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 카탈로그 탐색과 이후 유료 소셜·분석 라우트에 같은 키를 사용합니다.

GET과 쿼리 파라미터

유틸리티 라우트는 모두 GET입니다. 카탈로그는 platform, search, method로 필터합니다. endpoint는 id 또는 경로로 지정합니다. llms는 필요 시 플랫폼으로 범위를 좁힙니다.

여기서는 0 크레딧

유틸리티 라우트는 모두 0 크레딧입니다. 유료 플랫폼 읽기는 각 티어를 따릅니다. 키 단위 캐시와 레이트 리밋은 그대로 적용됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 유틸리티 호출의 credits_used는 0입니다.

연동 순서

대부분 에이전트와 SDK는 무료 컨텍스트로 시작해 필요한 라우트를 확정한 뒤, 라이브 플랫폼 호출에만 크레딧을 씁니다.

01퀵스타트

GET /v1/utility/quickstart?platform=reddit

인증 규칙, 기본 URL, 봉투 형태, 과금, 에러, 레이트 리밋입니다.

문서 사이트 전체를 읽지 않고 클라이언트나 에이전트를 부트스트랩합니다.

02카탈로그

GET /v1/utility/endpoints?platform=reddit

비용과 필수 파라미터가 있는 필터된 엔드포인트 목록입니다.

경로를 하드코딩하기 전에 라이브 표면을 확인합니다.

03가이드

GET /v1/utility/endpoint?id=reddit/subreddit

한 엔드포인트의 파라미터, 예시, 페이징, 샘플 호출입니다.

필드 이름을 추측하지 않고 첫 호출을 정확히 합니다.

04유료 라우트

GET /v1/utility/llms?platform=reddit&format=markdown

/v1/{platform}/… 의 실제 플랫폼 응답입니다.

무료 메타 경로로 엔드포인트를 고른 뒤에만 크레딧을 씁니다.

요청

GET /v1/utility/endpoints
  ?platform=reddit
  &search=comment
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# agent context
GET /v1/utility/llms?platform=reddit&format=markdown

응답 봉투

{
  "success": true,
  "data": {
    "endpoints": [
      {
        "id": "reddit/subreddit",
        "method": "GET",
        "path": "/v1/reddit/subreddit",
        "credit_tier": "standard"
      }
    ]
  },
  "credits_used": 0,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

유틸리티 페이로드는 공유 SocialCrawl 봉투 아래 카탈로그와 가이드 객체입니다. 소셜 Post 리프를 설명하지 않고 API 자체를 설명합니다.

Envelopeendpoints

success, data, credits_used(0), credits_remaining, request_id, cached

Analytics / Catalogendpoint

stats, filters, total, endpoints[](path, method, platform, credits, required_params, optional_params, how_to_use)

Analytics / Guidequickstart

엔드포인트 하나의 파라미터 타입과 예시, 크레딧 비용, 캐싱, 페이지네이션, 샘플 호출

Analytics / Agent textllms

퀵스타트 규칙 또는 llms 레퍼런스(마크다운 또는 구조화 객체, 전체 또는 한 플랫폼)

게이트웨이

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. 유틸리티는 별도 제품 표면이 아닙니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 키당 레이트 리밋과 동시성을 적용합니다.

검증, 차감 없음

레지스트리에서 utility 라우트를 찾습니다. 파라미터를 검증합니다. 잘못된 입력은 400입니다. 비용이 0이므로 유효 호출도 크레딧을 차감하지 않습니다.

레지스트리 제공

카탈로그와 가이드는 요청 시점의 라이브 엔드포인트 레지스트리에서 생성되어 호출 가능 목록과 어긋나지 않습니다. quickstart와 llms는 정적 또는 조립된 레퍼런스 텍스트를 반환합니다.

봉투 후 반환

페이로드를 credits_used = 0인 성공 봉투로 감싸 다른 라우트와 같이 요청 감사에 남깁니다.

과금 규칙

유틸리티 라우트는 모두 0 크레딧입니다.
캐시 히트도 0 크레딧입니다.
잘못된 파라미터는 400이며 과금하지 않습니다.
잔액이 없어도 키가 유효하면 유틸리티는 무료입니다. 다른 라우트는 402일 수 있습니다.
레이트 리밋은 키 단위로 적용됩니다.
동시성은 키 단위로 적용됩니다.
카탈로그는 라이브 레지스트리에서 생성됩니다.
유료 플랫폼 라우트는 각 크레딧 티어를 유지합니다.
무료 메타와 유료 읽기에 같은 키를 사용합니다.

데이터 수집

유틸리티는 SocialCrawl 자체 레지스트리와 레퍼런스 텍스트를 읽습니다. 제3자 소셜 플랫폼을 스크레이프하지 않습니다.

API에서의 유틸리티

SocialCrawl 자체를 위한 개발자 경험과 에이전트 컨텍스트입니다. 카탈로그 탐색, 엔드포인트 가이드, 첫 호출 규칙, LLM 레퍼런스를 제공하며 호출은 무료입니다.

제공 방식

카탈로그와 엔드포인트 가이드는 요청 시점의 라이브 레지스트리에서 만듭니다. quickstart와 llms는 사람과 에이전트를 위한 조립 레퍼런스 콘텐츠를 반환합니다.

응답 형태

success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 이 라우트에서 credits_used는 항상 0입니다.

미제공 항목

소셜 Post, Comment, Author 페이로드는 없습니다. 쓰기 엔드포인트는 없습니다. 마케팅 문서 페이지를 대체하지 않으며 기계 판독 API 표면입니다.

필드 매핑

registry catalog→ endpoints list경로, 메서드, 플랫폼, 크레딧 비용, 파라미터

single route meta→ endpoint how-to엔드포인트별 타입, 예시, 캐싱, 샘플 호출

agent context→ llms markdown/json퀵스타트 규칙, llms 마크다운 또는 객체

이 API의 활용 분야

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

4active Utility endpoints in the registry

0 credits0 크레딧 메타·DX 라우트

무료 카탈로그 탐색과 에이전트 컨텍스트

호출은 탐색에 endpoints, 단일 라우트 상세에 endpoint, 클라이언트 부트스트랩에 quickstart, 한 번에 API 컨텍스트가 필요할 때 llms에 집중됩니다. 라이브 레지스트리와 맞는 무료 메타 라우트 4개입니다. 에이전트와 SDK가 문서 사이트를 스크레이프하지 않고 SocialCrawl을 탐색하고 호출할 수 있습니다.

유틸리티 라우트는 내부 레지스트리와 레퍼런스 응답입니다. 업스트림 소셜·분석 라이브 미스보다 보통 빠릅니다.

활용 사례

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

SDK 작성자

TypeScript, codegen, CI

endpoints를 받아 클라이언트를 생성하고 필수 파라미터를 레지스트리와 동기화합니다. 경로 목록을 손으로 고치지 않습니다.

AI 에이전트

MCP, 툴 러너, 노트북

quickstart 또는 llms로 컨텍스트를 로드한 뒤, 유료 플랫폼 호출 전에 endpoint로 선택 라우트를 확인합니다.

백엔드 제품 잡

Go, 워커, Explorer

배포 시 플랫폼별로 카탈로그를 필터하고 가이드를 캐시하며 리소스가 없으면 빠르게 실패합니다. 유료 읽기와 같은 키를 사용합니다.

호출 예시

유틸리티 라우트는 모두 0 크레딧입니다. quickstart 또는 endpoints로 시작한 뒤 다음에 호출할 경로에 endpoint를 로드합니다.

curl "https://www.socialcrawl.dev/v1/utility/endpoints?platform=reddit" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/utility/llms?platform=reddit&format=markdown" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl 유틸리티

카탈로그와 같은 API 키

플랫폼 문서 API 키 받기

엔드포인트

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

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

Browse Endpoint CatalogList every available endpoint Endpoint Usage GuideHow to use any endpoint API QuickstartGet started in one call AI Agent ContextAI-agent context payload

비교

SocialCrawl과 문서 스크래핑 + 경로 추측, 뭐가 다른가요?

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

항목	SocialCrawl	문서 스크래핑 + 경로 추측
탐색	무료 GET 한 번으로 호출 가능한 경로, 비용, 파라미터 전체 목록	HTML 문서를 긁거나 /v1/{platform}/{resource}를 추측
첫 호출	/v1/utility/quickstart가 인증, 봉투, 과금, 복사해 쓰는 curl을 한 번에	인증·에러·요금 페이지를 따로 읽어야 함
에이전트 온보딩	/v1/utility/llms가 llms.txt 코퍼스를 API JSON/마크다운으로 제공	문서 페이지를 긁고 드리프트 위험을 감수
정확도	요청을 라우팅·과금하는 라이브 레지스트리에서 생성	엔드포인트 출시·폐기 시 문서가 쉽게 낡음
탐색 비용	카탈로그·가이드·퀵스타트·에이전트 컨텍스트 전부 0 크레딧	잘못된 페이지를 읽는 시간과 토큰 비용

탐색

SocialCrawl

무료 GET 한 번으로 호출 가능한 경로, 비용, 파라미터 전체 목록

문서 스크래핑 + 경로 추측

HTML 문서를 긁거나 /v1/{platform}/{resource}를 추측

첫 호출

SocialCrawl

/v1/utility/quickstart가 인증, 봉투, 과금, 복사해 쓰는 curl을 한 번에

문서 스크래핑 + 경로 추측

인증·에러·요금 페이지를 따로 읽어야 함

에이전트 온보딩

SocialCrawl

/v1/utility/llms가 llms.txt 코퍼스를 API JSON/마크다운으로 제공

문서 스크래핑 + 경로 추측

문서 페이지를 긁고 드리프트 위험을 감수

정확도

SocialCrawl

요청을 라우팅·과금하는 라이브 레지스트리에서 생성

문서 스크래핑 + 경로 추측

엔드포인트 출시·폐기 시 문서가 쉽게 낡음

탐색 비용

SocialCrawl

카탈로그·가이드·퀵스타트·에이전트 컨텍스트 전부 0 크레딧

문서 스크래핑 + 경로 추측

잘못된 페이지를 읽는 시간과 토큰 비용

자주 묻는 질문

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

문의하기

SocialCrawl 유틸리티 API는 어떤 API인가요?

유틸리티는 레지스트리에서 바로 만들어지는 무료 개발자 경험 엔드포인트 4개를 모아 둔 플랫폼이에요. 전체 420개 엔드포인트 카탈로그, 엔드포인트별 사용법 가이드, 인증·과금을 담은 퀵스타트, AI 에이전트용 llms.txt 컨텍스트를 호출 한 번으로 받아볼 수 있어요.

무료로 호출할 수 있는 유틸리티 엔드포인트는 무엇인가요?

전부 무료예요. /v1/utility/endpoints(카탈로그), /v1/utility/endpoint(사용법 가이드), /v1/utility/quickstart(첫 호출 준비), /v1/utility/llms(에이전트 컨텍스트) 모두 0 크레딧이에요. x-api-key만 있으면 크레딧 걱정 없이 마음 편히 호출할 수 있어요.

AI 에이전트가 유틸리티 API로 스스로 온보딩할 수 있나요?

네, 무료 엔드포인트들이 바로 그 용도예요. API 키를 가진 에이전트라면 /v1/utility/quickstart로 인증과 과금, 에러 규칙을 익히고, /v1/utility/llms로 컨텍스트를 불러오고, /v1/utility/endpoints로 카탈로그를 훑은 다음, 각 항목의 how_to_use 링크를 따라 /v1/utility/endpoint에서 정확한 파라미터를 확인하면 돼요. 문서 페이지를 긁어 올 필요가 없어요.

엔드포인트 카탈로그는 어떻게 정확하게 유지되나요?

요청할 때마다 API 라우터가 쓰는 바로 그 엔드포인트 레지스트리에서 만들어져요. 새 엔드포인트는 출시되는 대로 나타나고, 내려간 엔드포인트는 목록에서 빠지고, 표시된 크레딧 비용은 과금과 일치해요.

첫 호출까지 가장 빠른 방법은 뭔가요?

요청 두 번이면 돼요. GET /v1/utility/quickstart로 규칙과 복사해 쓰는 first_call curl을 받고, 그 curl을 그대로 실행하면 끝이에요. 인증, 응답 봉투, 과금 티어, 에러 코드, 요청 한도가 한 응답에 무료로 들어 있어요.

AI 에이전트가 API 표면을 익힐 수 있는 엔드포인트가 있나요?

네. GET /v1/utility/llms는 llms.txt와 같은 컨텍스트 코퍼스를 마크다운이나 구조화된 JSON으로 API를 통해 돌려줘요. 키가 있는 에이전트가 문서 페이지를 긁지 않고 호출 한 번으로 스스로 부트스트랩할 수 있고, 0 크레딧 무료예요.

Utility API 비용은 얼마인가요?

Utility 엔드포인트는 모두 호출당 0크레딧이에요. 가입하면 100크레딧을 무료로 드리고, 구독 없이 쓴 만큼만 내면 돼요.

Utility 데이터 스크래핑, 법적으로 괜찮을까요?

SocialCrawl은 누구나 볼 수 있는 공개 Utility 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Utility 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.

Utility 스크래핑 API와 공식 Utility API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Utility 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

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

Utility API 레퍼런스 문서 보기

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