SocialCrawl의 새로운 소식
새 플랫폼, 새 엔드포인트, 제품 업데이트를 출시 순서대로 정리했어요. 지금은 플랫폼 65개, 엔드포인트 572개를 지원해요.
2026년 9월
- 개선
Facebook 프로필과 게시물, 댓글이 두 번째 호출 없이 필요한 필드를 돌려줍니다
`GET /v1/facebook/profile/full`은 이미 5크레딧 한 번에 페이지와 게시물을 가져왔는데, 같은 본문의 프로필에 아바타가 있어도 게시물마다 `post.author.avatar_url`이 null이었습니다. 이제 그 페이지가 쓴 글에는 이미 받은 프로필에서 아바타와 페이지 ID가 붙습니다. 공유 글은 원래 작성자를 유지합니다. `GET /v1/facebook/post`는 게시물 목록이 이미 주던 `post.ext.author_id`를 돌려주므로, 게시물을 페이지에 연결하려고 프로필을 한 번 더 부를 필요가 없습니다. `GET /v1/facebook/profile/posts`, `GET /v1/facebook/profile/reels`, `GET /v1/facebook/group/posts`는 `GET /v1/facebook/post/comments`가 이미 받던 `post.ext.feedback_id`를 만들어 주므로 목록에서 바로 댓글로 갈 수 있습니다. 댓글마다 `comment.post_id`와 `comment.ext.reaction_counts`가 붙습니다. `GET /v1/facebook/group`에는 관리자와 모더레이터 목록, 최근 활동, 공개 범위 설명이 포함됩니다. `GET /v1/facebook/profile`은 고유 주소에서 가져온 핸들을 `author.username`에 넣고(`facebook.com/NASA`면 `NASA`), 소스가 주면 `author.verified`와 `author.following`도 채웁니다. `GET /v1/facebook/profile/reels`는 트랙이 있을 때 `post.ext.music.id`와 `post.ext.music.track_title`을 줍니다. 요금은 그대로입니다. 고유 주소가 없는 개인 프로필과 그룹은 username이 여전히 null입니다. 페이지 팔로워 수는 반올림된 표시값이라 게시물마다 정확한 수인 것처럼 복사하지 않습니다.
- 개선
LinkedIn 전체 프로필이 조회 전에 500으로 끊기지 않습니다
`GET /v1/linkedin/profile/full`은 LinkedIn URL마다 500을 돌려줬습니다. 개인이든 회사이든 1초도 안 걸려서, 프로필을 실제로 조회하지 못한 상태였습니다. LinkedIn URL로 부른 `GET /v1/prism/lookup`도 같았습니다. 단건 조회는 정상이었습니다. `GET /v1/linkedin/profile`과 `GET /v1/linkedin/company`는 이미 답을 주고 있었습니다. 이제 전체 프로필도 그 조회와 같은 소스를 씁니다. 9월 8일에 붙인 두 번째 소스도 포함합니다. 앞 소스가 못 주는 호출이 뒤 소스를 시도하기 전에 서버 오류로 끝나지 않습니다. 없는 프로필이나 회사는 예전처럼 찾을 수 없음입니다. 두 소스가 모두 실패하면 예전처럼 502이고 환불됩니다. 요금은 그대로입니다.
- 개선
만료된 Facebook 답글 토큰은 23초짜리 502가 아니라 400입니다
`GET /v1/facebook/post/comment/replies`는 바로 앞의 `/v1/facebook/post/comments` 페이지에서 받은 `feedback_id`와 `expansion_token`을 받습니다. 이 토큰은 만료됩니다. 형식은 맞지만 더 이상 쓸 수 없는 토큰은 약 23초 동안 재시도한 뒤 502를 줬습니다. 장애처럼 보이고 30초 뒤에 다시 시도하라는 안내가 붙었습니다. 토큰 자체가 문제라 재시도는 통하지 않았습니다. 이제는 바로 400을 주고, `expansion_token`을 지목하며, `/v1/facebook/post/comments`의 `comment.ext.expansion_token`에서 새 값을 받으라고 안내합니다. 크레딧은 환불됩니다. 잘린 토큰은 원래부터 400이었고, 없는 댓글은 원래부터 404였습니다. 방금 받은 토큰은 예전처럼 답글 목록을 줍니다. 빈 목록으로 바꾸지 않습니다. 답글이 없는 댓글과, 더 이상 쓸 수 없는 토큰은 다른 답입니다.
- 개선
Instagram 인기 검색이 502로 끊기지 않고, 실패한 릴스 검색도 조회수를 유지합니다
`GET /v1/instagram/search/popular`는 소스 하나로만 돌고 있었습니다. `nike`처럼 잘 되는 검색은 게시물 12개를 줬고, 재생 수는 있고 좋아요 수는 없었습니다. `basketball`처럼 어려운 검색은 약 34초를 기다린 뒤 502를 주고 크레딧을 돌려줬습니다. 이제는 같은 1크레딧 호출 안에서 두 번째 소스로 넘어갑니다. 그 소스가 응답하면 좋아요, 댓글, 조회수가 행에 들어옵니다. 첫 소스가 응답하면 좋아요와 댓글은 그대로 null입니다. 그 표면이 원래부터 그 값을 주지 않기 때문입니다. `GET /v1/instagram/search/reels`는 이미 예비 소스가 있었습니다. 첫 소스는 조회수를 주고, 예전 예비 소스는 주지 않습니다. 첫 소스를 놓친 검색, `top restaurants Leganés`도 포함해서, 좋아요만 있고 조회수는 없는 10개짜리 페이지로 떨어졌습니다. 이제는 그다음 소스도 조회수를 줍니다. 요금은 그대로 1크레딧입니다. 그 검색을 측정한 순회에서는 모든 행에 조회수가 있었습니다. `date_posted`는 날짜 필터를 지킬 수 있는 소스만 쓰고, 날짜를 건 페이지의 조회수는 예전처럼 null입니다. 릴스 검색에는 `country`나 `location` 파라미터가 없습니다. 장소에 태그된 게시물은 `GET /v1/instagram/search/location` 다음에 `GET /v1/instagram/location/posts`입니다. `GET /v1/instagram/similar`의 팔로워 수는 계속 null입니다. 요금은 그대로입니다.
- 개선
YouTube 검색과 채널 조회에서 비어 있던 필드가 채워집니다
`GET /v1/youtube/search?type=channels`는 이름, 핸들, 아바타, URL이 없는 빈 행 20개를 영상으로 표시해 돌려줬습니다. 이제는 채널 이름, 핸들, 아바타, 인증 여부, URL, 구독자 수(`post.ext.author_followers`)를 주고 행을 채널로 표시합니다. 요금은 그대로 1크레딧입니다. 측정한 한 행에는 구독자 218,000이 담겼습니다. `type=playlists`는 재생목록 URL과 영상 수, 소유 채널을 주고 행을 재생목록으로 표시합니다. `GET /v1/youtube/channel/playlists`는 작성자 이름이 View full playlist로 나오던 문제를 고쳤고, 빠지던 행을 유지하며 첫 영상의 썸네일을 붙입니다. 채널이 있는 YouTube 목록은 모두 `post.ext.channel_id`에 채널 id를 실어 줍니다. 재생목록 안 영상도 같습니다. 채널 영상과 쇼츠에는 `post.ext.categoryTitle`로 카테고리가 붙습니다. `GET /v1/youtube/channel`에는 누적 조회수(`author.ext.total_views`)와 가입 시각(`author.ext.joined_at_timestamp`)이 들어갑니다. 측정한 한 채널은 조회수 2,510,027,091이었습니다. `GET /v1/youtube/channel/about`는 이메일 옆에 아바타, 소개, URL, 가입일, 조회수, 키워드, 링크를 같이 줍니다. 공개된 주소가 없으면 여전히 0크레딧이고, 주소가 오면 여전히 25크레딧입니다. 영상 댓글은 두 소스 모두에서 작성자 이름과 영상 id를 줍니다. 요금은 그대로입니다. 영상 행에는 구독자 수가 없습니다. YouTube 영상 목록에 그 값이 없기 때문입니다. 구독자 수는 1크레딧짜리 `GET /v1/youtube/channel`과, 50개당 5크레딧인 `POST /v1/youtube/channels`에 있습니다.
- 개선
Reddit 프로필이 팔로워 수를 돌려주고, 비어 있던 조회가 동작합니다
`GET /v1/reddit/profile`이 공개 팔로워 수를 `author.followers`로 돌려줍니다. 이전에는 모든 계정에서 null이었습니다. 2026년 9월 9일 측정에서 크리에이터 계정 하나는 33899, 팔로워가 없는 계정은 0이었습니다. 0은 값이 빠진 것이 아니라 실제 0입니다. 같은 호출이 프로필 URL을 `author.url`로 돌려주고, `GET /v1/reddit/subreddit/details`는 커뮤니티 URL을 돌려줍니다. `GET /v1/reddit/subreddit` 각 행의 `post.author.display_name`이 프로필이 주는 Reddit 계정 ID와 같아져서, 그 목록에서 사람과 글을 이을 수 있습니다. `GET /v1/reddit/search`를 다음 페이지로 넘길 때 이전 페이지에 이미 있던 글을 다시 과금하지 않습니다. 측정한 2페이지는 25개 중 8개가 겹쳤습니다. `GET /v1/reddit/profile/posts?sort=top`은 인기글 목록을 돌려줍니다. 문서에 있던 그 호출은 빈 페이지였습니다. `GET /v1/reddit/post/transcript`는 `v.redd.it` URL을 받습니다. 이 레인은 자막이 실제로 올 때만 차감합니다. 이 항목의 요금은 그대로입니다.
- 개선
TikTok 지역 조회에 팔로워 수가 붙고, 사운드 영상도 다음 페이지로 넘어갑니다
`GET /v1/tiktok/profile/region`은 그대로 1크레딧이고, 국가 코드도 그대로 줍니다. 이제 같은 호출에서 팔로워, 팔로잉, 게시물, 좋아요 수와 이름, 아바타, 소개, 인증 여부까지 같이 옵니다. 계정 하나를 맞추려고 프로필을 한 번 더 부를 필요가 없습니다. `GET /v1/tiktok/song/videos`의 2페이지는 예전엔 48초쯤 기다리다가 타임아웃이 났습니다. 이제는 다음 페이지가 오고, 더 없으면 빈 페이지가 오며 그때는 크레딧이 나가지 않습니다. `GET /v1/tiktok/post`는 인증된 계정이 예전엔 `verified: false`로 오던 경우가 있었는데, 이제는 `verified: true`로 옵니다. 요금은 그대로입니다. 국가 코드만은 그 소스가 내려가면 빠질 수 있습니다. 나머지 프로필은 그대로 돌려줍니다. 사운드 영상 1페이지는 바뀌지 않았습니다.
- 개선
LinkedIn 프로필과 글, 검색에서 따로 부르던 필드가 같은 호출에 담깁니다
`GET /v1/linkedin/company/insights`가 다시 응답합니다. Microsoft를 포함해 모든 회사에서 not found가 났고, 실제 본문에는 구성원 분포 7개가 들어 있었습니다. 이제 `breakdowns`로 오며 요금은 그대로 5크레딧입니다. `GET /v1/linkedin/post`의 동영상은 재생 시간을 초 단위로 주고, 재생 URL은 `content.media_urls`에 담깁니다. 같은 영상이 여기에서는 161800(밀리초)으로, 동영상 탭에서는 161초로, 피드에서는 null로 오던 불일치가 없어집니다. 기사 공유는 미리보기 이미지와 제목, 출처, URL이 들어 있는 `ext.article`을 줍니다. 회사 글은 `author.username`에 회사 슬러그가 붙고, 팔로워 수는 `ext.author_followers`에 옵니다. `GET /v1/linkedin/post/reposts`의 공유 글에도 고유 링크가 붙습니다. `GET /v1/linkedin/profile`은 가입일과 웹사이트, 국가, 크리에이터 플래그를 줍니다. 이 값들은 각각 5크레딧인 `/profile/about`과 `/profile/contact`를 한 번 더 불러야 했습니다. 글에는 `ext.author_id`, `author_urn`, `author_headline`, `author_type`이 붙어 프로필이나 회사와 다시 부르지 않고 연결할 수 있습니다. 댓글 좋아요 수는 행에 이미 있던 리액션 합계입니다. 응답 모양이 바뀌는 엔드포인트는 두 곳입니다. `GET /v1/linkedin/post/reactions`는 사람 검색과 같은 작성자 목록이고, 리액션 종류는 `author.ext.reaction_type`에 있습니다. `GET /v1/linkedin/search/posts`는 회원 피드와 같은 글 목록이고, 본문은 `content.text`, 수치는 `engagement`에 있습니다. 요금은 그대로입니다. 회원 프로필의 `author.verified`는 이 호출이 값을 주지 않아 null입니다.
- 개선
Instagram 유사 계정에 표시 이름이 들어가고, 게시물 목록에 작성자 ID가 붙습니다
`GET /v1/instagram/similar`이 이제 모든 행에 `author.display_name`을 넣습니다. 이전에는 목록 전체가 그 값이 null이라 사용자 이름만 있고 표시 이름은 없었습니다. 5크레딧 호출은 그대로입니다. 팔로워 수, 팔로잉 수, 게시물 수는 이 목록에서 계속 null입니다. 추천 목록 행에 그 숫자가 없기 때문입니다. 숫자는 `author.username`을 `GET /v1/instagram/profile`에 넘기면 1크레딧에 받을 수 있고, 계정 50개까지는 `POST /v1/prism/profiles`로 묶어 계정당 1크레딧입니다. `GET /v1/instagram/profile/posts`와 `GET /v1/instagram/profile/reels`는 모든 행에 `post.ext.author_id`를 담습니다. 작성자 블록이 빠지던 얇은 행에도 들어갑니다. 핸들을 먼저 찾지 않고 작성자 ID로 프로필을 조회하면 됩니다. 둘 다 1크레딧입니다. `GET /v1/instagram/post/comments`와 `GET /v1/instagram/post/comment/replies`는 요청에 넣은 게시물 주소에서 `comment.post_id`와 `comment.url`을 채웁니다. 이전에는 둘 다 null이었습니다. 공유 수는 5크레딧짜리 `/full` 목록과 `GET /v1/instagram/post/stats`에만 있고, 1크레딧 게시물·릴스 목록에는 없습니다. `engagement.saves`는 Instagram 모든 엔드포인트에서 null입니다.
- 개선
X 계정 검색에 팔로워 수가 붙고, 트윗 행에 작성자 규모가 담깁니다
`GET /v1/twitter/search/users`는 계정 열 개 안팎만 주고, 바이오와 팔로워·팔로잉·트윗 수, 가입일이 전부 null이었습니다. 다음 페이지도 없었습니다. 이제는 한 페이지에 스무 개 안팎의 계정과 그 다섯 필드가 채워져 오고, `pagination.next_cursor`를 `cursor`로 다시 보내 `has_more`가 false가 될 때까지 이어받습니다. 페이지당 1크레딧은 그대로입니다. 측정한 NASA 행에는 팔로워 9,200만, 바이오, 2007년 가입일이 담겼고, 예전에는 전부 null이었습니다. 같은 1크레딧으로 `GET /v1/twitter/search/tweets`, `GET /v1/twitter/user/tweets`, `GET /v1/twitter/user/media`, `GET /v1/twitter/tweet` 행에도 작성자의 팔로워·팔로잉·트윗 수가 `post.ext.author_followers`, `author_following`, `author_posts_count`로 붙습니다. 그 세 숫자를 보려 작성자마다 프로필을 한 번 더 부를 필요가 없습니다. 리트윗 행의 바깥 숫자는 예전처럼 0이고, 원글은 `post.ext.retweeted_post`에 실제 좋아요, 조회 수, 본문 전체, 미디어와 함께 옵니다. 측정한 한 행은 바깥이 좋아요 0에 140자였고, 원글은 좋아요 4,640, 조회 110만, 302자였습니다. `GET /v1/twitter/tweet/replies`에는 답글 작성자의 숫자와 언어, 조회 수, 북마크, 인용 수가 `comment.ext`에 담깁니다. `GET /v1/twitter/profile`은 계정이 위치를 적어 두면 그 위치를 주고, 트윗 단건에는 `post.flags.nsfw`가 옵니다. 요금은 그대로입니다. 두 가지는 그대로 비어 있습니다. `author.likes_count`는 X 호출마다 null입니다. X가 받은 좋아요 합계를 공개하지 않기 때문입니다. 그리고 `GET /v1/twitter/profile/full`은 여전히 5크레딧이고, 트윗 한 페이지 스무 개 안팎으로 평균을 냅니다. `posts=100`은 그 페이지를 자를 뿐 더 깊이 내려가지 않습니다. `trim=true`는 계정 글과 트윗 단건에서 받아 주지만 무시됩니다.
- 개선
Threads 사용자 글을 더 깊게 받고, 계정 검색에서 팔로워 수를 받을 수 있습니다
`GET /v1/threads/user/posts`는 기본 1크레딧에 최근 글 약 15개를 그대로 돌려줍니다. 이 짧은 창에서는 조회수가 null입니다. `limit`를 15보다 크게, 최대 50까지 보내면 같은 피드를 더 깊게 모읍니다. 그 호출에서는 `engagement.views`와 `post.author.display_name`이 채워집니다. 요금은 받은 글 하나당 3크레딧이라, 공개 글이 20개인 계정은 `limit`를 얼마나 올려도 60크레딧입니다. 2026년 9월 9일 `@zuck` 기준으로 기본 호출은 15개, `limit=50`은 최상위 글 32개였고 2025년 9월 25일까지 닿았습니다. `GET /v1/threads/search/users`는 기본 1크레딧에 계정 검색 결과를 그대로 돌려주고, 팔로워 수와 소개글은 null입니다. `include_details=true`를 보내면 같은 행에 `author.followers`와 `author.bio`가 채워지며, 받은 계정 하나당 2크레딧입니다. `GET /v1/threads/post/comments`는 기본 1크레딧에 묶음 창 약 20개를 그대로 줍니다. `limit`를 25보다 크게, 최대 50까지 보내면 1단계 답글을 더 모으고, 받은 답글 5개당 1크레딧입니다. 각 댓글에는 이제 `comment.post_id`가 붙습니다. 이 세 경로는 여전히 커서가 없습니다. `limit`는 한 번에 모으는 값입니다. 팔로잉 수와 게시물 수는 Threads 모든 표면에서 null입니다. Threads가 그 값을 공개하지 않기 때문입니다. 새 파라미터를 보내지 않으면 가격과 응답 형태는 이전과 같습니다. 키워드 검색은 바뀌지 않았습니다.
- 새 엔드포인트
YouTube 크리에이터 연락처 이메일을 25크레딧에, 주소를 받았을 때만 차감합니다
`GET /v1/youtube/channel/about`는 YouTube 채널이 공개한 연락처 이메일을 `author.ext.public_email`로 돌려줍니다. 채널 페이지에는 없고 '정보' 탭의 '이메일 주소 보기'를 눌러야 나오는 주소까지 포함합니다. 채널에 적힌 국가는 `author.ext.country`로 오고, 채널 ID와 핸들, 이름, 구독자 수, 영상 수도 함께 담깁니다. 25크레딧이고, 주소를 실제로 받았을 때만 차감합니다. 공개된 주소가 없는 채널은 0크레딧이고, 존재하지 않는 채널은 404에 차감이 없습니다. 먼저 저렴한 쪽을 확인하세요. `GET /v1/youtube/channel`은 1크레딧이고, 크리에이터가 소개글에 주소를 적어 두면 이미 `author.ext.public_email`을 줍니다. 채널 12개 표본에서 17%가 여기에 해당했습니다. 그 값이 null일 때만 이 엔드포인트를 부르면 됩니다. 작업량을 잡기 전에 두 가지를 알아두세요. 네 채널 중 하나꼴로 주소를 여러 개 공개하는데, 이때는 크리에이터 본인의 업무용 주소일 가능성이 가장 높은 것을 고릅니다. 먼저 찾은 주소를 그냥 쓰거나 무료 메일이 아닌 쪽을 고르지 않습니다. 회사 도메인이 크리에이터가 아니라 외부 대행사인 경우가 많기 때문입니다. 그리고 중소 규모 크리에이터는 대형 채널보다 주소를 훨씬 덜 공개합니다. 받을 이메일 수가 아니라 조회할 채널 수를 기준으로 예산을 잡으세요. 한 번 조회하면 보통 3초쯤 걸립니다. 이 엔드포인트는 소스 두 곳을 읽지만, 몇 곳을 거치든 차감은 한 번입니다.
- 새 플랫폼
중국 숏폼 네트워크 더우인이 추가됐습니다
더우인 엔드포인트 8개가 열렸습니다. 더우인은 틱톡과 별개의 네트워크라 크리에이터도 콘텐츠도 인기 흐름도 다릅니다. 중국 계정이나 쿠키, VPN은 필요하지 않습니다. `GET /v1/douyin/search`는 중국어와 영어, 혼합 질의로 영상을 찾고 정렬, 게시 기간, 영상 길이 조건을 지원합니다. `GET /v1/douyin/profile`은 팔로워 수, 받은 좋아요, 영상 수, IP 지역을 돌려주며 영상을 가져오지 않아 팔로워 추적에 가장 저렴합니다. `GET /v1/douyin/profile/posts`는 업로드 목록을 주고, `exclude_pinned`을 켜면 오래된 고정 영상이 최근 활동을 가리지 않습니다. `GET /v1/douyin/post`는 음악과 해상도, 태그한 장소까지 포함해 영상 하나를 돌려줍니다. `GET /v1/douyin/post/comments`는 최상위 댓글을 건당 1크레딧으로, 작성자 IP 지역과 함께 줍니다. `GET /v1/douyin/comment/replies`는 답글마다 `comment.parent_id`가 붙어 있어 대화를 그대로 복원합니다. `GET /v1/douyin/search/users`는 키워드로 크리에이터를 찾고 팔로워 구간과 계정 유형으로 거릅니다. `GET /v1/douyin/trending`은 실시간 인기 검색 순위 전체를 고정 요금 한 번에 줍니다. 연동 전에 두 가지를 알아두세요. `post.engagement.views`는 항상 null입니다. 더우인이 앱 밖으로 재생 수를 공개하지 않고, 0을 그대로 주면 아무도 보지 않은 영상처럼 읽히기 때문입니다. 좋아요, 댓글, 공유, 저장 수는 모두 실제 값입니다. 그리고 검색은 항상 결과가 옵니다. 더우인은 일치하는 결과가 없다고 답하는 대신 느슨하게 관련된 영상을 내주므로, 목록이 비었는지가 아니라 캡션을 보고 판단하세요. 행 단위로 과금하는 엔드포인트는 실제로 받은 행만큼만 차감됩니다.
- 개선
LinkedIn에서 오류이던 호출이 데이터를 주고, 잘못된 필터는 무료로 거절합니다
LinkedIn 조회 다섯 개 뒤에 소스가 하나 더 붙었습니다. 회원 프로필, 회사 페이지, 경력, 학력, 사람 검색입니다. 앞 소스가 답을 못 주면 같은 형식의 같은 호출을 뒤 소스가 이어서 주고, 어느 쪽이 답했는지는 구분되지 않습니다. 요금은 그대로입니다. LinkedIn 아이디를 받는 필터에 이름을 넣으면 바로, 그리고 무료로 거절합니다. 사람 검색 필터 여섯 개와 채용 검색 필터 하나는 회사·학교·업종 이름을 넣으면 30초 뒤에 다시 시도하라는 오류를 줬고, 요청 형식 자체가 문제라 재시도는 통하지 않았습니다. 이제는 그 아이디를 만들어 주는 호출을 오류에 적어 바로 돌려줍니다. 회사 아이디를 받는 회사 엔드포인트 여섯 곳과 게시물 검색의 날짜·정렬 값도 같은 검사입니다. 없는 프로필이나 회사는 서버 오류가 아니라 찾을 수 없음으로 와서, 재시도 로직이 없는 것과 깨진 호출을 구분할 수 있습니다. 실패한 호출은 예전처럼 환불됩니다. 뒤 소스는 앞 소스가 실패할 때만 돌아가므로, 평소 호출은 예전과 같습니다.
- 개선
Threads 키워드 검색이 입력하신 단어에서 벗어나지 않아요
Threads가 못 알아듣는 문장을 넣으면, 검색어를 더 좁은 검색 여러 개로 풀어서 돌린 뒤 결과를 합쳐 드려요. 그런데 붙어 있는 두 단어 묶음이 떨어지면 그다음으로 한 단어짜리 검색까지 내려갔어요. 한 단어는 문장을 가장 느슨하게 읽는 방식이에요. `cari ai automation`에서 `cari`와 `ai` 각각의 검색이 한 페이지씩 꽉 채워 와서 결과의 3분의 2를 차지했고, 59개 중 41개가 세 단어 중 하나만 걸리거나 아예 안 걸렸어요. 이제는 붙어 있는 두 단어 묶음만 씁니다. 한 단어로 내려가는 건 쓸 수 있는 묶음이 하나도 없을 때뿐이에요. 두 단어짜리 문장이거나, 모든 묶음이 조사·관사를 사이에 두고 있는 경우입니다. 바뀐 뒤 실제로 재 보니 같은 검색어가 59개 대신 20개를 돌려주고, 그중 15개가 입력하신 단어를 둘 이상 담고 있어요. 예전에는 59개 중 15개였습니다. 검색을 넷이 아니라 둘만 돌리니 요금도 3크레딧에서 1크레딧이 됐어요. 같은 기준으로 다른 검색어 두 개는 44%에서 69%로, 37%에서 84%로 올랐습니다. 관련도 높은 글은 그대로 남고, 빠지는 건 한 단어만 걸린 뒤쪽이에요. 그리고 결과를 정렬할 때 아주 짧은 단어가 긴 단어 안에 우연히 들어가도 점수로 세지 않게 했어요. `ai`가 `email`이나 `rain`, `said` 안에서 잡히던 문제예요. 조사를 붙여 쓰는 언어는 예전처럼 그대로 걸립니다. 풀어서 돌리는 검색에도 자체 시간 제한이 생겨서, 위쪽이 느린 순간에도 응답이 끊기지 않고 돌아와요. 찾아오는 양 자체는 그대로예요. Threads가 아예 모르는 문장은 여전히 빈 결과이고 차감도 없으며, `expand=false`도 그대로 문장 그대로만 검색합니다. 한 가지 같이 봐 두시면 좋은 게 있어요. `limit`은 검색 창을 하나씩 차례로 돌려서 글을 모으는데 한 창에 3.4초쯤 걸려요. 크레딧뿐 아니라 시간도 쓰는 값이에요. 캐시가 없을 때 limit 없이 3.5초, `limit=30`은 7.3초, `limit=50`은 10.2초, `limit=100`은 19.5초가 나왔습니다. HTTP 클라이언트가 10초에서 끊는다면 `limit=50` 이상은 안 들어가요. 타임아웃을 늘리시거나, 적게 요청하고 `pagination.next_cursor`로 이어받으세요. 크레딧은 같습니다.
- 새 엔드포인트
Reddit에서 계정과 댓글 본문, 커뮤니티를 읽을 수 있습니다
엔드포인트 여섯 개가 새로 생겼습니다. `GET /v1/reddit/profile`은 계정 하나를 돌려주고, `GET /v1/reddit/profile/posts`는 그 계정이 올린 글을 한 번에 23개쯤 돌려줍니다. `GET /v1/reddit/search/comments`는 글을 검색해서 안쪽까지 읽어 내려가는 대신 댓글 본문을 바로 검색합니다. 한 페이지에 19개쯤 옵니다. `GET /v1/reddit/subreddits/search`는 주제를 넣으면 커뮤니티를 돌려줍니다. 한 페이지에 25개이고, 이제 서브레딧 이름을 미리 알고 시작하지 않아도 됩니다. `GET /v1/reddit/search/media`는 키워드에 걸리는 이미지와 영상 글을 한 페이지에 25개 돌려줍니다. 이 셋은 공용 `cursor`로 이어지고, 측정해 보니 두 번째 페이지가 첫 페이지와 겹치는 행이 하나도 없었습니다. 여기까지 다섯 개는 호출당 1크레딧입니다. 여섯 번째 `GET /v1/reddit/profile/comments`는 먼저 읽어 보고 쓰시는 게 좋습니다. 계정이 직접 쓴 댓글을 최신순으로 돌려주는데, 요금이 돌려받은 댓글 하나당 2크레딧입니다. 측정에서 댓글 25개에 50크레딧이 나갔습니다. 여기의 `limit`은 1에서 100까지 받고 페이지 크기가 아니라 깊이입니다. 숫자를 키우면 한 번의 호출로 더 예전까지 닿고, 속도는 같습니다. 커서는 없습니다. 먼저 1크레딧짜리 `GET /v1/reddit/search/comments?query=author:username`을 써 보세요. 같아 보이지만 검색 색인을 읽기 때문에 관련도순으로 추린 일부만 들어 있습니다. 한 계정에서 재 보니 검색 쪽은 댓글 9개를 주고 멈췄고, 이력 엔드포인트는 60개를 주면서 2021년까지 갔습니다. 표본이 아니라 이력이 필요할 때 이력 엔드포인트로 오시면 됩니다. `limit`보다 댓글이 적은 계정은 그만큼 덜 내고, 없는 아이디는 빈 목록에 차감이 없습니다. 실제로 있지만 댓글을 한 번도 안 쓴 계정도 똑같이 빈 목록입니다. 이 둘은 여기서 구분되지 않으니, 구분이 필요하면 `GET /v1/reddit/profile`을 부르세요.
- 개선
Google Trends가 두 배쯤 빨라졌고, 시간 초과가 드물어졌습니다
`GET /v1/google_trends/explore`와 `GET /v1/google_trends/rising`이 보통 4.6초 안에 답합니다. 변경 뒤 프로덕션에서 과금된 호출 22건을 재서 나온 값입니다. 예전에는 같은 호출이 평균 9초쯤 걸렸고, 일흔 번에 한 번꼴로 시간 제한을 넘겨 48초쯤 뒤에 실패했습니다. 그 실패 경로가 사라진 건 아니고 드물어졌습니다. 좋아진 건 중앙값보다 느린 쪽 꼬리입니다. 영어권의 흔한 키워드는 원래도 빨랐고, 원래 멈춰 서던 건 검색량이 적은 키워드, 미국 밖 지역, 로마자가 아닌 문자로 된 검색어였습니다. 그런 호출이 이제 같은 몇 초 안에 돌아옵니다. 이 두 엔드포인트에서 그 밖에 바뀐 건 없습니다. 파라미터도, 응답 형식도, 5크레딧이라는 요금도, 차감 없는 400과 404도 그대로입니다. 짐작이 아니라 확인했습니다. `timeframe` 여덟 개 값이 모두 예전과 같은 개수의 데이터 포인트를 돌려주고, 키워드를 여러 개 넣은 비교는 여전히 묶음 안에서 정규화되어 값끼리 바로 비교됩니다. 아직 집계 중인 마지막 구간에는 `partial` 표시가 그대로 붙고, `category` 필터도 그대로 걸리며, 지금까지 받아 주던 지역 표기는 전부 그대로 인식됩니다. 검색량이 잡히지 않는 키워드는 여전히 404에 차감이 없고, 지역과 기간은 정상적으로 받아들여졌다는 안내가 함께 오니 원인이 키워드라는 걸 알 수 있습니다.
- 개선
잘못된 경로를 부르면, 맞는 경로를 알려드려요
존재하지 않는 경로를 부르면 지금까지도 요금은 없었지만, 왜 안 되는지는 알려드리지 못했어요. 이제 가장 가까운 실제 경로를 오류 메시지와 `details.did_you_mean` 배열로 같이 드립니다. 코드에서 바로 읽어 쓰실 수 있어요. `/v1/instagram/posts`는 `/v1/instagram/profile/posts`로, `/v1/instagram/user/reels`는 `/v1/instagram/profile/reels`로, `/v1/instagram/hashtag/posts`는 `/v1/instagram/search/hashtag`로 안내합니다. 리소스가 아니라 플랫폼 이름이 다른 경우도 잡아드려요. 저희 Twitter 표면은 `twitter`로 등록되어 있어서, `/v1/x/profile`을 부르시면 이제 `/v1/twitter/profile`을 알려드립니다. 추천은 충분히 가까운 경로가 있을 때만 드립니다. 요금이 나가면서 원하는 답은 주지 않는 엔드포인트로 안내하는 것보다는 아무 말도 하지 않는 편이 낫기 때문이에요. 오류 타입과 404 상태, 요금 0은 그대로라서 이미 처리하고 계신 동작은 달라지지 않습니다.
- 개선
단일 소스로 돌던 Instagram 엔드포인트에 두 번째 소스가 생겼어요
Instagram 엔드포인트 네 개가 각각 소스 하나로만 돌고 있었어요. 그 소스가 흔들리면 그대로 오류가 되었습니다. 이제 같은 호출 안에서 두 번째 소스로 넘어갑니다. 요금도 같고 내려드리는 필드도 같아요. 계정의 국가와 가입 시점, 공개 연락처를 주는 `GET /v1/instagram/profile/about`은 9월 7일에 소스가 월 한도에 걸리면서 아예 응답이 멈췄었는데, 지금은 다시 답하고 공급처 하나가 소진되어도 멈추지 않습니다. 프로필 릴스(`GET /v1/instagram/profile/reels`)는 열여덟 번에 한 번꼴로 서버 오류가 났고, 640개 계정이 영향을 받았어요. 공유 수를 주는 유일한 엔드포인트인 `GET /v1/instagram/post/stats`도 같은 비율로 실패했습니다. 10크레딧짜리 영상 전사(`GET /v1/instagram/media/transcript`)는 예비 소스가 아예 없었고요. 요청과 응답에서 달라지는 건 없습니다. 두 번째 소스는 첫 번째가 실패했을 때만 쓰이고, 필드는 같은 자리에 그대로 들어가고, 가격은 그대로예요. 공유 수는 여전히 게시물 단건 조회에서만 제공되고, `engagement.saves`는 모든 엔드포인트에서 null입니다. Instagram이 저장 수를 어떤 경로로도 공개하지 않기 때문이에요.
- 새 엔드포인트
Reddit 계정 조회, 댓글 검색, 커뮤니티 찾기
Reddit 엔드포인트 여섯 개가 새로 생겼습니다. `GET /v1/reddit/profile`은 계정 정보를 돌려줍니다. 전체 카르마는 `author.likes_count`에, 게시물·댓글·어워드 카르마는 `ext.post_karma`, `ext.comment_karma`, `ext.awardee_karma`에 나눠 담기고, 가입일, 소개, 아바타와 배너, 트로피 수도 함께 옵니다. `GET /v1/reddit/profile/posts`는 그 계정이 올린 글을 커뮤니티를 가리지 않고 돌려주고, 본문과 미디어가 행에 담기며 `ext.subreddit`이 어디에 올라간 글인지 알려줍니다. `GET /v1/reddit/search/comments`는 Reddit 댓글 색인을 바로 검색합니다. 답글 깊숙한 곳에만 나오는 표현도 한 번에 찾을 수 있고, 각 댓글에 원 게시물이 `ext.post_title`, `ext.subreddit`, `ext.subreddit_subscribers`, `ext.post_score`, `ext.post_comment_count`, `ext.post_author`로 함께 붙습니다. `query`에는 Reddit 검색 연산자를 그대로 쓸 수 있습니다. `author:사용자명`으로 한 계정의 색인된 댓글을, `subreddit:이름 검색어`로 커뮤니티 하나만 훑을 수 있습니다. 이 엔드포인트에서 `comment.parent_id`는 null입니다. 값이 빠진 게 아니라, 상위 소스가 그 댓글이 최상위인지 깊은 답글인지 알려주지 않아서 그대로 null로 둡니다. `GET /v1/reddit/subreddits/search`는 주제로 커뮤니티를 찾아줍니다. `author.id`에 서브레딧 이름이 그대로 담기고, 이 값을 `subreddit`, `subreddit/details`, `subreddit/search`의 `subreddit` 값으로 바로 넘기면 됩니다. `GET /v1/reddit/search/media`는 주제에 맞는 이미지·영상·갤러리 게시물을 돌려줍니다. 이 다섯 개는 페이지당 1크레딧, 최대 25개이고 `cursor`로 이어집니다. `GET /v1/reddit/profile/comments`는 계정이 직접 쓴 댓글 이력을 돌려줍니다. 검색 색인보다 훨씬 깊이 들어갑니다. 한 계정에서 25개를 받으면 2022년 7월까지, 60개를 받으면 2021년 6월까지 닿았고 걸린 시간은 비슷했습니다. `limit`이 페이지 크기가 아니라 깊이를 정하는 값이기 때문입니다. 요금은 실제로 받은 댓글 하나당 2크레딧이고 받은 만큼만 차감되니, 요청한 `limit`보다 댓글이 적은 계정은 그만큼 덜 냅니다. 먼저 `GET /v1/reddit/search/comments?query=author:사용자명`을 써 보세요. 페이지당 1크레딧입니다. 다만 이쪽은 검색 색인을 읽어서, 어떤 계정에서는 9개만 나온 반면 이력 엔드포인트는 60개를 돌려줬습니다.
- 개선
서브레딧 안 검색이 한 페이지에 최대 27개까지
`GET /v1/reddit/subreddit/search`는 한 페이지에 7개 정도를 돌려줬습니다. 이제 같은 1크레딧으로 최대 27개까지 돌려주고, 각 행에 담기는 정보도 늘었습니다. 본문은 `ext.selftext`에, 작성자 아바타, 이미지와 영상, 추천 비율, 플레어, Reddit이 붙인 콘텐츠 언어가 함께 옵니다. 앞쪽 행은 지금까지 받던 커뮤니티 순위 그대로이고 순서도 바뀌지 않습니다. 뒤에 붙는 행은 그 커뮤니티로 좁힌 Reddit 검색 색인에서 가져옵니다. 이미 받던 결과는 움직이지 않습니다. 페이지 크기는 호출마다 달라지니 개수를 가정하지 말고 `items` 길이를 읽어주세요. 한 페이지가 색인 두 곳에서 조립되기 때문에 일부 행에만 담기고 나머지는 null인 필드가 세 개 있습니다. `post.flags.spoiler`, `post.engagement.shares`, `post.engagement.saves`입니다. 여기서 null은 그 행을 돌려준 색인이 해당 값을 보고하지 않는다는 뜻이지 false나 0이라는 뜻이 아니니, 합산에 쓰지 마세요. `query`를 빼면 커뮤니티 순위만 7개 정도로 돌아옵니다. Reddit의 범위 검색은 매칭할 검색어가 있어야 하기 때문입니다. `include_body=true`도 그대로 쓸 수 있지만, 이제 본문이 행에 함께 오기 때문에 필요한 경우가 드뭅니다. 그리고 `GET /v1/reddit/search`와 `GET /v1/reddit/subreddit`에서, 상위 소스가 커뮤니티를 확인하지 못한 일부 행의 `post.ext.subreddit`이 빈 문자열 대신 `null`로 바뀝니다. 이 필드로 결과를 묶고 계셨다면 빈 문자열도 유효한 키였기 때문에 그 행들이 이름 없는 커뮤니티 아래 모이고 있었습니다. 이제는 그런 행이 묶이지 않고 빠집니다.
- 새 엔드포인트
LinkedIn 회원이 올린 글 전체를, 페이지 단위로
`GET /v1/linkedin/profile/posts/archive`가 회원이 올린 글을 끝까지 가져옵니다. `limit=100`으로 요청하고 `next_cursor`가 더 오지 않을 때까지 이어서 부르면 됩니다. 커서 없이 페이지가 오면 그 회원이 올린 글을 다 받은 겁니다. 측정으로는 한 프로필에서 열 번 호출에 851개를 받아 2022년 3월까지 닿았고, 글을 훨씬 자주 올리는 프로필에서는 1,800개를 넘겨 2017년까지 갔습니다. 어디까지 거슬러 가는지는 회원마다 다르고, 고정된 숫자로 두고 설계할 값이 아닙니다. 한 페이지에 5초 정도가 걸리고 깊이와 상관없이 같습니다. 마지막 페이지가 첫 페이지와 같은 시간이 걸립니다. 돌아오는 글은 전부 그 회원이 직접 쓴 글입니다. 남의 글을 공유한 항목은 과금하지 않고 빼고 드립니다. 발행 시각이 정확하게 오는 LinkedIn 엔드포인트는 여기뿐이고, 다시 불러도 같은 값이 옵니다. 다른 피드 엔드포인트는 응답하는 순간 상대 시간을 다시 계산해서 내려주기 때문에 값이 흔들립니다. 공유 수가 담기는 것도 여기뿐입니다. 요금은 실제로 받은 글 하나당 5크레딧이고 받은 만큼만 차감됩니다. 요청한 `limit`보다 글이 적은 회원은 그만큼 덜 내고, 찾지 못한 프로필은 차감이 없습니다. `limit`은 1에서 100까지 받습니다. 먼저 `GET /v1/linkedin/profile/posts`를 써 보세요. 5크레딧 정액으로 한 번에 최대 100개를 주고, 대부분의 회원은 그게 전체입니다.
- 개선
TikTok Shop이 스토어 전체와 리뷰 전체를 돌려주고, 상품 형식이 하나로 통일됐습니다
`GET /v1/tiktokshop/search`가 `GET /v1/tiktokshop/products`와 똑같은 상품 객체를 돌려줍니다. 필드 이름과 타입이 같습니다. 예전의 원본 형식에 맞춰 붙여 두셨다면 이건 호환이 깨지는 변경입니다. 데이터는 그대로이고 표준 `product.*` 이름으로 정리됐으며, 검색에서만 나오던 값(판매자 신뢰 등급, 발송지, 프로모션 배지, 카테고리 경로, 데모 영상)은 `product.ext.tiktokshop`으로 옮겼습니다. 한 페이지에서 멈추던 엔드포인트 두 개가 이제 공용 `cursor`로 이어집니다. 상품 20개만 주고 끝이라고 하던 스토어가 전체를 돌려줍니다. 측정으로는 세 페이지에 52개 전부였고, `data.total`에 판매 중 상품 수가 먼저 담겨 옵니다. 상품 리뷰는 수천 개짜리 상품에서도 10개만 주고 끝이라고 했는데, 이제 이어서 받을 수 있고 `data.total`에 전체 리뷰 수가 옵니다. 리뷰를 끝까지 넘기면 404가 나고 크레딧은 차감되지 않습니다. 오류가 아니라 종료 신호입니다. `GET /v1/tiktokshop/product`는 `url` 외에 `product_id`도 받습니다. 리뷰 엔드포인트와 같아졌습니다. 그리고 예전에는 카테고리 이름만 오던 자리에 상품 상세 설명이 담기고, 재고, 할인, 배송비, 도착 예정, SKU 옵션, 상품 사양, 판매자의 지역·평점·누적 판매량이 함께 옵니다. 스토어 상품 목록에는 판매자 이름과 스토어의 평점, 팔로워 수, 지역이 붙습니다. 리뷰의 `language`와 `original_language`는 구매자 국가 코드를 그대로 넣던 것을 멈추고 null이 됐습니다. 국가는 `review.author.location`에 그대로 있습니다. TikTok에 없는 크리에이터 핸들은 빈 목록 대신 404가 나고 크레딧은 차감되지 않으며, 잘못된 `region`은 과금 전에 거절됩니다.
- 새 엔드포인트
Instagram 계정 국가·연락처와 YouTube 채널 링크가 추가됐습니다
`GET /v1/instagram/profile/about`가 추가됐습니다. 1크레딧이고, Instagram의 '이 계정 정보' 패널에 있는 값을 줍니다. 계정이 기반을 둔 국가, 가입한 달, 계정이 공개한 이메일과 전화번호입니다. 국가는 다른 호출에서는 받을 수 없었습니다. 기존 `GET /v1/instagram/profile`에도 전문 카테고리가 담기고, 소개글에 연락처를 적어 둔 계정은 그 주소도 함께 옵니다. `GET /v1/youtube/channel`은 채널 프로필에 올려 둔 링크를 `author.ext.links`로 돌려줍니다. 이미 있던 공개 이메일도 그대로입니다. YouTube 링크 목록은 이 엔드포인트를 담당하는 두 소스 중 하나에서만 오므로, 아직 모든 호출에 붙지는 않습니다.
- 새 엔드포인트
Finance에 가격 이력, 재무제표, 옵션, 종목 뉴스가 추가됐습니다
Finance 읽기가 4개 추가됐고, 경로가 `/v1/google_finance/`에서 `/v1/finance/`로 바뀌었습니다. 예전 경로는 그대로 동작하니 이미 작성한 코드는 고칠 필요가 없습니다. `GET /v1/finance/history`는 일별 OHLCV를 `close`와 `adj_close`로 함께 주고, 배당과 분할은 효력이 생기는 날짜 행에 붙습니다. 기간 전체가 1크레딧입니다. `GET /v1/finance/statements`는 보고 기간별 손익계산서, 재무상태표, 현금흐름표를 5크레딧에 줍니다. 필드 이름은 시세 안의 financials 블록과 같습니다. 한국 종목도 되고, 분기 제표는 원 단위입니다. `GET /v1/finance/options`는 만기 하나의 콜과 풋을 한 목록으로 줍니다. 5크레딧이고 행사가, 매수·매도, 미결제약정, 내재변동성이 담깁니다. `GET /v1/finance/news`는 Google News 검색과 같은 행 형식으로 최근 기사를 1크레딧에 줍니다. 시세, 종목 검색, 시장 개요는 의도적으로 그대로입니다. 제한이 두 가지 있습니다. 가격은 지연되고, 한국·런던·도쿄는 20분, 미국 옵션은 15분입니다. 제표는 공시일이 아니라 회계 기간 종료일 기준이라, 과거 특정 시점에 알려졌던 숫자를 재구성할 수는 없습니다. 상장 폐지 종목은 비어 있고, 재사용된 티커는 지금 그 심볼을 가진 회사로 나옵니다.
- 개선
Reddit 검색 결과가 늘고 댓글이 훨씬 깊어졌습니다
`GET /v1/reddit/search`가 한 페이지에 최대 25건을 돌려줍니다. 이전에는 7건 안팎이었습니다. 행에 담기는 정보도 늘었습니다. 게시물 본문, 작성자 프로필 이미지, 이미지와 영상, 추천 비율, 플레어, Reddit이 붙인 언어 태그가 함께 옵니다. 페이지 건수는 호출마다 다르니 25건으로 고정해 두지 말고 받은 `items` 길이를 확인하세요. `include_body=true`는 그대로 쓸 수 있지만 이제 거의 필요 없습니다. 가져올 본문이 없으면 추가 크레딧은 전액 환불됩니다. 한국어처럼 라틴 문자가 아닌 검색어에 빈 페이지가 오던 것도 이제 결과가 옵니다. 그동안 빈 페이지는 0크레딧으로 환불됐지만, 결과가 오는 만큼 페이지 1크레딧이 차감됩니다. `GET /v1/reddit/post/comments`는 댓글을 약 4배 더, 더 빠르게 돌려줍니다. 한 스레드에서 168건이던 것이 687건이 됐고, 더 큰 스레드에서는 949건과 1,553건이 나왔습니다. 예전 응답과 비교하실 거라면 이 점을 먼저 보세요. 늘어난 응답이 예전 응답을 그대로 포함하지는 않습니다. 큰 스레드에서는 두 응답 모두 일부만 담기고 멈추는 지점이 달라서, 예전 응답에 있던 댓글 중 스레드당 77~103건이 새 응답에는 없습니다. 이제 `data.truncated`가 그 상황을 정직하게 알려줍니다. `next_cursor` 없이 `truncated: true`가 오기도 하는데, 스레드가 완전하지 않지만 이 엔드포인트로는 더 가져올 수 없다는 뜻입니다. 댓글 본문은 Reddit 원문 마크다운으로 옵니다. 예전에는 서식이 지워진 형태였지만 이제 `comment.text`에 `**굵게**`나 `[문구](url)` 같은 마크다운이 들어 있을 수 있습니다. `GET /v1/reddit/post`는 더 안정적으로 응답합니다. 그리고 이 엔드포인트의 `post.engagement.shares`는 이제 크로스포스트 수가 아니라 공유 수입니다. 필드는 그대로이고 지표가 바뀌었습니다.
- 새 플랫폼
미국 의회 주식 거래 공시가 추가됐습니다
미국 의회 주식 거래 공시가 추가됐습니다. 엔드포인트는 19개이고 모두 1크레딧입니다. `GET /v1/us_congress_trades/trades`는 하원과 상원의 STOCK Act 공시를 티커, 의원 성, 정당, 원, 업종, 거래 유형, 날짜로 검색합니다. 각 행에는 의원, 발행사, 티커, 매수/매도/교환, 공시 금액, 날짜, 보고 지연 일수가 있습니다. `GET /v1/us_congress_trades/politician?handle=Pelosi`는 그 의원 요약이고, 같은 handle로 공시 목록을 받습니다. `GET /v1/us_congress_trades/ticker?keyword=AAPL`은 종목 집계입니다. 통계는 정당 합계, 업종, 주요 발행사, 이상 거래, 매수 대비 매도, 늦은 공시자를 다룹니다. AAPL처럼 짧은 티커도 됩니다. 빈 목록과 없는 의원은 환불됩니다.
- 새 플랫폼
Kohl's 상품 검색, 리뷰, Q&A, 매장 찾기가 추가됐습니다
Kohl's가 커머스 커버리지에 추가됐습니다. 엔드포인트는 5개입니다. `GET /v1/kohls/search`는 키워드 결과를 페이지당 12건씩 가격, 이미지, 색, 평점과 함께 반환하며 5크레딧입니다. 추천, 신상품, 가격, 평점, 할인율 순으로 정렬할 수 있습니다. 맞는 결과가 없어도 관련 없는 인기 상품 몇 개가 올 수 있으니 제목을 확인하세요. 상품 상세 엔드포인트는 없습니다. search에서 받은 상품 아이디를 `GET /v1/kohls/reviews`(페이지당 8건, 구매 확인 플래그, 정확한 총수) 또는 `GET /v1/kohls/questions`(구매자 질문과 답변)에 넣습니다. `GET /v1/kohls/stores`는 `lat,lng` 좌표 근처 매장을 찾습니다. 반경은 1~100마일입니다. `GET /v1/kohls/categories`는 1크레딧 참조 목록입니다. 상품과 리뷰 응답 형식은 Amazon, Target, H&M과 같습니다.
- 새 플랫폼
Gumtree 영국 매물, 판매자, 유사 매물, 지역 조회가 추가됐습니다
Gumtree가 중고·분류 광고 커버리지에 추가됐습니다. 엔드포인트는 11개입니다. `GET /v1/gumtree/search`는 영국 매물을 페이지당 22건 안팎으로 넘기며, 가격(GBP), 지역, 카테고리, 판매자 유형(개인/업자)이 담기고 5크레딧입니다. 2페이지는 1페이지와 겹치지 않습니다. `GET /v1/gumtree/product`는 광고 아이디나 gumtree.com URL로 매물 하나를 조회합니다. `GET /v1/gumtree/product/similar`는 유사 매물을 한 페이지로 줍니다. `GET /v1/gumtree/seller`와 `GET /v1/gumtree/seller/listings`는 매물 상세의 `seller_id`와 `public_id`를 둘 다 받습니다. 하나만으로는 안 됩니다. 지역 자동완성과 가까운 지역 조회도 있습니다. 매물 호출은 5크레딧, 인기 검색어·카테고리·필터는 1크레딧입니다. 판매자 리뷰는 이 표면에 없습니다.
- 새 플랫폼
AliExpress 상품, 검색, 유사 상품, 리뷰, 배송이 추가됐습니다
AliExpress가 커머스 커버리지에 추가됐습니다. 엔드포인트는 9개입니다. `GET /v1/aliexpress/product`는 숫자 아이디나 aliexpress.com/item URL로 상품 하나를 조회합니다. 제목, 판매가, 원래 가격, 상점 이름, 이미지, 판매 수, 카테고리가 담기고 5크레딧입니다. 상품 설명은 이 표면에 없습니다. 없는 상품이거나 요청한 국가로 팔지 않는 상품은 404이고 과금되지 않습니다. `GET /v1/aliexpress/search`는 키워드 결과를 기본 페이지당 10건(최대 50건)으로 넘기며 정렬과 가격 필터를 받습니다. `GET /v1/aliexpress/reviews`는 작성된 리뷰를 넘깁니다. 유사 상품, SKU 배송 정보, 인기 상품, 프로모션도 있습니다. 카탈로그 호출은 5크레딧, 카테고리와 프로모션 이름 목록은 1크레딧입니다.
- 새 플랫폼
Klarna 쇼핑 상품, 판매자 가격, 리뷰, 가격 이력이 추가됐습니다
Klarna가 커머스 커버리지에 추가됐습니다. 쇼핑 지역 13곳, 엔드포인트 18개입니다. `GET /v1/klarna/product`는 아이디나 쇼핑 URL로 상품 하나를 조회합니다. 제목, 설명, 브랜드, 평점, 사양이 담기고 5크레딧입니다. 이 응답에는 판매가가 없습니다. 판매자 가격은 `GET /v1/klarna/product/offers`에 있습니다. `GET /v1/klarna/search`는 키워드에 맞는 상품 20건을 한 페이지로 주며 커서가 없고 5크레딧입니다. 맞는 결과가 없으면 빈 페이지가 오고 과금되지 않습니다. 리뷰, 전문가 리뷰, 리뷰 요약, 가격 이력, 상품 비교도 있습니다. 카테고리 탐색, 카테고리 분류, 매장, 매장 카탈로그가 나머지를 채웁니다. 카탈로그 호출은 5크레딧, 참조 목록(자동완성, 카테고리, 매장, 필터)은 1크레딧입니다.
- 개선
Instagram 릴스 검색 페이지네이션이 깔끔하게 끝납니다
`GET /v1/instagram/search/reels` 페이지네이션이 다른 엔드포인트와 같은 방식으로 끝납니다. 지금까지는 결과 끝에 닿으면 404가 돌아와서, `pagination.has_more`를 따라 도는 반복문이 정상 종료가 아니라 오류로 끝났습니다. 이제 마지막 페이지는 `200`과 빈 `items` 배열, `has_more: false`를 돌려주고 크레딧도 차감되지 않습니다. 검색 결과가 아예 없을 때도 같습니다. 404 대신 빈 목록이 오니 상태 코드로 분기하지 말고 `items.length`를 확인하세요. 페이지를 넘길 때 알아두면 좋은 점이 두 가지 있습니다. 날짜 필터를 건 검색은 대상 풀이 훨씬 작아서 페이지당 10개 안팎으로 몇 페이지면 끝납니다. `date_posted`를 빼면 페이지당 30개에 훨씬 더 깊이 들어갑니다. 그리고 같은 순회에서 이미 받은 릴스만 담긴 페이지는 0크레딧으로 비어서 올 수 있는데 이건 끝이 아니니 `has_more`가 true인 동안 계속 넘기면 됩니다.
- 새 엔드포인트
Tripadvisor 호텔·음식점·관광지·크루즈가 추가됐습니다
Tripadvisor 엔드포인트가 2개에서 16개가 됐습니다. 모두 1크레딧입니다. `GET /v1/tripadvisor/place`는 Tripadvisor URL 하나로 장소를 찾아줍니다. `url_path`가 생각한 그 업체를 가리키는지 확인할 때 가장 빠릅니다. 호텔, 음식점, 관광지는 검색과 상세를 각각 지원하며 필터도 따로 있습니다. 호텔은 가격대·등급·숙소 유형, 음식점은 요리·식사 시간·가격대·식이 조건, 관광지는 분류·소요 시간·최소 평점입니다. 음식점, 관광지, 크루즈 선박은 리뷰 엔드포인트를 각각 갖습니다. `GET /v1/tripadvisor/autocomplete`는 입력한 이름을 실제 장소로 바꿔주고, `GET /v1/tripadvisor/experience-types`는 지역의 액티비티 분류를 유형별 개수와 함께 반환합니다. 두 가지만 알아두세요. 호텔 검색 결과에는 별점과 리뷰 수가 없어서 그 값이 필요하면 `GET /v1/tripadvisor/hotel`로 이어서 받아야 합니다. 관광지와 크루즈 리뷰에는 업체 답글과 리뷰별 링크가 없습니다.
- 개선
Tripadvisor 리뷰가 약 4배 빨라졌습니다
`GET /v1/tripadvisor/reviews` 응답이 약 1.1초로 줄었습니다. 같은 업체에 같은 요청을 보냈을 때 이전에는 약 5.2초였습니다. 가격, 파라미터, 응답 형식은 그대로이고 필터를 건 요청은 동작이 전혀 바뀌지 않습니다. 배포 전에 확인하실 필드가 두 개 있습니다. `review.helpful_votes`는 이제 값이 담깁니다. 이전에는 항상 비어 있었습니다. `review.author.location`은 필터 없는 요청에서 비어서 옵니다. 빨라진 경로가 이 값을 제공하지 않기 때문입니다. 이 필드를 쓰고 계신다면 `sort_by`, `rating`, `visit_type`, `search_reviews_keyword`, `translate` 중 하나를 함께 보내시면 예전처럼 값이 담겨서 옵니다.
- 새 엔드포인트
Yelp 검색·전체 검색·자동완성이 추가됐습니다
Yelp 엔드포인트가 5개가 됐습니다. `GET /v1/yelp/search`와 `GET /v1/yelp/search/full`은 필수 `query`와 `location`에 선택 `sort`(`recommended`, `rating`, `review_count`), `ads`, `cursor`를 받으며 1크레딧입니다. `GET /v1/yelp/search/suggestions`는 `query`와 `location`으로 자동완성 행(카테고리, 일반, 체인, 비즈니스)을 반환합니다. 비즈니스 제안 URL은 별칭이라 `GET /v1/yelp/business/info`에서 조회되지 않습니다. 검색이 총건수는 있는데 행이 없으면 호출은 실패하고 환불됩니다.
- 새 플랫폼
Yelp 비즈니스 정보와 리뷰가 추가됐습니다
Yelp가 리뷰 커버리지에 추가됐습니다. 엔드포인트는 2개입니다. `GET /v1/yelp/business/info`는 22자 encid로 비즈니스 하나를 조회합니다. 이름, 반올림하지 않은 별점, 정확한 리뷰 수, 가격대, 주소, 좌표, 카테고리, 사진, 시간대가 담기며 1크레딧입니다. prince-street-pizza-new-york-2 같은 별칭 슬러그는 404이고 과금되지 않습니다. `GET /v1/yelp/business/reviews`는 고객 리뷰를 페이지당 10건씩 커서, 사장님 답글, 사진, HELPFUL 표와 함께 넘기며 5크레딧입니다. 2페이지는 1페이지와 겹치지 않습니다. 검색은 이 표면에 없습니다. 장소와 리뷰 응답 형식은 Tripadvisor와 같습니다.
- 새 플랫폼
H&M 상품 검색, 매장 목록, 공급 공장 정보가 추가됐습니다
H&M이 커머스 커버리지에 추가됐습니다. 엔드포인트는 6개입니다. `GET /v1/hm/search`는 키워드 결과를 페이지당 36건씩 가격, 이미지, 색, 사이즈, 재고와 함께 반환하며 5크레딧입니다. 관련도, 신상품, 가격순으로 정렬할 수 있습니다. `language`로 카탈로그를 바꿉니다(`en_us`가 기본이고 `en_gb`, `de_de`, `fr_fr`을 받습니다). 맞는 결과가 없으면 빈 페이지가 오고 과금되지 않습니다. `GET /v1/hm/search/suggestions`는 자동완성 검색어를 줍니다. `GET /v1/hm/stores`는 국가의 매장을 전부 줍니다. `query`에 `us`, `gb`, `de`를 넣으면 주소, 좌표, 영업시간이 담깁니다. `GET /v1/hm/countries`와 `GET /v1/hm/categories`는 1크레딧 참조 목록입니다. `GET /v1/hm/product/suppliers`는 search에서 받은 상품 아이디의 생산 국가, 공장 이름, 근로자 수 구간을 줍니다. 상품 응답 형식은 Amazon, Target, Etsy와 같습니다. 상품 상세 엔드포인트는 이 표면에 없습니다.
- 새 플랫폼
Sephora 상품, 리뷰, 검색, 매장 재고가 추가됐습니다
Sephora가 커머스 커버리지에 추가됐습니다. 엔드포인트는 11개입니다. `GET /v1/sephora/product`는 P번호나 sephora.com/product URL로 미국 상품 하나를 조회합니다. 제목, 브랜드, 설명, 가격, 평점, 이미지, 성분, 재고가 담깁니다. `GET /v1/sephora/reviews`는 작성된 리뷰를 페이지당 10건씩 정확한 전체 개수와 함께 넘깁니다. `GET /v1/sephora/search`는 키워드 결과를 페이지당 60건씩 넘기며, 2페이지는 1페이지와 겹치지 않습니다. 맞는 결과가 없으면 빈 페이지가 오고 과금되지 않습니다. 카테고리 탐색, 브랜드 카탈로그, 최상위 카테고리, 브랜드 목록, 매장 찾기, SKU별 매장 재고도 있습니다. 상품 응답 형식은 Amazon, Target, Etsy와 같습니다. 카탈로그 호출은 5크레딧, 참조 목록(카테고리, 브랜드, 자동완성, 매장)은 1크레딧입니다. 유럽 엔드포인트는 없습니다. 시험한 호출마다 실패했습니다.
- 개선
쓰지 않는 쿼리 파라미터는 다시 무시돼요. 예전에 쓰시던 요청이 그대로 동작해요
2026년 8월 31일부터 엔드포인트에 없는 쿼리 파라미터가 들어오면 크레딧 없이 400으로 거절했어요. 철자를 틀린 경우(`?limitt=10`이면 `limit`을 알려 드려요)는 그대로 도움이 돼요. 다만 한 엔드포인트의 파라미터를 다른 호출에 그대로 붙이던 요청까지 깨졌어요. `GET /v1/instagram/post/stats`의 `region`, `GET /v1/facebook/post`의 `trim`, `GET /v1/tiktok/profile`의 `cache`, Instagram 목록 호출의 `limit`이 그 예예요. 이런 여분 파라미터는 2026년 8월 31일 이전처럼 다시 무시해요. 업스트림으로 전달되지 않고, 요금도 나가지 않으며, 캐시 키에도 들어가지 않아요. 그 엔드포인트가 실제로 쓰는 파라미터의 이름을 잘못 쓴 경우에는 예전처럼 크레딧 없이 400을 주고, 어떤 이름을 쓰려 했는지 제안해요. `handle` 자리에 `username`을 보내도 되고, Instagram은 `url` 자리에 `shortcode`를 받아 `/p/` 주소로 바꿔 주고, 릴스 검색의 `date_posted=last-day`는 지금 소스가 받는 가장 가까운 값인 `last-week`로 넣어 드리고, 경로에 캡션 슬러그가 붙은 Facebook 게시물 URL도 다시 통과해요.
- 개선
Instagram 팔로워 목록이 끝까지 이어지고, 게시물 id도 정확한 값으로 돌아와요
Instagram 관련 수정 여러 건을 함께 반영했어요. 팔로워와 팔로잉 목록이 이제 중간에 끊기지 않아요. 목록을 넘기는 도중에 잠깐 제한이 걸리면 빈 페이지가 `has_more: false`와 함께 돌아와서, 큰 계정은 수천 명이 빠진 채로 목록이 끝난 것처럼 보였어요. 이제 그 페이지는 같은 커서로 다시 요청하고, 그래도 안 되면 목록이 끝났다고 하는 대신 크레딧을 돌려드리는 오류로 알려드려요. 없는 계정을 `GET /v1/instagram/followers`나 `GET /v1/instagram/following`에 넣으면 예전에는 빈 목록이 담긴 200이 왔는데, 이제는 크레딧이 나가지 않는 404 `RESOURCE_NOT_FOUND`가 오고 `details.reason`에 `handle_unresolved`가 담겨요. 계정 기준으로 목록을 주는 다른 플랫폼 엔드포인트도 계정이 없다고 확인되면 같은 `details` 블록을 돌려드려요. `profile/reels`, `tagged`, `stories`의 `post.id`가 이제 정확한 19자리 미디어 id예요. 그동안은 모든 행에서 끝 두세 자리가 반올림돼 있었고, `tagged`는 2페이지가 1페이지를 그대로 반복했어요. 이 세 엔드포인트에서 저장해 두신 id가 있다면 다시 받아서 맞춰 주세요. `profile/posts`, `search/hashtag`, `location/posts`는 원래 정확했고 바뀌지 않아요. `profile/posts`와 `profile/reels`에 `trim=true`를 붙이면 빈 페이지가 오면서 요금은 그대로 나가던 문제도 고쳤어요. 이제 전체 목록이 그대로 오고, `post.ext.coauthors`가 빠지고 `post.flags.pinned`가 null이 되는 것 말고는 달라지는 게 없어요. `GET /v1/instagram/search/hashtag`는 `type=recent`일 때만 페이징돼요. 기본값인 `top`과 `clips`는 순위대로 정리된 한 페이지로 끝나서 `has_more: false`로 돌아오고, 커서를 보내실 때는 같은 `type`을 함께 보내 주세요. `GET /v1/instagram/search/reels`의 `date_posted`는 `last-week`, `last-month`, `last-year` 세 값을 받아요. `last-day`와 `last-hour`는 2026년 8월 26일 무렵부터 더 이상 제공되지 않아서, 이제는 호출하기 전에 크레딧 없이 거절하고 쓸 수 있는 세 값을 오류 메시지로 알려드려요. 예전에는 호출이 한 번 나간 뒤에야 일반적인 오류로 돌아왔어요. `GET /v1/instagram/profile/reels/full`은 공유 수를 모으는 데 드는 호출이 페이지당 훨씬 줄었고, `X-Upstream-Retries` 헤더가 이제 추가로 나간 호출을 전부 세요. 예전에는 열 번 넘게 호출하고도 0으로 표시됐어요. 응답이 비어 있는데 이유를 알 수 없는 경우도 이제 빈 목록으로 돌려드리지 않아요. 일시 오류로 보고 다시 시도한 뒤, 그래도 안 되면 크레딧을 돌려드리는 502로 알려드려요. 추천 아이디 검색처럼 결과가 진짜 없는 경우는 여전히 200이에요. 없는 게시물이나 프로필이 502로 보이던 경우도 크레딧이 나가지 않는 404로 바로잡았고, Prism 조합 엔드포인트도 없는 계정을 만나면 더 찾아보지 않고 바로 멈춰요. 없는 계정을 `profile`로 조회할 때 404도 더 빨리 돌아와요.
- 개선
Facebook 댓글 답글이 실제로 돌아오고, 자주 쓰는 호출은 주 소스가 죽어도 이어져요
`GET /v1/facebook/post/comment/replies`는 답글이 있는 댓글에도 빈 목록을 돌려줬어요. 이제 답글이 실제로 와요. `GET /v1/facebook/post/comments`도 같은 경로예요. 요금과 응답 형식, 파라미터는 그대로예요. 페이지당 1크레딧이고, 커서도 같고, 없는 게시물은 예전처럼 404예요. 그리고 호출이 많은 Facebook 엔드포인트 네 개, `GET /v1/facebook/post`, `GET /v1/facebook/profile`, `GET /v1/facebook/profile/posts`, `GET /v1/facebook/profile/reels`는 주 소스가 응답하지 못하면 백업 소스로 넘어가요. 한꺼번에 멈추지 않고 계속 답이 와요. 이번 변경으로 새 Facebook 엔드포인트는 추가되지 않았어요.
- 새 플랫폼
Quora 질문·답변·프로필·스페이스·토픽 검색이 추가됐어요
Quora가 새 플랫폼으로 추가됐어요. 엔드포인트 7개이고 모두 5크레딧이에요. `GET /v1/quora/search`는 키워드로 질문을 찾아 제목, URL, 답변 수, 팔로워 수, 게시 시각을 돌려줘요. `GET /v1/quora/answers`는 작성자 소개, 추천 수, 원 질문과 함께 답변 본문을 줘요. `GET /v1/quora/posts`, `GET /v1/quora/profiles`, `GET /v1/quora/spaces`, `GET /v1/quora/topics`는 같은 방식으로 스페이스 게시물, 프로필, 스페이스, 토픽을 검색해요. `GET /v1/quora/post`는 질문 URL 하나로 해당 질문을 조회해요. 검색은 한 페이지에 최대 10건이고, `time`으로 기간을 줄일 수 있어요. `all`, `hour`, `day`, `week`, `month`, `year`예요. 커서는 없어요. 다른 결과를 보려면 검색어나 기간을 바꿔 주세요.
- 새 플랫폼
G2 소프트웨어 제품, 리뷰, 카테고리, 판매자가 추가됐어요
G2가 새 플랫폼으로 추가됐어요. 엔드포인트 7개예요. `GET /v1/g2/product`는 슬러그 또는 G2 URL로 소프트웨어 제품 하나를 돌려줘요. 별점, 리뷰 수, 카테고리, 판매자, 요금제, 기능, 대체재가 담기고 5크레딧이에요. `GET /v1/g2/reviews`는 작성된 리뷰를 한 페이지에 10건씩 줘요. 별점, 기업 규모, 산업, 역할, 지역으로 걸러 볼 수 있고 역시 5크레딧이에요. `GET /v1/g2/category`는 카테고리 안 제품을 한 페이지에 15개씩 나열하고, `GET /v1/g2/categories`는 카테고리 분류 전체를 한 번에 주며 1크레딧이에요. `GET /v1/g2/seller`와 `GET /v1/g2/seller/products`는 판매자 프로필과 제품 목록이에요. `GET /v1/g2/product-index`는 제품 URL 목록을 한 페이지에 100개씩 나눠 줘서, 그 슬러그를 product나 reviews에 넣으면 돼요. 제품과 리뷰 응답 형식은 다른 커머스 플랫폼과 같아요.
- 새 플랫폼
LinkedIn, Indeed, Bing, Xing 채용 검색과 연봉 조회가 추가됐어요
Jobs는 새 플랫폼이고 엔드포인트 11개예요. 이미 쓰고 계신 LinkedIn 채용 엔드포인트를 바꾸는 게 아니에요. `GET /v1/linkedin/search/jobs`와 `GET /v1/linkedin/job`은 그대로예요. 이 면은 채용 게시판 네 곳과 연봉 조회를 더해요. `GET /v1/jobs/linkedin/search`, `GET /v1/jobs/indeed/search`, `GET /v1/jobs/bing/search`, `GET /v1/jobs/xing/search`는 키워드와 지역으로 공고를 검색하고, 기간·고용 형태와 게시판별 필터를 받아요. 페이지당 10크레딧이에요. 각각 짝이 되는 상세 엔드포인트가 있고 5크레딧이에요. `GET /v1/jobs/linkedin/organizations`는 회사 이름을 아이디로 바꿔 LinkedIn 검색의 `organization_ids`에 넣을 수 있게 해 줘요. `GET /v1/jobs/salary/titles`는 직함 후보를 주고, `GET /v1/jobs/salary`는 직함과 국가의 최저·최고·평균·중앙 연봉을 줘요. 조직과 연봉 조회는 1크레딧이에요. 검색은 커서로 페이지를 넘기고, Indeed는 1페이지에 `country_code`가 필요해요.
- 새 플랫폼
Etsy 리스팅, 샵 카탈로그, 유사 상품, 검색 제안이 추가됐어요
Etsy가 커머스 커버리지에 추가됐어요. 엔드포인트 4개이고 모두 5크레딧이에요. `GET /v1/etsy/product`는 숫자 아이디나 etsy.com/listing URL로 리스팅 하나를 줘요. 제목, 설명, 가격, 이미지, 샵 이름, 재고가 담겨요. `GET /v1/etsy/shop/products`는 샵 카탈로그를 한 페이지에 36개씩 커서로 넘겨요. 원본이 알려 주는 전체 개수가 페이지 크기와 같아서 응답에는 넣지 않았고, 짧은 페이지가 올 때까지 넘기면 돼요. `GET /v1/etsy/product/similar`는 Etsy가 비슷하다고 보는 리스팅을 보통 12개 안팎, 한 페이지로 줘요. `GET /v1/etsy/search/suggestions`는 일부만 입력한 검색어의 자동완성 목록이에요. 상품 응답 형식은 Amazon, eBay와 다른 쇼핑몰과 같아요. 키워드로 리스팅을 검색하는 엔드포인트와 리뷰는 없어요. 검색은 시험한 쿼리마다 실패했고, 리뷰는 리뷰가 수천 개인 리스팅에서도 빈 목록이 왔거든요.
2026년 8월
- 개선
Threads 검색이 긴 문장으로 검색해도 결과를 돌려드려요
Threads는 입력하신 단어를 하나씩 따져보는 대신, 이미 알고 있는 토픽 태그와 검색어를 통째로 맞춰봐요. 그래서 못 알아듣는 긴 문장을 넣으면 결과가 조금 줄어드는 게 아니라 아예 0개로 돌아왔어요. 키워드 개수 제한은 원래 없었어요. `machine learning engineer`는 한 페이지가 꽉 차서 오는데 `the best coffee`는 하나도 안 왔거든요. 실제 검색어들로 재보니 세 단어는 여섯 번 중 네 번, 다섯 단어는 여섯 번 중 다섯 번, 여덟 단어는 재본 전부가 빈 결과였어요. 이제 `GET /v1/threads/search`가 이 부분을 알아서 처리해요. 입력하신 문장 그대로 검색해서 결과가 없으면, 붙어 있는 두 단어씩 묶어 여러 검색으로 나눈 뒤 동시에 돌리고, 중복을 걸러 하나의 목록으로 합쳐 드려요. 순서는 입력하신 단어를 많이 포함한 게시물이 앞에 오도록 정렬돼요. 2026년 8월 31일 기준으로 `best coffee machine for a small office`는 0개에서 75개로, `cari vendor mesin kopi jakarta`는 0개에서 56개로 늘었어요. 요금은 나눠서 돌린 검색 중에 결과가 있었던 것만 1크레딧씩 계산하고, 빈 검색에는 크레딧이 나가지 않아요. 그래서 이 엔드포인트의 크레딧 범위가 1~7에서 1~11로 바뀌었어요. 원래 잘 되던 검색어는 나누지 않으니 예전처럼 정확히 1크레딧이에요. 두 가지만 알아두시면 좋아요. 나눠서 검색한 응답은 한 페이지로 끝나고 커서가 없어요. 커서를 쓰면 결과가 없던 그 문장을 다시 검색하게 되기 때문이에요. 그리고 `data._warnings`에 어떤 검색어로 나눠 돌렸는지 항상 적어드리니 무엇을 검색했는지 확인하실 수 있어요. 문장 그대로만 검색하고 싶으시면 `expand=false`를 보내주세요.
- 개선
잘못 쓴 파라미터는 바로 알려드리고, 안 돌던 예약 실행이 이제 돌아가요
파라미터 이름을 잘못 쓰면 예전에는 그냥 무시됐어요. `?limitt=10`처럼 보내면 limit이 빠진 채로 검색이 돌아가고, 원하지 않던 결과에 요금만 나갔죠. 이제는 모르는 파라미터가 들어오면 크레딧이 나가지 않는 400으로 어떤 파라미터가 문제인지, 아마 이걸 쓰시려던 게 아닌지까지 알려드려요. 코드로 처리하실 수 있게 `error.unknown_parameters`와 `error.suggestions`에도 같은 내용이 담겨요. `?limitt=10`을 보내시면 `limit`을, `?curser=`를 보내시면 `cursor`를 제안해 드려요. 값이 비어 있는 파라미터는 예전처럼 안 보낸 것으로 처리하니, 빈 쿼리스트링을 붙여 보내시던 코드는 그대로 두셔도 돼요. 그리고 예약해 둔 Monitor 실행과 코호트 쿼리가 등록만 되고 실제로는 안 돌던 문제를 고쳤어요. 작업 큐가 콜론이 들어간 중복 방지 아이디를 거부하는데 저희 키가 콜론으로 구분돼 있어서, 등록이 실패하고 대기 상태에 머문 채로 크레딧만 잡혀 있었어요. 이제 큐에 넘기기 전에 아이디를 해시로 바꿔서 항상 유효한 값이 되도록 했고, 예약한 실행이 정상적으로 돌아가요. 오류 응답의 요금 표시도 더 정확해졌어요. 5xx가 나면 `credits_used`에 실제로 확정된 금액이 담기고, 즉시 환불이 안 되는 경우에는 환불했다고 표시하는 대신 정확한 보정을 예약해 둬요.
- 새 엔드포인트
TikTok 엔드포인트 8개가 새로 추가됐고 목록도 훨씬 길어졌어요
TikTok에 엔드포인트 8개가 새로 생겼어요. 모두 1크레딧이에요. `GET /v1/tiktok/profile/playlists`는 계정이 만들어 둔 재생목록을, `GET /v1/tiktok/playlist/videos`는 그 재생목록 안의 영상을 순서대로 돌려드려요. `GET /v1/tiktok/user/liked`는 계정이 좋아요를 누른 영상을 최신순으로 한 페이지에 30개씩 줘요. 이 목록은 숨겨 둔 계정이 많은데, 숨겨져 있으면 크레딧이 나가지 않는 404로 돌아와요. `GET /v1/tiktok/location/posts`는 특정 장소에 태그된 공개 영상을 모아요. `GET /v1/tiktok/effects`는 아이디로 카메라 효과를 찾고, `GET /v1/tiktok/effect/videos`는 그 효과로 만든 영상을 돌려드려요. `GET /v1/tiktok/search/music`은 키워드로 사운드를 찾는데, 각 결과의 `ext.dsp_ids`에 같은 곡의 Apple Music, Spotify, Amazon 트랙 아이디가 함께 담겨요. `GET /v1/tiktok/hashtag`는 해시태그에 대한 TikTok 자체 기록을 누적 조회수까지 돌려드려요. 태그 이름만 주시면 아이디는 저희가 찾아드려요. 이미 쓰고 계신 목록도 길어졌어요. 팔로워와 팔로잉은 한 페이지에 최대 150명까지 담겨요. 특히 `GET /v1/tiktok/user/following`은 이번에 처음으로 제대로 페이징돼요. 지금까지는 20명 안팎만 주고 커서가 없어서 더 볼 방법이 없었는데, 이제 한 번에 최대 149명을 돌려주고 응답 루트의 `pagination` 블록으로 끝까지 따라갈 수 있어요. `GET /v1/tiktok/video/comment/replies`는 답글을 6개씩 주던 것이 한 페이지에 최대 50개로 늘었어요. 필터 없는 `GET /v1/tiktok/search`는 10개가 아니라 30개를 주고, 기간과 정렬, 지역 필터도 이제 실제로 적용돼요. 필터를 걸면 조건에 맞는 결과가 최대 30개까지 담겨요. `GET /v1/tiktok/search/top`도 한 페이지 최대 30개로 맞춰졌어요. 검색 결과에는 작성자의 팔로워 수가 `post.ext.author_followers`로 붙고, 게시물에는 정확한 저장 수와 새로 생긴 `post.ext.download_count`로 다운로드 수가 담겨요. 연동하시기 전에 알아두시면 좋은 변화가 두 가지 있어요. 계정 주인이 팔로워나 팔로잉 목록을 숨겨 둔 경우, 예전에는 빈 목록이 담긴 200이 왔지만 이제는 확실한 404가 와요. 한 번 더 호출하지 않아도 숨긴 목록인지 비어 있는 목록인지 구분할 수 있고, 이 404에는 크레딧이 나가지 않아요. 그리고 연령 제한처럼 시청자 제한이 걸린 계정도 `GET /v1/tiktok/profile`에서 프로필 전체가 돌아와요. 예전에는 404라서 무료였지만, 이제 데이터를 돌려드리기 때문에 다른 요청과 같이 1크레딧이 나가요.
- 새 엔드포인트
Amazon 베스트셀러·딜·판매자 프로필과 온페이지 SEO 감사가 열렸어요
`GET /v1/amazon/best-sellers`는 카테고리 베스트셀러 차트입니다. `type`으로 New Releases나 Movers and Shakers로 바꿀 수 있습니다. `GET /v1/amazon/deals`는 현재 Amazon 딜과 딜 가격, ASIN을 줍니다. `GET /v1/amazon/seller`는 판매자 id로 프로필을 조회합니다. `GET /v1/google_shopping/price-history`는 product-search의 product_id로 스토어별 날짜-가격 이력을 줍니다. 새 플랫폼 `GET /v1/on_page/page`는 URL 하나의 기술 SEO 감사(제목, 메타, 점검, 점수, 타이밍)를 1크레딧에 돌립니다. Costco 검색은 아직 플랫폼이 아닙니다. 상품 상세가 벤더가 준 item_number에서도 404입니다.
- 새 엔드포인트
X 엔드포인트 7개가 새로 열렸어요
`GET /v1/twitter/user/tweets`가 이제 계정의 타임라인을 최신 상태 그대로, 시간 역순으로 돌려드려요. 프로필의 게시물 탭과 같은 구성이고, 고정 트윗은 `post.flags.pinned`로 표시돼요. 페이징도 진짜 커서로 바뀌었어요. `pagination.next_cursor`를 `cursor`로 다시 보내면 원하시는 만큼 깊이 내려갈 수 있고, 페이지마다 1크레딧이에요. 전에는 첫 페이지에서 끝났거든요. 여기에 엔드포인트 7개가 새로 열렸어요. 모두 페이지당 1크레딧이에요. `GET /v1/twitter/search/tweets`는 키워드나 문구로 트윗을 검색해요. 한 페이지에 스무 개 안팎이고, 기본은 최신순(`sort=latest`), `sort=top`을 주면 인기순이에요. `GET /v1/twitter/tweet/replies`는 트윗에 달린 답글을, `GET /v1/twitter/tweet/retweeters`는 그 트윗을 리트윗한 계정 목록을 돌려드려요. `GET /v1/twitter/user/followers`와 `GET /v1/twitter/user/following`은 팔로워와 팔로잉 목록을 커서로 이어 받아요. 팔로워는 한 페이지에 일흔 명 안팎이에요. `GET /v1/twitter/user/media`는 미디어 탭에 올라온, 사진이나 영상이 담긴 트윗만 골라 와요. `GET /v1/twitter/search/users`는 이름이나 핸들로 계정을 찾는데, 열 개 안팎 한 묶음만 주고 커서가 없어요. 다른 계정을 보시려면 검색어를 좁혀 주세요. 미리 알아두실 점이 두 가지 있어요. 팔로워·팔로잉·리트윗 목록에는 인증 여부가 담기지 않고, 미디어 탭 트윗에는 조회수와 북마크 수가 비어 있어요.
- 개선
Reddit 검색에서 게시물 본문을 한 번에 받을 수 있어요
`GET /v1/reddit/search`와 `GET /v1/reddit/subreddit/search`는 출처에 본문이 있으면 `ext.selftext`로 돌려줘요. `content.text`는 `/v1/reddit/post`와 같이 제목과 본문을 이어 붙인 값이에요. 빠진 본문까지 같은 호출에서 받으려면 `include_body=true`를 붙이면 돼요. 본문을 가져온 게시물마다 1크레딧이 더 들고 페이지당 최대 25개이며, 쓰지 않은 크레딧은 환불돼요. 링크 게시물은 본문이 없어서 `ext.selftext`가 null이에요.
- 새 엔드포인트
TikTok, Threads, Instagram 크리에이터를 한 번에 찾는 엔드포인트가 생겼어요
`GET /v1/search/creators`는 주제 검색어를 TikTok 사용자 검색, Threads 사용자 검색, Instagram 프로필 검색에 동시에 보내고, 맞는 크리에이터를 하나의 순위 목록으로 합쳐요. 순위는 검색어 관련도, 팔로워 규모, 인증 여부의 공개된 공식이에요. LLM 재순위는 없어요. 호출당 10크레딧이에요.
- 새 엔드포인트
TikTok 광고 라이브러리와 Apple Music 엔드포인트가 생겼어요
`GET /v1/tiktok/adlibrary/search`와 `GET /v1/tiktok/adlibrary/ad`로 TikTok 광고 라이브러리를 읽어요. 다른 광고 라이브러리와 같은 티어예요. TikTok 검색 제안과 컬렉션 영상, Instagram 혼합 검색과 인기 게시물, 댓글 답글, Facebook 그룹 조회, Snapchat Spotlight 댓글, Apple Music 검색·아티스트·앨범·트랙도 함께 붙었어요. 혼합 검색과 검색 제안을 빼고는 모두 통합 Post, Comment, Author 스키마로 돌아와요.
- 개선
인스타그램 릴스 검색이 끊기지 않도록 대체 소스를 붙였어요
`GET /v1/instagram/search/reels`가 8월 17일 저녁부터 멈춰 있었어요. 뒤에서 데이터를 대주던 소스가 모든 검색어에 응답하지 못했는데, 이 엔드포인트가 소스 하나로만 돌아가던 터라 18일 아침까지 호출마다 404가 돌아왔어요. 물론 요금은 청구되지 않았어요. 이제는 독립된 소스 두 곳 위에서 돌아가고, 한쪽이 멈추면 자동으로 다른 쪽이 이어받아요. 같은 소스를 쓰던 `GET /v1/search/everywhere`의 인스타그램 검색도 같은 방식으로 이어져요. 어느 소스가 응답하든 조회수와 좋아요 수, 댓글 수, 링크, 작성자 정보는 그대로 담겨요. 두 가지만 알아두세요. `post.ext.author_followers`는 기본 소스만 담아주는 값이라 있을 때만 활용하시는 게 좋아요. `date_posted` 필터도 기본 소스에서만 동작해서, 기본 소스가 멈춘 동안에는 필터를 무시한 결과를 슬쩍 돌려드리는 대신 정직하게 실패로 알려드려요.
- 새 엔드포인트
Threads 글에 달린 댓글을 받아보는 엔드포인트가 생겼어요
`GET /v1/threads/post/comments`에 글 URL을 넘기면 Threads가 그 글에 붙여 보내는 댓글을 돌려드려요. 보통 스무 개 안팎이에요. 댓글마다 본문과 좋아요 수, 바로 달린 답글 수, 작성자 핸들과 표시 이름, 프로필 사진, 인증 여부, 고정 여부, 작성 시각이 담기고, 원본에는 없는 댓글 링크도 저희가 shortcode로 만들어 넣어드려요. 미리 알아두실 점이 하나 있어요. Threads는 댓글을 한 묶음만 내주고 커서가 없어서, 긴 대화를 더 깊이 넘겨볼 방법은 없어요. 비용은 글 조회와 같은 1크레딧이에요.
- 개선
인스타그램 캐러셀과 페이스북 이미지가 빠짐없이 담겨요
결이 같은 두 가지를 고쳤어요. `GET /v1/instagram/post`로 캐러셀 글을 조회하면 첫 장 표지만 돌아왔어요. 일곱 장짜리 글이 사진 한 장으로 온 셈이었죠. 이제 장마다 표지가 순서대로 `content.media_urls` 배열에 담겨요. 인스타그램 목록 엔드포인트들이 이미 하던 그대로예요. 페이스북 쪽도 사진 여러 장짜리 글과 캐러셀 광고, 마켓플레이스 매물이 이미지가 몇 장이든 URL 하나만 내보냈고, 이미지형 광고는 아예 비어 있었어요. 이제 `facebook/post`와 프로필·그룹 글, 광고 라이브러리 두 엔드포인트, `marketplace/item` 모두 전체 이미지를 순서대로 돌려드려요. 사진이 한 장뿐인 글은 모양이 그대로라 따로 손보실 건 없어요.
- 개선
유튜브 고급 검색에서 조회수와 영상 길이까지 받아보세요
`GET /v1/youtube/search/advanced`는 제목과 채널, 정확한 게시 시각까지 돌려드리면서도 조회수와 영상 길이는 비어 있었어요. 유튜브 검색 색인이 요약 정보만 내주기 때문이에요. 이제 `includeExtras=true`를 붙이시면 결과마다 `post.engagement.views`와 `.likes`, `.comments`, 그리고 `post.content.duration_seconds`가 함께 담겨요. 기본 1크레딧에 5크레딧이 더 붙는데, 결과 하나당이 아니라 페이지당 한 번이고 한 페이지는 최대 50건이에요. 파라미터를 빼시면 응답도 값도 예전 그대로예요. 날짜 구간을 정확히 잘라야 하거나(`published_after`와 `published_before`는 시·분·초까지 받아요), 실제로 먹히는 정렬이 필요하거나(`order=viewCount`, `order=date`), 페이지 크기를 믿고 쓰셔야 할 때(`max_results`는 요청하신 만큼, 최대 50건을 그대로 돌려드려요) 이 엔드포인트를 쓰시면 돼요. `GET /v1/youtube/search`의 `uploadDate`는 `type`을 같이 넣으면 유튜브가 조용히 무시하거든요. 한 가지는 분명히 말씀드릴게요. 여기엔 쇼츠 필터가 없고 앞으로도 못 넣어요. 유튜브 데이터 API 자체가 세로형 쇼츠를 다른 영상과 구분하지 못하거든요. 가장 가까운 방법은 `duration=short`에 `includeExtras=true`를 더한 뒤 `duration_seconds <= 180`으로 직접 거르시는 건데, 짧은 가로형 영상도 함께 걸린다는 점은 감안해 주세요. 혹시 조회수를 가져오는 쪽이 실패하면 페이지는 그대로 드리고 5크레딧은 돌려드리면서 응답에 `_warnings`로 `extras_unavailable`을 담아드려요.
- 개선
유튜브 검색 페이지가 겹치지 않고, 끝나면 끝났다고 알려줘요
`GET /v1/youtube/search`로 쇼츠를 넘겨 받다 보면 같은 영상이 계속 다시 나올 수 있었어요. 페이지마다 이어보기 토큰은 바뀌고 `has_more`도 계속 참이라 겉보기엔 멀쩡한데, 실제로는 새 결과가 끊긴 상태였죠. 실제로 재본 한 사례에서는 네 페이지에 40건이 청구됐는데 서로 다른 영상은 12개뿐이었어요. 이제는 이미 받아 가신 영상을 기준으로 검색 페이지 전체에서 중복을 걸러내고, 새로운 것이 없는 페이지가 이어지면 더 넘기지 않고 거기서 마무리해요. 전부 중복이던 페이지는 0크레딧 빈 응답으로 돌아가요. 함께 봐주실 점이 있어요. 쇼츠를 날짜로 좁히실 땐 `uploadDate`를 빼고 `includeExtras=true`로 받은 `post.published_at`을 직접 거르시는 편이 좋아요. `uploadDate=this_year`도 여전히 쓸 수 있지만 유튜브가 넘겨주는 결과 자체가 눈에 띄게 줄어들고, 더 짧은 기간을 넣었을 때 돌아오는 400 응답에도 그 내용을 담았어요. 같은 중복 제거가 `GET /v1/youtube/search/hashtag`에도 적용돼요.
- 개선
Threads 프로필에 소개 링크가, 글에는 캐러셀 전체가 담겨요
Threads 계정이 소개란에 걸어둔 외부 링크를 이제 `author.ext.bio_link`로 돌려드려요. Threads에서 잠재 고객을 찾고 계신다면 그 링크가 곧 업체 홈페이지나 연락처인 경우가 많은데, 그동안은 아예 빠져 있었어요. 캐러셀 글은 첫 장만 주던 것에서 모든 이미지를 `content.media_urls` 배열로 돌려주고, 영상 글은 재생할 수 있는 영상 URL을 같은 자리에, 표지 이미지는 `content.thumbnail_url`에 담아드려요. 예전에는 영상 글에 정지 이미지만 들어 있어서 영상에 닿을 방법이 없었어요. 미디어 변경은 사용자 글과 검색 결과, 단일 글 조회에 똑같이 적용돼요.
- 개선
Google 쇼핑과 트렌드, 앱스토어, Google Play에서 국가 코드가 통해요
이 엔드포인트들은 `country` 값을 받는데, 그동안 데이터 공급자가 쓰는 정확한 지역 이름만 알아들었어요. 그래서 누구나 먼저 넣어볼 `country=US`가 미국 결과 대신 오류로 돌아왔고요. 이제는 ISO 코드(`US`, `GB`, `TR`)와 전체 이름(`United States`), 숫자 지역 코드를 모두 받아서 서버에서 알아서 바꿔줘요. 두 글자 코드를 넣어보고 엔드포인트가 고장 났다고 생각하셨다면 고장이 아니라 값을 못 읽던 것이었어요. 각 엔드포인트 문서에도 받을 수 있는 세 가지 형태를 적어두었어요.
- 개선
LinkedIn이 동시 호출에 강해지고, 채용 검색 날짜 필터가 친절해졌어요
LinkedIn 요청의 처리 여유가 크게 늘었어요. LinkedIn 실패의 가장 큰 원인이던, 여러 호출이 한꺼번에 몰릴 때 걸리던 제한이 사라졌어요. 그리고 채용 검색의 `date_posted` 필터는 그동안 아무 문자열이나 그대로 넘겨서, `last-month`처럼 그럴듯한 값을 넣으면 알 수 없는 오류로 돌아왔어요. 이제는 정해진 값만 받아요. 잘못된 값을 넣으면 크레딧이 나가기 전에 `past_24h`, `past_week`, `past_month` 세 가지를 알려주는 400 응답이 무료로 돌아와요. `last-month`를 `past_month`로 조용히 바꿔드리지는 않아요. 들어오던 값 중에는 대응할 곳이 없는 것도 있어서, 임의로 고치면 코드에 남은 문제를 가려버리거든요.
- 개선
Threads 검색이 더 깊이 들어가고, 댓글 페이지가 겹치지 않아요
Threads 검색은 한 번에 정해진 만큼만 돌려주고 커서를 주지 않아서, 깊이 찾을수록 금방 끊겼어요. 이제 서버에서 날짜 구간을 좁혀가며 이어 받고 글 id로 중복을 걸러내요. 같은 질의로 16개에서 83개까지 늘었어요. `limit`을 지정하면 그만큼 서로 다른 글을 한 번의 호출로 모아 오고, 실제로 쓴 구간만큼만 차감한 뒤 남은 만큼은 돌려드려요. 그리고 TikTok과 YouTube 댓글 페이징은 연이은 페이지에 같은 댓글이 다시 나오는 경우가 있었어요. 많이 모으려던 분은 중복에도 비용을 내신 셈인데, 이제 페이징 전 과정에서 중복을 제거해요.
- 새 플랫폼
Wayfair, Home Depot, eBay가 추가됐어요
커머스 커버리지에 세 곳이 더해졌어요. Amazon, Walmart, Target과 같은 상품·리뷰 형태를 쓰기 때문에 여러 유통사를 나란히 비교할 때 필드 이름이 그대로예요. Wayfair는 키워드 검색과 SKU 상세 조회, 리뷰 페이징을 지원해요. eBay는 한 번에 60건씩 돌려주는 검색과 함께, 누적 피드백과 우수 판매자 여부, 가입 시기, 세부 평점 네 가지까지 판매자 평판을 깊게 담은 상세 조회를 제공해요. Home Depot은 상품 상세와 리뷰를 지원하고, 특히 인근 매장마다 실제로 몇 개가 남아 있는지 재고 수량까지 알려줘요. Home Depot 키워드 검색은 공급자 쪽에서 계속 오류가 나서 이번에는 빠졌고, 정상화되면 추가할 예정이에요.
- 개선
나이·성별 추정 엔드포인트를 내렸어요
GET /v1/utility/age-gender를 카탈로그에서 완전히 빼 드렸어요. 업스트림 감지기가 불안정했고, 실제 사용도 거의 없어서 깨진 프리미엄 경로를 남겨 두는 쪽이 더 나빴어요. 공개로 받을 수 있는 오디언스 지역 분포는 GET /v1/tiktok/user/audience를 써 주세요. 무료 유틸리티 DX 엔드포인트(endpoints, endpoint, quickstart, llms)는 그대로예요.
2026년 7월
- 새 엔드포인트
API 사용법, 이제 API에 직접 물어보세요
이제 문서 페이지를 뒤지지 않아도 돼요. 무료 유틸리티 엔드포인트 네 개가 새로 생겨서, 개발자든 AI 에이전트든 호출 한 번으로 API 전체를 파악할 수 있어요. GET /v1/utility/endpoints는 사용 가능한 모든 엔드포인트의 경로, 메서드, 크레딧 비용, 파라미터를 담은 목록을 돌려주는데, platform이나 검색어로 추려서 받아요. GET /v1/utility/endpoint는 엔드포인트 하나의 사용법을 통째로 알려줘요. 파라미터별 타입과 예시, 정확한 크레딧 비용, 페이지네이션 방법, 그대로 복사해 쓰는 예시 요청과 응답, 응답 스키마 URL까지 한 번에 와요. GET /v1/utility/quickstart는 인증, 응답 구조, 과금 방식, 오류 체계, 요청 한도, 그리고 바로 붙여넣어 실행되는 첫 요청 예시까지, 첫 호출에 필요한 전부를 응답 하나에 담아 드려요. GET /v1/utility/llms는 llms.txt 컨텍스트 문서를 API 응답으로 돌려줘요. 전체든 플랫폼 하나든, 마크다운이나 JSON 중 원하는 형식으로 와요. 네 개 모두 크레딧이 들지 않고, 응답은 호출하는 순간 엔드포인트 레지스트리에서 바로 만들어져서 안내 내용이 실제 API와 어긋날 일이 없어요. 플랫폼 하나만 쓰신다면 platform 파라미터로 범위를 좁혀 받아 보세요.
- 새 엔드포인트
여러 나라 뉴스를 한 번에 검색하는 /v1/search/news
검색어 하나면 여러 나라 뉴스를 한 번에 훑을 수 있어요. GET /v1/search/news는 검색어를 검색 각도로 나누고 요청한 나라별 언어로 현지화하는 과정을 한 번에 끝낸 다음, 50개 나라 에디션을 대상으로 최대 12개의 Google News 검색을 동시에 실행해서 기사를 모아요. 나라가 달라도 같은 기사는 하나로 합쳐 주고요. 각 검색 갈래에는 query_source가 붙어서 키워드가 번역된 건지(translated), 원문 그대로 맞는 건지(original), 현지화가 어려워 원문으로 검색한 건지(fallback_original)를 숨김없이 알려줘요. 현지화가 조용히 실패해도 결과가 부풀려 보이는 일이 없어요. JSON으로 받아도 되고, Accept: text/event-stream을 보내면 갈래별 출처 정보가 담긴 검색 계획이 먼저, 나라별 기사가 도착하는 대로 이어서 흘러와요. 요금은 기본 2크레딧에 기사가 실제로 돌아온 갈래당 1크레딧씩 최대 14크레딧이고, 쓰지 않은 차액은 자동으로 환불돼요. 아무것도 못 찾은 검색은 기본 요금만 나가고, 5분 캐시 안에서 같은 검색을 다시 부르면 크레딧이 들지 않아요.
- 개선
Google News 검색이 5배 빨라지고 훨씬 안정적으로 바뀌었어요
GET /v1/google_news/search를 처음부터 끝까지 다시 설계했어요. 응답 중간값이 8초대에서 2초 안팎으로 내려왔고, 48초까지 늘어지던 타임아웃 꼬리도 사라졌어요. 지난달 한때 전체 호출의 4분의 1까지 치솟았던 오류율은 자동 재시도와 독립적인 예비 경로 덕분에 2% 아래로 떨어져요. 새 필터도 세 개 생겼어요. publisher로 특정 매체 도메인(bbc.com 같은)만 골라 받을 수 있고, from/to로 정확한 발행일 구간(YYYY-MM-DD 또는 Unix 타임스탬프)을 지정할 수 있어요. 검색어에는 따옴표 구문과 불리언 연산자(AND, OR, NOT)도 쓸 수 있고요. 데이터 품질도 좋아졌어요. 이제 모든 기사에 도메인이 아닌 실제 매체 이름, 원본 발행사의 썸네일 URL, 초 단위 ISO-8601 UTC 발행 시각이 함께 담겨요. 솔직하게 말씀드릴 트레이드오프도 하나 있어요. 짧은 본문 미리보기(snippet)는 이제 모든 결과에 보장되지 않고, 스키마 문서에도 그대로 반영해 뒀어요. 엔드포인트와 1크레딧 가격은 그대로고, 기존 파라미터는 전부 그대로 동작해요.
- 개선
TikTok Shop 지역 오류 안내가 더 정직해졌어요
GET /v1/tiktokshop/product와 GET /v1/tiktokshop/user/showcase 두 조회는 원본 소스가 지금 US 마켓만 지원해요. 그동안 region=GB를 넘기면 요금이 나갔다가 환불되는 왕복 끝에 이유를 알 수 없는 400만 돌아왔는데, 이제는 호출 즉시 과금 전에 허용 값을 함께 알려주는 400으로 안내돼요. 크레딧은 차감되지 않아요. 검색, 스토어 상품 목록, 상품 리뷰는 영향이 없고 16개 지역을 그대로 지원하니까 GB 같은 다른 지역 상품은 이 세 엔드포인트로 계속 받아보실 수 있어요. 함께 고친 것도 있어요. 슬러그 없는 상품 URL(tiktok.com/shop/pdp/1729587769570529799 형태)은 저희 응답의 product.url이 돌려주는 바로 그 형태인데도 잘못된 URL로 거절됐었는데, 이제 정상 인식돼요. 엔드포인트별 실제 지역 지원 범위는 문서에도 그대로 반영해 뒀고, 원본이 지역 지원을 넓히면 허용 값도 바로 넓힐게요.
- 개선
월마트 키워드 검색을 잠시 내렸어요
오늘부터 GET /v1/walmart/search를 비활성화했어요. 출시 하루 만에 검색을 담당하는 원본 소스가 기본값인 미국 마켓플레이스에서 오류를 내기 시작했는데, 기본 설정으로 호출하면 실패하는 엔드포인트를 문서와 OpenAPI 명세에 그대로 두는 것보다 내리는 편이 낫다고 판단했어요. 지금 호출하시면 크레딧 차감 없이 503이 돌아와요. 오류가 나던 동안에도 요금은 나가지 않았어요. 빈 결과가 아니라 원본 장애로 분류돼서 해당 호출은 모두 자동 환불됐거든요. 나머지 월마트 엔드포인트 네 개는 영향이 없고 오늘 운영 환경에서 다시 확인했어요. 키워드로 상품 ID를 찾고 계셨다면 당분간 GET /v1/walmart/category로 상품을 훑어 주세요. 검색과 달리 실제 판매가까지 함께 와요. 원본이 복구되면 검색도 다시 열어 둘게요.
- 새 엔드포인트
타겟 카테고리 탐색과 매장 찾기가 추가됐어요
타겟 엔드포인트 세 개가 새로 생기면서 상품을 찾는 길이 열렸어요. GET /v1/target/categories는 전체 카테고리 구조를 1크레딧에 돌려주고, GET /v1/target/category는 카테고리 하나를 한 번에 24개씩 훑으면서 실제 판매가, 브랜드, 별점, 이미지, 상품 ID까지 같이 줘요. 타겟에는 요금을 받을 만한 키워드 검색이 없기 때문에, 이 두 엔드포인트가 아무 정보 없이 시작해서 상품 ID를 모으는 확실한 경로예요. 다만 타겟 쪽 정렬이 호출 사이에 조금씩 바뀌어서 앞뒤 페이지에 같은 상품이 몇 개 겹쳐 나올 수 있으니, 수집하실 때 product.id로 중복을 걸러 주세요. 여기에 GET /v1/target/stores를 더했어요. 우편번호나 도시로 근처 매장을 찾으면 주소, 전화번호, 거리, 영업 상태, 2주치 영업시간까지 오고 역시 1크레딧이에요. 카테고리 상품과 매장 모두 기존 통합 스키마를 그대로 써서, 타겟 매장이 구글 비즈니스 장소와 같은 모양으로 파싱돼요.
- 새 플랫폼
타겟 상품 상세와 고객 리뷰가 추가됐어요
타겟이 커머스 커버리지에 합류했어요. 상품 상세와 고객 리뷰, 두 개의 엔드포인트를 제공하고 둘 다 TCIN으로 조회해요. TCIN은 target.com 상품 URL 맨 뒤에 붙는 숫자예요. 상품 상세에서는 가격, 브랜드, 핵심 특징, 이미지 갤러리, 색상·사이즈 옵션과 함께 1~5점 별점 분포까지 한 번의 호출로 받아요. 리뷰를 전부 넘겨보지 않아도 별점 구성을 파악할 수 있어요. 리뷰는 한 페이지에 10건씩 오는데, 페이지끼리 겹치지 않고 전체 개수도 정확해서 전체 수집이 깔끔하게 끝나요. 상품과 리뷰 응답 구조가 아마존·월마트·구글 쇼핑과 같아서 파서 하나로 네 곳을 다 다룰 수 있어요. 타겟 키워드 검색은 넣지 않았어요. 원본 검색이 페이지 파라미터를 무시하고 결과가 24개로 막혀 있는 데다, 결과가 없는 검색어에도 관련 없는 상품을 돌려줘서 요청하지 않은 데이터에 요금을 매기게 되거든요.
- 새 플랫폼
월마트 상품·리뷰·판매자 데이터가 추가됐어요
월마트가 커머스 커버리지에 합류했어요. 상품 상세, 호출당 최대 50건의 고객 리뷰, 키워드 검색, 카테고리 탐색, 그리고 그 상품을 파는 모든 마켓플레이스 판매자까지 엔드포인트 다섯 개로 제공해요. 카테고리에서 우편번호나 매장 ID를 넣으면 소비자가 실제로 보는 매장별 가격과 재고를 확인할 수 있고, country 값으로 walmart.com과 walmart.ca를 골라 조회해요. 상품·리뷰·판매자 응답 구조가 아마존·구글 쇼핑과 같아서 파서 하나로 세 곳을 다 다룰 수 있어요. 참고로 키워드 검색은 다음 날 원본 소스 장애로 내려서, 지금은 다섯 개 중 네 개가 동작해요.
- 새 엔드포인트
레딧 게시물, URL 하나로 본문까지 가져와요
GET /v1/reddit/post에 레딧 게시물 URL을 주면 게시물 본문(selftext)까지 돌려줘요. 그동안 본문은 어디서도 꺼낼 수 없었어요. reddit/search는 제목만 주고, reddit/post/comments는 정작 게시물은 빼고 댓글 트리만 주거든요. content.text에는 제목과 본문이 합쳐져 담기는데, 서브레딧 목록과 같은 모양이에요. ext.title과 ext.selftext에는 둘이 따로 담겨서 본문만 떼어 읽을 수 있어요. 점수, 추천 비율, 댓글 수, 플레어, 작성자, 썸네일, 작성 시각도 함께 와요. 본문이 없는 링크 게시물은 ext.selftext가 null로 와요. 1크레딧이고, 게시물이 없는 URL은 404로 환불돼요.
- 새 엔드포인트
페이스북 릴스, 정확한 반응 수치까지 한 번에
GET /v1/facebook/profile/reels/full이 페이지의 릴스를 정확한 조회수·좋아요·댓글·공유 수와 함께 돌려줘요. 기본 릴스 목록에는 페이스북이 공개적으로 보여주는 반올림된 조회수("1.2만"을 숫자로 되돌린 값)만 담기고 다른 반응 수치는 아예 없어요. 페이스북이 그 숫자들을 개별 릴스에서만 노출하기 때문이에요. 새 엔드포인트는 릴스마다 서버에서 직접 조회해서 목록 값을 정확한 수치로 바꿔 담아줘요. 릴스 10개 한 페이지에 5크레딧 고정이라, 목록과 post-stats를 직접 이어 붙이는 것보다 절반 정도 저렴해요. 항목마다 ext.engagement_source가 붙어서 정확한 수치인지 목록 값인지 구분할 수 있고, 응답에 engagement_coverage가 담기고, 보강이 하나도 안 된 페이지는 목록 가격인 1크레딧까지 자동 환불돼요. limit(최대 50)을 주면 여러 페이지도 알아서 넘겨요.
- 개선
스크립트 404, 이제 이유를 알려드려요
GET /v1/youtube/video/transcript는 자막이 없는 영상에도 밋밋한 not-found만 돌려줬어요. API 버그처럼 보여서 무의미한 재시도를 부르는 응답이었죠. 이제 404에 error.details.reason이 담겨요. captions_disabled, no_captions, login_required, video_gone 중 하나와 알기 쉬운 설명이 함께 오고, 크레딧은 0이에요. 이유 슬러그는 POST /v1/youtube/transcripts 배치 행의 ext.reason과 같은 어휘라서, 단건과 배치가 실패를 똑같이 분류해요.
- 개선
링크드인 대댓글, 이제 제대로 돌아와요
링크드인 업스트림은 대댓글에 평범한 id를 안 실어 보내요. 식별자가 댓글 URN 안에만 들어 있어서, 대댓글 행이 전부 검증에서 조용히 걸러지고 있었어요. 이제 URN에서 comment.id와 comment.post_id를 뽑아내서, 대댓글도 상위 댓글과 같은 id 형식으로 돌아와요.
- 개선
둘로 나뉜 메타 릴스 조회수, 양쪽 다 추적할 수 있어요
메타가 교차 게시된 릴스의 인스타그램·페이스북 조회수 합산을 중단했어요. 인스타그램 숫자는 이제 인스타그램만의 값이고, 과거 게시물에도 소급 적용됐어요. 전체 그림을 추적할 수 있게 두 가지를 바꿨어요. GET /v1/instagram/post/stats가 인스타그램 전용 카운터를 post.ext.ig_play_count로 명시해서 돌려주니까, 메타가 다시 합산하기 시작하면 바로 알 수 있어요. 그리고 POST /v1/prism/post-stats가 facebook.com/reel/과 /videos/ URL을 받아요. 전에는 unsupported로 돌아오던 형식이라, 이제 페이스북 교차 게시물을 인스타그램 원본과 같은 배치에 넣고 둘을 더하면 돼요.
- 개선
video-intel과 comments, 유튜브에서 다시 잘 돌아가요
유튜브가 새 기본 소스로 옮겨간 뒤, GET /v1/prism/video-intel이 유튜브 URL마다 실패하고 GET /v1/prism/comments의 유튜브 스캔이 막혀 있었어요. 두 컴포지트가 여전히 이전 소스의 인증으로 요청을 보내고 있었기 때문이에요. 이제 둘 다 기본 소스와 폴백을 자동으로 오가는 체계를 타요. 스크립트 레그에는 시간 예산도 생겼어요. 느리거나 없는 스크립트는 몇 분씩 스트림을 붙잡는 대신 null로 처리되고, 10크레딧 추가 요금은 환불돼요.
- 개선
깨진 검색어 인코딩, 이제 0크레딧으로 바로 알려드려요
UTF-8이 아닌 문자셋으로 보내져 깨진 검색어나 이중 퍼센트 인코딩된 검색어는 그대로 업스트림에 전달돼서 멀쩡한 빈 결과로 돌아왔어요. "이 플랫폼엔 데이터가 없구나"로 읽히기 딱 좋았죠. 이제 과금 전에 400으로 거절하고, error.details.reason에 invalid_utf8이나 double_encoded와 함께 바로 고칠 수 있는 안내를 담아요. 크레딧은 0이에요. URL 파라미터는 퍼센트 이스케이프가 정상이라 검사에서 제외돼요.
- 새 플랫폼
열린 웹이 API에 들어왔어요: 스크레이프·검색·크롤·추출
이제 소셜 플랫폼만이 아니라 열린 웹 전체를 다뤄요. GET /v1/web/scrape는 URL 하나를 메타데이터가 붙은 깔끔한 마크다운으로 바꿔주고, GET /v1/web/search는 웹·뉴스·이미지 검색 결과를 본문까지 담아 같은 정규화된 형태로 돌려줘요. GET /v1/web/map은 사이트의 URL 목록을 뽑아주고, POST /v1/web/extract는 프롬프트나 스키마만 주면 어떤 페이지에서든 구조화된 JSON을 꺼내요. 큰 작업은 비동기로 돌리면 돼요. 크롤, 배치 스크레이프, 브라우저 에이전트가 백그라운드에서 실행되고, 작업 조회와 웹훅을 지원하고, 취소하면 크레딧을 환불해 드려요. 키도, 응답 형태도 다른 플랫폼과 똑같아요.
- 개선
서브레딧 상세에 주간 활동 지표가 들어왔어요
GET /v1/reddit/subreddit/details가 이제 구독자 수와 함께 커뮤니티 건강 지표 2가지를 돌려줘요. 주간 활성 사용자 수와 주간 기여 수가 author.ext에 담겨요. 구독자 수는 서브레딧이 얼마나 큰지를 알려주지만, 이 지표들은 지금 얼마나 살아 있는지를 알려줘요. 어느 커뮤니티에 참여할지 고를 때 유용해요.
- 새 엔드포인트
배치 엔드포인트: 한 번에 스크립트 100개, 프로필 50개
목록 작업을 위한 배치 엔드포인트 2가지가 나왔어요. POST /v1/youtube/transcripts는 영상 아이디를 최대 100개 받아 행마다 스크립트를 돌려줘요. 텍스트와 타임스탬프 구간 중에 고를 수 있고, 성공한 스크립트당 3크레딧이에요. 자막이 없거나 삭제된 영상은 배치 전체를 실패시키지 않고 따로 표시한 뒤 환불해 드려요. POST /v1/prism/profiles는 12개 플랫폼의 핸들을 최대 50개 받아 각각의 전체 정규화 프로필을 돌려주고, 실제로 조회된 프로필만 각 플랫폼의 기본 요금으로 청구해요. 둘 다 SSE 스트리밍과 행별 custom_id를 지원해서, 응답을 내 데이터와 바로 짝지을 수 있어요.
- 개선
게시물 지표, 더 일관되고 정직하게 돌려드려요
지표를 다듬는 안정화 작업을 했어요. 이제 duration_seconds가 모든 플랫폼에서 실제 초 단위로 나와요(틱톡과 유튜브 폴백은 밀리초로 내려왔었고, 인스타그램은 원래 정상이었어요). 크리에이터가 좋아요 수를 숨기면, 이제 오해를 부르는 작은 숫자 대신 likes: null과 likes_hidden 플래그를 돌려줘요. 인스타그램 릴스·게시물 엔드포인트는 항목마다 ext.shares_source를 달아줘서, 공유 수가 비어 있어도 이유를 항상 알 수 있고 더 이상 조용한 빈칸이 아니에요. 그리고 공유 수가 하나도 안 나온 페이지는 공유 프리미엄을 환불해 드려요. 이제 없는 게시물을 요청하면, 빈 값에 요금을 매기는 대신 명확한 not-found와 함께 크레딧을 전액 환불해 드려요. 마지막으로, 모든 목록 엔드포인트가 단일 cursor 파라미터를 받아요. 페이지네이션 이름을 잘못 넣으면 조용히 첫 페이지를 반복하는 대신, 올바른 이름을 알려주는 안내 오류를 요금 없이 돌려드려요.
- 개선
인스타그램 댓글, 이제 실제 좋아요 수와 진짜 인기순으로 돌려드려요
GET /v1/instagram/post/comments와 prism/comments가 이제 각 댓글의 실제 좋아요 수와 인스타그램 자체 인기 순서를 그대로 돌려줘요. 그래서 sort=top이 앱 상단에 실제로 뜨는, 정말로 좋아요가 많은 댓글부터 먼저 보여줘요. 예전에는 좋아요 수가 거의 0으로 내려와서 순위를 매길 근거 자체가 없었어요. 이제 호출할 때마다 결과가 일관되고, 응답에 그 게시물의 실제 전체 댓글 수도 담겨요. /p/·/reel/·/reels/·/tv/ 어떤 링크를 넣어도 같은 결과를 받아요. 이 필드들을 담아 오는 모바일 소스는 비용이 더 들기 때문에, 인스타그램 댓글은 호출당 정액 5크레딧으로 바뀌었어요.
- 새 엔드포인트
인스타그램·틱톡 댓글 하나를 URL이나 ID로 바로 조회하기
특정 댓글을 추적하기 위한 새 엔드포인트 세 개가 생겼어요. GET /v1/instagram/comment와 GET /v1/tiktok/comment는 댓글 링크(또는 게시물과 댓글 id)를 받아서, 댓글 섹션 전체를 직접 넘겨보지 않고도 그 댓글 하나의 현재 내용·작성자·지표를 한 번의 호출로 돌려줘요. POST /v1/prism/comment-lookup은 최대 25개 댓글을 한 번에 같은 방식으로 조회하니까, 추적 중인 댓글을 매일 새로고침하기에 딱 좋아요. 작성자나 텍스트 일부로 찾을 수도 있어요. 찾지 못한 건 크레딧을 전액 환불해 드리고, 이전 조회에서 받은 위치 힌트를 넘기면 같은 댓글을 다시 확인할 때 거의 무료예요. 정액 요금이에요: 틱톡 2크레딧, 인스타그램 5크레딧.
- 개선
레딧 댓글, 이제 스레드 전체를 트리로 돌려드려요
GET /v1/reddit/post/comments가 이제 최상위 댓글만이 아니라 중첩된 댓글 트리 전체를 한 번의 호출로 돌려줘요. 레딧의 '더 보기' 페이지네이션을 알아서 이어받아 모든 답글 가지를 병합하니까, 커서를 직접 넘기지 않아도 대화 전체를 깊이까지 그대로 받아볼 수 있어요. 아주 큰 스레드는 안전 한도에서 멈추고, 이어받을 커서와 truncated 표시를 함께 내려드려요. 한 번의 호출로 답글 여러 페이지를 안에서 펼치기 때문에, 이 엔드포인트는 어드밴스드 티어의 정액 5크레딧으로 바뀌었어요.
- 새 기능
API 로그를 CSV나 JSON으로 내보내기
Activity 로그 탐색기에 내보내기 메뉴가 생겼어요. 불러온 행을 CSV로 클립보드에 복사하거나, .csv나 .json 파일로 내려받을 수 있어요. 표에 보이는 항목이 그대로 담겨요. 지금 화면에 불러온 행만 내보내니까, 상태·플랫폼·캐시 적중·오류 코드·날짜로 걸러내고 '더 보기'로 필요한 기록까지 불러온 다음, 딱 그만큼만 내보내면 돼요.
2026년 6월
- 새 엔드포인트
유튜브, 더 빠른 소스·풍부한 데이터·대량 조회 추가
핵심 유튜브 엔드포인트 (채널·영상·댓글·답글·재생목록·자막) 이 더 빠르고 안정적인 소스로 동작하고, 자동 장애 복구까지 갖췄어요. 업스트림이 일시적으로 막혀도 호출이 통째로 실패하지 않아요. 응답에 담기는 정보도 더 많아졌어요. 영상 전체 설명, 채널의 연관 재생목록 링크(업로드 목록으로 바로 들어갈 때 유용해요), 댓글의 인기 답글 미리보기 등을 모두 ext에 담아 돌려줘요. 새 대량 엔드포인트 2종도 추가됐어요. POST /v1/youtube/videos와 POST /v1/youtube/channels는 영상이나 채널을 한 번의 호출로 최대 1,000개까지 가져오고, 50개당 5크레딧으로 매겨져요. 확인할 변경 1가지: 채널 가입일이 이제 자유 텍스트 대신 깔끔한 ISO 날짜(2015-02-01)로 나와요.
- 새 기능
대시보드에 들어온 요청 로그 탐색기
대시보드의 Activity 페이지가 이제 내가 보낸 모든 API 호출을 살펴보는 제대로 된 로그 탐색기가 됐어요. 사이드바 필터에서 상태, 플랫폼, 캐시 적중 여부, 오류 코드, 날짜로 걸러볼 수 있고, 항목별 개수도 실시간으로 보여줘요. 요청량 히스토그램으로 급증과 오류를 한눈에 파악하고, 무한 스크롤과 검색으로 전체 기록을 훑을 수 있어요. 아무 행이나 누르면 메서드, 경로, 요청 ID, 상태, 응답 시간, 응답 크기, 사용한 크레딧까지 담긴 상세 화면이 열려요. 라이브 모드를 켜면 호출이 들어오는 대로 실시간으로 볼 수 있어요.
- 개선
커서 페이지네이션, 이제 무한 루프도 중복도 없어요
페이지네이션 관련 문제 3가지를 API 전반에서 고쳤어요. 빈 페이지는 이제 next_cursor를 돌려주지 않아요. 그래서 커서가 끝날 때까지 페이지를 넘기는 클라이언트가 결과 0개인 페이지에서 무한히 도는 일이 없어요. 업스트림이 보냈던 커서를 그대로 다시 돌려주면, 이제는 전달하지 않고 끊어줘요. 이것도 페이지네이션이 제자리에서 도는 원인이었거든요. 그리고 유튜브 댓글과 답글에서는 페이지 경계에 걸친 항목을 중복 제거해서, 페이지를 넘길 때 같은 댓글이 두 번 나오지 않아요. 따로 바꿀 건 없어요. 지금처럼 next_cursor만 따라가면 돼요.
- 새 기능
무료 도구 3종 추가: 아마존 리뷰·앱 리뷰·주식 비교
회원가입 없이 실제 API로 동작하는 무료 도구 3종이 더해졌어요. 아마존 가짜 리뷰 검사기는 상품 리뷰가 얼마나 믿을 만한지 점수로 보여줘요. 앱 리뷰 분석기는 앱스토어와 구글플레이 리뷰 수천 개를 읽고 사용자들이 실제로 반복해서 하는 말을 짚어줘요. 주식 비교는 원하는 두 종목을 나란히 놓고 비교해줘요. 브라우저에서 바로 써보고, 같은 데이터를 API로도 가져올 수 있어요.
- 개선
인스타그램 해시태그 검색, 이제 진짜 게시물이 나와요
인스타그램 해시태그 검색이 이제 구글 색인 기반 스크레이퍼 대신 인스타그램 자체 해시태그 피드를 읽어요. 예전에는 #travel이나 #food 같은 인기 태그에도 게시물이 안 나왔거든요. 결과는 shortcode, URL, 캡션, 미디어, 참여 수, 작성자가 담긴 진짜 공개 게시물이에요. 확인할 변경 2가지가 있어요. type로 정렬을 고르고(top·recent·clips=릴스만) 응답의 cursor로 페이지를 넘기면 돼요. 기존 date_posted와 media_type 파라미터는 없어졌어요. 그리고 새 소스로 옮기면서 비용이 advanced 등급(5크레딧)으로 바뀌었어요.
- 개선
더 안정적이고 이어받을 수 있는 댓글 수집
댓글 대량 수집이 더 안정적이 됐어요. 댓글 엔드포인트가 이제 일시적인 업스트림 차단을 자동으로 재시도하고 스캔 시간 예산 안에서 동작해서, 깊은 수집이 한 번의 일시 오류로 통째로 멈추지 않아요. 한 번에 다 못 가져오면 지금까지 모은 댓글과 함께 next_cursor와 _warnings 안내를 돌려주고, 비용은 실제로 가져온 페이지만큼만 내면 돼요. 인스타그램에서는 sort=top과 max가 이제 실제 댓글 풀까지 닿아요. 인스타그램은 페이지당 댓글 수가 다른 플랫폼보다 적어서 예전에는 스캔이 일찍 막혔는데, 이제는 좋아요가 가장 많은 댓글까지 제대로 뽑을 수 있어요.
- 개선
좋아요 많은 댓글부터 가져오기
댓글 엔드포인트가 이제 좋아요가 많은 댓글부터 돌려줘요. 틱톡·인스타그램·유튜브·페이스북·레딧·해커뉴스 게시물 URL에 sort=top만 붙이면 가져온 댓글을 좋아요 수 기준으로 정렬해주고, limit으로 몇 개까지 받을지 정할 수 있어요. 댓글이 1만 개인 게시물에서 상위 200개를 뽑을 때도 직접 페이지를 넘기며 정렬할 필요 없이 호출 한 번이면 돼요. 유튜브는 정확하게 정렬되고, 나머지 플랫폼은 가져온 범위 안에서 정렬해요. 응답에는 정렬 기준(sorted_by)과 반환 개수(returned)가 함께 담겨요. 정렬해도 비용은 그대로예요. 실제로 훑은 페이지만큼만 내면 돼요.
- 새 엔드포인트
인스타그램·링크드인·유튜브 대규모 업데이트
인스타그램에 엔드포인트 14종이 추가됐어요. 팔로워·팔로잉 목록, 게시물에 좋아요 누른 사람, 스토리, 태그된 미디어, 위치 기반 피드, 그리고 계산된 참여율까지요. 링크드인은 더 최신 소스로 새로 만들어 채용 검색, 더 풍부한 프로필, 회사 페이지, 리포스트, 반응을 지원해요. 유튜브에는 인기 영상, 고급 검색, 대본, 오디오, 자막, 썸네일 8종이 더해졌어요. 꼭 확인할 변경 2가지가 있어요. 유튜브 대본은 이제 startMs/endMs 대신 offset/duration(초 단위)을 반환하고 비용이 10크레딧에서 3크레딧으로 낮아졌어요. 링크드인 프로필·회사·게시물은 더 풍부한 소스로 옮겨가면서 1크레딧에서 5크레딧이 되고, 단일 결과는 data 키 안에 담겨요.
- 새 기능
AI로 만들기: 원하는 걸 말하면 코드가 나와요
대시보드에 새 어시스턴트가 들어왔어요. 평범한 말로 필요한 걸 적으면 동작하는 SocialCrawl 연동으로 바꿔줘요. 원하는 데이터를 설명하면 알맞은 엔드포인트를 골라 코드를 작성하고, 크레딧 비용을 추정하고, 내 API 키로 바로 실행까지 해줘요. 문서를 다 읽지 않아도 아이디어에서 검증된 호출까지 한 번에 갈 수 있어요.
- 새 기능
크레딧 자동 충전
잔액 기준과 충전 금액을 정해두면, 크레딧이 떨어지기 전에 SocialCrawl이 알아서 다시 채워줘요. 트래픽이 몰리는 날에도 402로 끊길 일이 없어요. 한 번 켜고 한도만 정해두면 수동 충전은 더 신경 쓰지 않아도 돼요.
- 새 기능
Prism: 여러 플랫폼을 한 번에 묶는 합성 엔드포인트
호출 한 번으로 여러 플랫폼에 동시에 요청을 보내고, 결과를 하나의 응답으로 묶어주는 새로운 독자 엔드포인트 계열이에요. 소셜·커머스 URL 자동 인식, 분석 지표가 붙은 크리에이터 프로필, X·Threads·Bluesky·Truth Social을 가로지르는 한 사람의 게시물, 여러 엔진을 종합한 출처 포함 AI 답변까지, 응답마다 어떤 소스가 실제로 동작했고 어디가 빠졌는지 legs 배열로 그대로 보여줘요.
- 새 기능
무료 도구 3종 추가
브랜드 언급 확인 도구, 참여율 계산기, 크리에이터 수익 계산기까지, 회원가입 없이 실제 API로 동작하는 무료 도구 3종이에요. 브랜드가 어느 플랫폼에서 회자되는지 살펴보고, 크리에이터의 실제 참여율을 업계 기준과 비교하고, 팔로워 수와 참여도로 게시물당 예상 수익을 가늠해볼 수 있어요.
- 새 기능
추천 프로그램으로 크레딧 적립
추천 링크를 공유하면, 추천받은 분이 첫 결제를 마칠 때 2,500크레딧을 드려요. 적립한 크레딧과 추천 현황은 대시보드의 새 페이지에서 확인할 수 있어요.
- 새 엔드포인트
Prism 브랜드·시장 인텔리전스
흩어진 소셜·웹 신호를 브랜드 인텔리전스로 바꿔주는 Prism 레시피 모음이에요. 감성 분석이 붙은 브랜드 언급 수집, 경쟁사 대비 점유율(SOV), 마켓플레이스 통합 상품 평점, 리뷰 신뢰도 등급, 영업 리드 대화, 고용 브랜드 평판, 개발자 도구 반응까지 전부 호출 한 번이면 돼요. 직접 파이프라인을 만들 필요가 없어요.
- 새 엔드포인트
포럼 통합 검색 /v1/search/forums
Reddit, Hacker News, 네이버 지식iN·카페를 한 번에 검색해 스레드를 융합·클러스터링해주는 검색 레인이에요. 기본으로 댓글까지 함께 담기고, 고객 반응이나 개발자 여론 조사에 바로 쓸 수 있어요.
- 새 플랫폼
Content Analysis: 웹 전반의 브랜드 언급·감성 분석
뉴스, 블로그, 이커머스, 게시판 전반에서 브랜드나 문구가 언급된 곳을 찾고, 6축 감성 분석·문구 트렌드·상위 도메인까지 함께 받아요. Prism 브랜드 인텔리전스 합성 엔드포인트의 데이터 기반이기도 해요.
- 새 플랫폼
- 새 플랫폼
Google News 실시간 검색
어떤 키워드든 Google News의 실시간 검색 결과를 가져와요. 최신 기사, 출처, 게시 시각을 정규화된 뉴스 스키마로 내려드려요.
- 새 플랫폼
- 새 플랫폼
Google Play · App Store 앱 데이터
앱 마켓 두 곳이 한 번에 들어왔어요. Google Play와 Apple App Store의 앱 정보, 차트, 리뷰를 하나의 앱 스키마로 정리해서 내려드려요.
- 개선
TikTok Shop, 독립 플랫폼으로 분리
TikTok Shop 엔드포인트가 tiktokshop 플랫폼으로 분리됐어요. 전용 문서와 URL이 생겼고, 기존 경로는 레거시 별칭으로 그대로 동작해요.
- 새 플랫폼
Trustpilot 리뷰 데이터
도메인으로 기업을 검색하고 Trustpilot 리뷰 전체를 가져올 수 있어요. 브랜드 평판 모니터링에 바로 쓸 수 있는 엔드포인트 2종이에요.
- 새 플랫폼
- 새 플랫폼
Google Shopping 상품 데이터
Google Shopping의 상품 검색, 상세 스펙, 판매자 정보를 Amazon과 같은 커머스 스키마로 받아볼 수 있어요.
- 새 엔드포인트
Amazon 상품·리뷰·판매자 엔드포인트
스토어 페이지만 긁어오던 Amazon 플랫폼에 상품 검색, ASIN 상세, 리뷰 히스토리, 판매자 목록이 더해져 엔드포인트 5개가 됐어요. Google Shopping과 같은 커머스 스키마예요.
- 새 엔드포인트
- 새 기능
SocialCrawl vs Apify 비교 페이지
가격, 유지보수 부담, 통합 스키마가 아껴주는 시간까지 Apify와 항목별로 나란히 비교했어요.
- 새 플랫폼
2026년 5월
- 개선
웹에서 무료로 쓰는 통합 검색
socialcrawl.dev에서 12개 플랫폼 동시 검색을 하루 한 번, 로그인 없이 무료로 쓸 수 있어요. API 버전은 호출당 20크레딧 그대로예요.
- 새 기능
MCP 서버 npm 공개
socialcrawl-mcp v1.3.0이 npm과 MCP 레지스트리에 올라갔어요. npx 한 줄이면 Claude Desktop, Cursor, Windsurf 같은 MCP 클라이언트에서 SocialCrawl 데이터를 바로 쓸 수 있어요.
2026년 4월
- 새 기능
- 새 기능
SocialCrawl vs SociaVault 비교 페이지
첫 번째 경쟁사 비교 페이지예요. 기능, 가격, 데이터 커버리지를 나란히 놓고 비교했어요.
- 새 기능