Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn't in the catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Bluesky Profile

Fetch public profile information from Bluesky.

Endpoints: 8
Requests: 9
Updated: 3 months ago
For LLMs: llms.txt

Endpoint health9 hours ago

profilepassing, 1.4s
downloadpassing, 1.9s
trendspassing, 0.5s
search-postsfailed the last check
search-userspassing, 0.5s

+ 3 more endpoints

7/8 passingdaily 01:00 WIB

Playground

8 endpoints

GET/v1/social-media:bluesky/profile/:handle5m cache1 paramchecking key…

Parameters

Response

EXAMPLE

{
  "ok": true,
  "posts": [
    {
      "cid": "bafyreietolc66j77ylzxpqpuygfhgu435trzl5faskqzvguhorqiu5vhuy",
      "uri": "at://did:plc:mklohhw3fghtcsutnemlbimm/app.bsky.feed.post/3mltifjh2522v",
      "text": "shared some thoughts on building with @attie.ai and why I'm so excited\n\nblockchaincapital.com/blog/after-t...",
      "author": {
        "did": "did:plc:mklohhw3fghtcsutnemlbimm",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mklohhw3fghtcsutnemlbimm/bafkreicuzzvfwcxmakkydv3zdi7yjzbbdwkjeyeucryns267yngl7mlbxi",
        "handle": "kinjal.bsky.social",
        "displayName": "Kinjal"
      },
      "repost": true,
      "createdAt": "2026-05-14T18:51:53.213Z",
      "indexedAt": "2026-05-14T18:51:54.567Z",
      "likeCount": 58,
      "quoteCount": 5,
      "replyCount": 9,
      "repostCount": 6
    },
    {
      "cid": "bafyreidyvnczi37omokdajwripxkc6xd4mlsttp7g3ex7tcqeui7yacn2m",
      "uri": "at://did:plc:2gkh62xvzokhlf6li4ol3b3d/app.bsky.feed.post/3mltfz6cvic2o",
      "text": "I'll go against the discourse. 280 contributors to repo.npmx.dev in 100 days. We only used bluesky for social comms. We asked while welcoming folks, and most of them got involved a…",
      "author": {
        "did": "did:plc:2gkh62xvzokhlf6li4ol3b3d",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2gkh62xvzokhlf6li4ol3b3d/bafkreibi7rw745tbcea7ljrpbkkkoragy2xa5a2lrxhdb3m23s7n3wkv3q",
        "handle": "patak.cat",
        "displayName": "patak"
      },
      "repost": true,
      "createdAt": "2026-05-14T18:09:11.404Z",
      "indexedAt": "2026-05-14T18:09:12.468Z",
      "likeCount": 180,
      "quoteCount": 2,
      "replyCount": 4,
      "repostCount": 19
    }
  ],
  "profile": {
    "did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
    "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreicgnmvhtmj4arcvwhueygbwvkucd3odvom3lxtfmn6wlqbh3yf7p4",
    "handle": "jay.bsky.team",
    "createdAt": "2022-11-17T06:31:40.296Z",
    "indexedAt": "2026-03-29T21:16:33.460Z",
    "postsCount": 4095,
    "description": "Founder & Chief Innovation Officer @ Bluesky\n\nWorking on @attie.ai\n\n🌱 🪴 🌳",
    "displayName": "Jay 🦋",
    "followsCount": 3966,
    "followersCount": 595946
  }
}

Code examples

Profile

zpi-sdkrecommended

// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("social-media:bluesky", "profile", {
  "handle": "jay.bsky.team"
});
console.log(data);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/profile/jay.bsky.team" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

8 endpoints · plain text

GETProfile/v1/social-media:bluesky/profile/:handleGet a Bluesky user's public profile.

Parameters

handlestringrequiredin path: Bluesky handle (e.g. user.bsky.social) atau DID

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/profile/jay.bsky.team" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "posts": [
    {
      "cid": "bafyreietolc66j77ylzxpqpuygfhgu435trzl5faskqzvguhorqiu5vhuy",
      "uri": "at://did:plc:mklohhw3fghtcsutnemlbimm/app.bsky.feed.post/3mltifjh2522v",
      "text": "shared some thoughts on building with @attie.ai and why I'm so excited\n\nblockchaincapital.com/blog/after-t...",
      "author": {
        "did": "did:plc:mklohhw3fghtcsutnemlbimm",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mklohhw3fghtcsutnemlbimm/bafkreicuzzvfwcxmakkydv3zdi7yjzbbdwkjeyeucryns267yngl7mlbxi",
        "handle": "kinjal.bsky.social",
        "displayName": "Kinjal"
      },
      "repost": true,
      "createdAt": "2026-05-14T18:51:53.213Z",
      "indexedAt": "2026-05-14T18:51:54.567Z",
      "likeCount": 58,
      "quoteCount": 5,
      "replyCount": 9,
      "repostCount": 6
    },
    {
      "cid": "bafyreidyvnczi37omokdajwripxkc6xd4mlsttp7g3ex7tcqeui7yacn2m",
      "uri": "at://did:plc:2gkh62xvzokhlf6li4ol3b3d/app.bsky.feed.post/3mltfz6cvic2o",
      "text": "I'll go against the discourse. 280 contributors to repo.npmx.dev in 100 days. We only used bluesky for social comms. We asked while welcoming folks, and most of them got involved a…",
      "author": {
        "did": "did:plc:2gkh62xvzokhlf6li4ol3b3d",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2gkh62xvzokhlf6li4ol3b3d/bafkreibi7rw745tbcea7ljrpbkkkoragy2xa5a2lrxhdb3m23s7n3wkv3q",
        "handle": "patak.cat",
        "displayName": "patak"
      },
      "repost": true,
      "createdAt": "2026-05-14T18:09:11.404Z",
      "indexedAt": "2026-05-14T18:09:12.468Z",
      "likeCount": 180,
      "quoteCount": 2,
      "replyCount": 4,
      "repostCount": 19
    }
  ],
  "profile": {
    "did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
    "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreicgnmvhtmj4arcvwhueygbwvkucd3odvom3lxtfmn6wlqbh3yf7p4",
    "handle": "jay.bsky.team",
    "createdAt": "2022-11-17T06:31:40.296Z",
    "indexedAt": "2026-03-29T21:16:33.460Z",
    "postsCount": 4095,
    "description": "Founder & Chief Innovation Officer @ Bluesky\n\nWorking on @attie.ai\n\n🌱 🪴 🌳",
    "displayName": "Jay 🦋",
    "followsCount": 3966,
    "followersCount": 595946
  }
}

GETDownload/v1/social-media:bluesky/downloadDownload media dari Bluesky.

Parameters

urlstringrequired: URL Bluesky (video/post). Boleh dengan query param.
qualityenumoptional: Kualitas video maksimal — max = terbaik. Default 1080. Diabaikan kalau audioOnly=true. Values: 144, 240, 360, 480, 720, 1080, max.
audioOnlyenumoptional: Kalau true, ambil audio saja. Default false (video). Pilih true/false. Values: true, false.
audioFormatenumoptional: Format audio kalau audioOnly=true. Default mp3. Values: mp3, opus, ogg, wav.

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/download?url=https%3A%2F%2Fbsky.app%2Fprofile%2Falexbenzer.com%2Fpost%2F3mloibwobns2b&quality=1080&audioOnly=false&audioFormat=mp3" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

null

GETGet Trending Topics/v1/social-media:bluesky/trendsTopik yang sedang tren di Bluesky.

Parameters

limitnumberoptional: Number of trends to return. Default 10, max 25

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/trends?limit=10" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "count": 10,
  "trends": [
    {
      "link": "/profile/trending.bsky.app/feed/821037737",
      "topic": "clacton",
      "actors": [
        {
          "did": "did:plc:qosd44nwnujay5zbmg2q3p7q",
          "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:qosd44nwnujay5zbmg2q3p7q/bafkreiek4fk2jwjyjmfquw7xumboxqksygxovhtwc3cvpa7tkzbgo5arie",
          "handle": "countbinface.bsky.social",
          "displayName": "Count Binface"
        },
        {
          "did": "did:plc:fz5yyztrodsbmpx2lm33iamd",
          "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:fz5yyztrodsbmpx2lm33iamd/bafkreigovte2wz5jayzga6nrrtkyt5f45fh6jekgfzcgwlcjcimqwukbli",
          "handle": "douglasireland.com",
          "displayName": "Douglas Ireland ✊🌱"
        }
      ],
      "status": "hot",
      "category": "politics",
      "postCount": 124,
      "startedAt": "2026-08-06T10:41:34.10392Z",
      "displayName": "Clacton By-Election"
    },
    {
      "link": "/profile/trending.bsky.app/feed/821012904",
      "topic": "ukraine",
      "actors": [
        {
          "did": "did:plc:4aqzua5vsewimmusg66fyajl",
          "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:4aqzua5vsewimmusg66fyajl/bafkreiacwznbgisutpt6s7wtwwqjg7t6ta6tn2onognya27y3lv7snomzu",
          "handle": "noelreports.com",
          "displayName": "NOELREPORTS"
        },
        {
          "did": "did:plc:6y3honhec2jch2ryrbuyx5a5",
          "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:6y3honhec2jch2ryrbuyx5a5/bafkreiaxheuelonc6ngwflm43jyexf7cqcs56bcdfiv2to77rrxbfvmh4e",
          "handle": "maks23.bsky.social",
          "displayName": "MAKS 26 👀🇺🇦"
        }
      ],
      "category": "politics",
      "postCount": 466,
      "startedAt": "2026-08-06T09:45:33.803142Z",
      "displayName": "Ukraine"
    }
  ]
}

GETSearch Posts/v1/social-media:bluesky/search-postsCari postingan Bluesky. Tidak bisa dipaginasi.

Parameters

qstringrequired: Search query
limitnumberoptional: Results to return. Default 25, max 100
sortenumoptional: Result ordering. Default top Values: top, latest.
langstringoptional: Filter by post language (ISO code)
authorstringoptional: Restrict to one author's handle or DID
sincestringoptional: Only posts on/after this date (YYYY-MM-DD)
untilstringoptional: Only posts before this date (YYYY-MM-DD)

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/search-posts?q=rust+programming&limit=25&sort=latest&lang=id&author=jay.bsky.team&since=2026-08-01&until=2026-08-06" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "sort": "top",
  "count": 25,
  "posts": [
    {
      "cid": "bafyreifjjuhrtmuzv73ifn7mbkanffue5qjwsywyuk7cihellay4zvga7e",
      "uri": "at://did:plc:sfvpv6dfrug3rnjewn7gyx62/app.bsky.feed.post/3mbfzft2rp22c",
      "lang": "en",
      "text": "the kids, they know how to name libraries. \n\nwww.reddit.com/r/rust/comme...",
      "author": {
        "did": "did:plc:sfvpv6dfrug3rnjewn7gyx62",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:sfvpv6dfrug3rnjewn7gyx62/bafkreibcxpht7zihliq7kgu3fnlfqlqdpievvljttuvulcsjxar6csnqxy",
        "handle": "buttplug.engineer",
        "displayName": "qdot"
      },
      "createdAt": "2026-01-02T04:07:04.291Z",
      "indexedAt": "2026-01-02T04:07:05.733Z",
      "likeCount": 1182,
      "quoteCount": 24,
      "replyCount": 26,
      "repostCount": 317
    },
    {
      "cid": "bafyreihufjznst6mu5udqlwidqotvqrdnekpxddngsnif5cna477l4ylsm",
      "uri": "at://did:plc:7tiia5rclvwibxngh7mvrlsw/app.bsky.feed.post/3lvjofku3e22n",
      "lang": "en",
      "text": "trying to shake off the rust",
      "author": {
        "did": "did:plc:7tiia5rclvwibxngh7mvrlsw",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:7tiia5rclvwibxngh7mvrlsw/bafkreig5qbte6ktepgmoftxy2xt5r62jz3gda4vn6pxfp2s2ppuz6ooct4",
        "handle": "angusburgers.bsky.social",
        "displayName": "Dani(They/Them)- Comms reopening AUGUST 10"
      },
      "createdAt": "2025-08-03T21:58:23.921Z",
      "indexedAt": "2025-08-03T21:58:25.707Z",
      "likeCount": 1250,
      "quoteCount": 0,
      "replyCount": 11,
      "repostCount": 209
    },
    {
      "cid": "bafyreiahiqzcsmifttgwfon3rvto6xp7qgzv5fpllzj5zxqqpg2o7bajwy",
      "uri": "at://did:plc:wamidydbgu3u6fk3yckaglnz/app.bsky.feed.post/3mscxgjywgk2i",
      "lang": "en",
      "text": "fair enough. can't personally argue with this as a dividing line blog.rust-lang.org/inside-rust/...",
      "author": {
        "did": "did:plc:wamidydbgu3u6fk3yckaglnz",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:wamidydbgu3u6fk3yckaglnz/bafkreibmakekm64poceaubjq7uvvafbyqgp5wjllpg3ijvhhohl22nmi3m",
        "handle": "philpax.me",
        "displayName": "philpax"
      },
      "createdAt": "2026-08-05T07:01:59.323Z",
      "indexedAt": "2026-08-05T07:02:01.065Z",
      "likeCount": 61,
      "quoteCount": 2,
      "replyCount": 3,
      "repostCount": 2
    }
  ],
  "query": "rust",
  "total": 10000,
  "totalIsCapped": true
}

GETSearch Users/v1/social-media:bluesky/search-usersCari akun Bluesky berdasarkan handle atau nama.

Parameters

qstringrequired: Search term for handles and display names
limitnumberoptional: Results per page. Default 25, max 100
cursorstringoptional: Cursor from a previous response's cursor field

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/search-users?q=nasa&limit=25&cursor=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "count": 24,
  "query": "nasa",
  "users": [
    {
      "did": "did:plc:ocmyknbwkxjyjkactio272im",
      "url": "https://bsky.app/profile/nasawebb.extwitter.link",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ocmyknbwkxjyjkactio272im/bafkreich4qumrtdmi7xcffg3bqquyijspjftc7ejaaodbujqyoo5lyagcu",
      "handle": "nasawebb.extwitter.link",
      "createdAt": "2024-02-22T17:10:21.640Z",
      "indexedAt": "2026-03-30T15:37:13.249Z",
      "description": "⚠️ MIRROR OF twitter.com/NASAWebb\n⚠️ If you own the original account and want to claim this, please contact @twttr-mirrors.bsky.social",
      "displayName": "NASA Webb Telescope"
    },
    {
      "did": "did:plc:6udbhveni6zbejqdt5ancvkr",
      "url": "https://bsky.app/profile/uahirise.bsky.social",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:6udbhveni6zbejqdt5ancvkr/bafkreicu6s4y4e4nopdrbilvchfij4ar3t2nil4f7ctur67q7ktsdy3n3m",
      "handle": "uahirise.bsky.social",
      "createdAt": "2023-10-17T23:54:39.050Z",
      "indexedAt": "2025-10-01T20:33:55.048Z",
      "description": "Images from the High Resolution Imaging Science Experiment (HiRISE) on board the Mars Reconnaissance Orbiter (NASA). We are based out of the Lunar and Planetary Laboratory at the U…",
      "displayName": "HiRISE Beautiful Mars (NASA)"
    },
    {
      "did": "did:plc:ppstkwdiil3qysaerqwtbl2p",
      "url": "https://bsky.app/profile/nasawatch.bsky.social",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ppstkwdiil3qysaerqwtbl2p/bafkreihpdfchkm3kmauuvbltmrsks5zmrvlogv2z36w5gp3cbluifvwq2y",
      "handle": "nasawatch.bsky.social",
      "createdAt": "2023-09-26T00:58:53.168Z",
      "indexedAt": "2026-08-05T19:52:28.061Z",
      "description": "NASAWATCH.com - Unofficial Space News Since 1996",
      "displayName": "NASAWATCH"
    }
  ],
  "cursor": "eyJzIjpbMTAwMCw0LjM2OTU3OWUtOCwiZGlkOnBsYzpnN2V5ZndtN2Q3bmVjYXZnb3Rrbmk1bGsiXX0",
  "hasMore": true
}

GETGet Followers/v1/social-media:bluesky/followers/:handleDaftar follower sebuah akun Bluesky.

Parameters

handlestringrequiredin path: Bluesky handle or DID
limitnumberoptional: Accounts per page. Default 50, max 100
cursorstringoptional: Cursor from a previous response's cursor field

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/followers/jay.bsky.team?limit=50&cursor=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "count": 43,
  "cursor": "3msdvxuj3kh26",
  "hasMore": true,
  "subject": {
    "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
    "url": "https://bsky.app/profile/pfrazee.com",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq",
    "handle": "pfrazee.com",
    "createdAt": "2022-11-17T00:35:16.391Z",
    "indexedAt": "2026-02-09T17:34:52.546Z",
    "description": "CTO at Bluesky. Not a nerd.",
    "displayName": "Paul Frazee"
  },
  "followers": [
    {
      "did": "did:plc:mz4m6yo275wmhyjucq5n4cgu",
      "url": "https://bsky.app/profile/justmask.bsky.social",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mz4m6yo275wmhyjucq5n4cgu/bafkreiav7qlbxnj57z3mlczkdlnhcdv7kpv7g73ecyyyq6q6uqdwyulrfu",
      "handle": "justmask.bsky.social",
      "createdAt": "2025-04-04T20:57:25.295Z",
      "indexedAt": "2025-04-16T12:06:47.974Z",
      "displayName": "Mask"
    },
    {
      "did": "did:plc:asodcn76lcar32eawgwza3os",
      "url": "https://bsky.app/profile/yankeemorla.bsky.social",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:asodcn76lcar32eawgwza3os/bafkreihdu7svdmxxke2j3uowr5kvyswa4tkbsfqzgn555hiiddbkh4wpaq",
      "handle": "yankeemorla.bsky.social",
      "createdAt": "2026-05-31T18:09:51.260Z",
      "indexedAt": "2026-06-02T13:47:25.361Z",
      "description": "Fundador de Conditec SRL 🇩🇴\nSoftware a medida + IA aplicada para empresas reales.\nConstruyo en público: MCP, Claude, agentes y automatización.\nComparto casos.\n\n→ conditecrd.com",
      "displayName": "Jean Carlos Morla · Conditec"
    },
    {
      "did": "did:plc:heffi4e2idq23rti57vbonjn",
      "url": "https://bsky.app/profile/raynabrown1.bsky.social",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:heffi4e2idq23rti57vbonjn/bafkreiew2lnzq2uba57uv5v6xe45g2uuypj6iciwsygj2fgkwsb27m3fkq",
      "handle": "raynabrown1.bsky.social",
      "createdAt": "2026-08-06T03:31:04.769Z",
      "indexedAt": "2026-08-06T07:21:33.663Z",
      "description": "This is a backup account of Trans Gender Candy gracy. Follow me up here. i will also follow you",
      "displayName": "TR Grace"
    }
  ]
}

GETGet Following/v1/social-media:bluesky/following/:handleAkun yang diikuti sebuah akun Bluesky.

Parameters

handlestringrequiredin path: Bluesky handle or DID
limitnumberoptional: Accounts per page. Default 50, max 100
cursorstringoptional: Cursor from a previous response's cursor field

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/following/jay.bsky.team?limit=50&cursor=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "count": 50,
  "cursor": "3mke3l7ulrc2t",
  "follows": [
    {
      "did": "did:plc:klhtmrnregub7we7h6jwiljm",
      "url": "https://bsky.app/profile/ed3d.net",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:klhtmrnregub7we7h6jwiljm/bafkreiax76tzue7jcdk44ug6vv62ikttoq4c3waolhs2lo3yih6vdoje4a",
      "handle": "ed3d.net",
      "createdAt": "2023-04-27T23:01:37.442Z",
      "indexedAt": "2026-08-03T01:41:34.659Z",
      "description": "Main Character Syndrome, but fun. Boston-based. My wood shop and my dogs are my personality. If you're still reading this, I'm your dad now. Sorry, I don't make the rules.\n\nI don't…",
      "displayName": "Ed"
    },
    {
      "did": "did:plc:5hhbgkktcpofpw4ovz6kjjau",
      "url": "https://bsky.app/profile/jdp.extropian.net",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:5hhbgkktcpofpw4ovz6kjjau/bafkreignnoa2x3p27l2xsbcy56tk5eljpvnc6qcehavb7klfzhrvjadkhu",
      "handle": "jdp.extropian.net",
      "createdAt": "2023-04-09T21:59:36.855Z",
      "indexedAt": "2026-04-07T03:06:19.249Z",
      "description": "Machine learning researcher, alignment-accelerationist, Fedorovist ancestor simulator, Dreamtime enjoyer. \n\nAll posts public domain under CC0 1.0.",
      "displayName": "John David Pressman"
    },
    {
      "did": "did:plc:ps54mz3jlmxpiqw2xqvn66oc",
      "url": "https://bsky.app/profile/vagabond.quest",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ps54mz3jlmxpiqw2xqvn66oc/bafkreidnfgqwoc65x6ehyjwlkjllrudogf3knh2wqmlg7x6qwu7kmq4sou",
      "handle": "vagabond.quest",
      "createdAt": "2025-01-31T16:54:43.644Z",
      "indexedAt": "2026-04-14T04:02:32.346Z",
      "description": "Votre homme dans ville et l'elú de Saint-Soûlard.\n\n🚶‍♂️ vagabond.quest | 🎲 rpg.actor",
      "displayName": "Cousin Vagabond"
    }
  ],
  "hasMore": true,
  "subject": {
    "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
    "url": "https://bsky.app/profile/pfrazee.com",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq",
    "handle": "pfrazee.com",
    "createdAt": "2022-11-17T00:35:16.391Z",
    "indexedAt": "2026-02-09T17:34:52.546Z",
    "description": "CTO at Bluesky. Not a nerd.",
    "displayName": "Paul Frazee"
  }
}

GETGet Post Thread/v1/social-media:bluesky/postSatu postingan Bluesky beserta balasannya.

Parameters

urlstringrequired: Post URL, or an at:// URI
depthnumberoptional: Reply nesting depth. Default 1, max 2 — deeper does not return more replies

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/post?url=https%3A%2F%2Fbsky.app%2Fprofile%2Fjay.bsky.team%2Fpost%2F3lbxyz&depth=1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "post": {
    "cid": "bafyreiecjvmkj7tjmtiao5pqvunguiw3ggdweirg32nksimfd4pbhkso64",
    "uri": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3msfblue7uc2e",
    "lang": "en",
    "author": {
      "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq",
      "handle": "pfrazee.com",
      "displayName": "Paul Frazee"
    },
    "createdAt": "2026-08-06T05:09:14.843Z",
    "indexedAt": "2026-08-06T05:09:16.969Z",
    "likeCount": 28,
    "quoteCount": 0,
    "replyCount": 0,
    "repostCount": 0
  },
  "replies": [],
  "repliesReturned": 0
}

{ "ok": true, "posts": [ { "cid": "bafyreietolc66j77ylzxpqpuygfhgu435trzl5faskqzvguhorqiu5vhuy", "uri": "at://did:plc:mklohhw3fghtcsutnemlbimm/app.bsky.feed.post/3mltifjh2522v", "text": "shared some thoughts on building with @attie.ai and why I'm so excited\n\nblockchaincapital.com/blog/after-t...", "author": { "did": "did:plc:mklohhw3fghtcsutnemlbimm", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mklohhw3fghtcsutnemlbimm/bafkreicuzzvfwcxmakkydv3zdi7yjzbbdwkjeyeucryns267yngl7mlbxi", "handle": "kinjal.bsky.social", "displayName": "Kinjal" }, "repost": true, "createdAt": "2026-05-14T18:51:53.213Z", "indexedAt": "2026-05-14T18:51:54.567Z", "likeCount": 58, "quoteCount": 5, "replyCount": 9, "repostCount": 6 }, { "cid": "bafyreidyvnczi37omokdajwripxkc6xd4mlsttp7g3ex7tcqeui7yacn2m", "uri": "at://did:plc:2gkh62xvzokhlf6li4ol3b3d/app.bsky.feed.post/3mltfz6cvic2o", "text": "I'll go against the discourse. 280 contributors to repo.npmx.dev in 100 days. We only used bluesky for social comms. We asked while welcoming folks, and most of them got involved a…", "author": { "did": "did:plc:2gkh62xvzokhlf6li4ol3b3d", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2gkh62xvzokhlf6li4ol3b3d/bafkreibi7rw745tbcea7ljrpbkkkoragy2xa5a2lrxhdb3m23s7n3wkv3q", "handle": "patak.cat", "displayName": "patak" }, "repost": true, "createdAt": "2026-05-14T18:09:11.404Z", "indexedAt": "2026-05-14T18:09:12.468Z", "likeCount": 180, "quoteCount": 2, "replyCount": 4, "repostCount": 19 } ], "profile": { "did": "did:plc:oky5czdrnfjpqslsw2a5iclo", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da", "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreicgnmvhtmj4arcvwhueygbwvkucd3odvom3lxtfmn6wlqbh3yf7p4", "handle": "jay.bsky.team", "createdAt": "2022-11-17T06:31:40.296Z", "indexedAt": "2026-03-29T21:16:33.460Z", "postsCount": 4095, "description": "Founder & Chief Innovation Officer @ Bluesky\n\nWorking on @attie.ai\n\n🌱 🪴 🌳", "displayName": "Jay 🦋", "followsCount": 3966, "followersCount": 595946 } }

// npm i zpi-sdk import { ZpiClient } from "zpi-sdk"; const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" }); const data = await client.run("social-media:bluesky", "profile", { "handle": "jay.bsky.team" }); console.log(data);

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/download?url=https%3A%2F%2Fbsky.app%2Fprofile%2Falexbenzer.com%2Fpost%2F3mloibwobns2b&quality=1080&audioOnly=false&audioFormat=mp3" \ -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

{ "ok": true, "count": 10, "trends": [ { "link": "/profile/trending.bsky.app/feed/821037737", "topic": "clacton", "actors": [ { "did": "did:plc:qosd44nwnujay5zbmg2q3p7q", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:qosd44nwnujay5zbmg2q3p7q/bafkreiek4fk2jwjyjmfquw7xumboxqksygxovhtwc3cvpa7tkzbgo5arie", "handle": "countbinface.bsky.social", "displayName": "Count Binface" }, { "did": "did:plc:fz5yyztrodsbmpx2lm33iamd", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:fz5yyztrodsbmpx2lm33iamd/bafkreigovte2wz5jayzga6nrrtkyt5f45fh6jekgfzcgwlcjcimqwukbli", "handle": "douglasireland.com", "displayName": "Douglas Ireland ✊🌱" } ], "status": "hot", "category": "politics", "postCount": 124, "startedAt": "2026-08-06T10:41:34.10392Z", "displayName": "Clacton By-Election" }, { "link": "/profile/trending.bsky.app/feed/821012904", "topic": "ukraine", "actors": [ { "did": "did:plc:4aqzua5vsewimmusg66fyajl", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:4aqzua5vsewimmusg66fyajl/bafkreiacwznbgisutpt6s7wtwwqjg7t6ta6tn2onognya27y3lv7snomzu", "handle": "noelreports.com", "displayName": "NOELREPORTS" }, { "did": "did:plc:6y3honhec2jch2ryrbuyx5a5", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:6y3honhec2jch2ryrbuyx5a5/bafkreiaxheuelonc6ngwflm43jyexf7cqcs56bcdfiv2to77rrxbfvmh4e", "handle": "maks23.bsky.social", "displayName": "MAKS 26 👀🇺🇦" } ], "category": "politics", "postCount": 466, "startedAt": "2026-08-06T09:45:33.803142Z", "displayName": "Ukraine" } ] }

curl -X GET "https://api.zpi.web.id/v1/social-media:bluesky/search-posts?q=rust+programming&limit=25&sort=latest&lang=id&author=jay.bsky.team&since=2026-08-01&until=2026-08-06" \ -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

{ "ok": true, "sort": "top", "count": 25, "posts": [ { "cid": "bafyreifjjuhrtmuzv73ifn7mbkanffue5qjwsywyuk7cihellay4zvga7e", "uri": "at://did:plc:sfvpv6dfrug3rnjewn7gyx62/app.bsky.feed.post/3mbfzft2rp22c", "lang": "en", "text": "the kids, they know how to name libraries. \n\nwww.reddit.com/r/rust/comme...", "author": { "did": "did:plc:sfvpv6dfrug3rnjewn7gyx62", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:sfvpv6dfrug3rnjewn7gyx62/bafkreibcxpht7zihliq7kgu3fnlfqlqdpievvljttuvulcsjxar6csnqxy", "handle": "buttplug.engineer", "displayName": "qdot" }, "createdAt": "2026-01-02T04:07:04.291Z", "indexedAt": "2026-01-02T04:07:05.733Z", "likeCount": 1182, "quoteCount": 24, "replyCount": 26, "repostCount": 317 }, { "cid": "bafyreihufjznst6mu5udqlwidqotvqrdnekpxddngsnif5cna477l4ylsm", "uri": "at://did:plc:7tiia5rclvwibxngh7mvrlsw/app.bsky.feed.post/3lvjofku3e22n", "lang": "en", "text": "trying to shake off the rust", "author": { "did": "did:plc:7tiia5rclvwibxngh7mvrlsw", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:7tiia5rclvwibxngh7mvrlsw/bafkreig5qbte6ktepgmoftxy2xt5r62jz3gda4vn6pxfp2s2ppuz6ooct4", "handle": "angusburgers.bsky.social", "displayName": "Dani(They/Them)- Comms reopening AUGUST 10" }, "createdAt": "2025-08-03T21:58:23.921Z", "indexedAt": "2025-08-03T21:58:25.707Z", "likeCount": 1250, "quoteCount": 0, "replyCount": 11, "repostCount": 209 }, { "cid": "bafyreiahiqzcsmifttgwfon3rvto6xp7qgzv5fpllzj5zxqqpg2o7bajwy", "uri": "at://did:plc:wamidydbgu3u6fk3yckaglnz/app.bsky.feed.post/3mscxgjywgk2i", "lang": "en", "text": "fair enough. can't personally argue with this as a dividing line blog.rust-lang.org/inside-rust/...", "author": { "did": "did:plc:wamidydbgu3u6fk3yckaglnz", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:wamidydbgu3u6fk3yckaglnz/bafkreibmakekm64poceaubjq7uvvafbyqgp5wjllpg3ijvhhohl22nmi3m", "handle": "philpax.me", "displayName": "philpax" }, "createdAt": "2026-08-05T07:01:59.323Z", "indexedAt": "2026-08-05T07:02:01.065Z", "likeCount": 61, "quoteCount": 2, "replyCount": 3, "repostCount": 2 } ], "query": "rust", "total": 10000, "totalIsCapped": true }

{ "ok": true, "count": 24, "query": "nasa", "users": [ { "did": "did:plc:ocmyknbwkxjyjkactio272im", "url": "https://bsky.app/profile/nasawebb.extwitter.link", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ocmyknbwkxjyjkactio272im/bafkreich4qumrtdmi7xcffg3bqquyijspjftc7ejaaodbujqyoo5lyagcu", "handle": "nasawebb.extwitter.link", "createdAt": "2024-02-22T17:10:21.640Z", "indexedAt": "2026-03-30T15:37:13.249Z", "description": "⚠️ MIRROR OF twitter.com/NASAWebb\n⚠️ If you own the original account and want to claim this, please contact @twttr-mirrors.bsky.social", "displayName": "NASA Webb Telescope" }, { "did": "did:plc:6udbhveni6zbejqdt5ancvkr", "url": "https://bsky.app/profile/uahirise.bsky.social", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:6udbhveni6zbejqdt5ancvkr/bafkreicu6s4y4e4nopdrbilvchfij4ar3t2nil4f7ctur67q7ktsdy3n3m", "handle": "uahirise.bsky.social", "createdAt": "2023-10-17T23:54:39.050Z", "indexedAt": "2025-10-01T20:33:55.048Z", "description": "Images from the High Resolution Imaging Science Experiment (HiRISE) on board the Mars Reconnaissance Orbiter (NASA). We are based out of the Lunar and Planetary Laboratory at the U…", "displayName": "HiRISE Beautiful Mars (NASA)" }, { "did": "did:plc:ppstkwdiil3qysaerqwtbl2p", "url": "https://bsky.app/profile/nasawatch.bsky.social", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ppstkwdiil3qysaerqwtbl2p/bafkreihpdfchkm3kmauuvbltmrsks5zmrvlogv2z36w5gp3cbluifvwq2y", "handle": "nasawatch.bsky.social", "createdAt": "2023-09-26T00:58:53.168Z", "indexedAt": "2026-08-05T19:52:28.061Z", "description": "NASAWATCH.com - Unofficial Space News Since 1996", "displayName": "NASAWATCH" } ], "cursor": "eyJzIjpbMTAwMCw0LjM2OTU3OWUtOCwiZGlkOnBsYzpnN2V5ZndtN2Q3bmVjYXZnb3Rrbmk1bGsiXX0", "hasMore": true }

{ "ok": true, "count": 43, "cursor": "3msdvxuj3kh26", "hasMore": true, "subject": { "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd", "url": "https://bsky.app/profile/pfrazee.com", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq", "handle": "pfrazee.com", "createdAt": "2022-11-17T00:35:16.391Z", "indexedAt": "2026-02-09T17:34:52.546Z", "description": "CTO at Bluesky. Not a nerd.", "displayName": "Paul Frazee" }, "followers": [ { "did": "did:plc:mz4m6yo275wmhyjucq5n4cgu", "url": "https://bsky.app/profile/justmask.bsky.social", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mz4m6yo275wmhyjucq5n4cgu/bafkreiav7qlbxnj57z3mlczkdlnhcdv7kpv7g73ecyyyq6q6uqdwyulrfu", "handle": "justmask.bsky.social", "createdAt": "2025-04-04T20:57:25.295Z", "indexedAt": "2025-04-16T12:06:47.974Z", "displayName": "Mask" }, { "did": "did:plc:asodcn76lcar32eawgwza3os", "url": "https://bsky.app/profile/yankeemorla.bsky.social", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:asodcn76lcar32eawgwza3os/bafkreihdu7svdmxxke2j3uowr5kvyswa4tkbsfqzgn555hiiddbkh4wpaq", "handle": "yankeemorla.bsky.social", "createdAt": "2026-05-31T18:09:51.260Z", "indexedAt": "2026-06-02T13:47:25.361Z", "description": "Fundador de Conditec SRL 🇩🇴\nSoftware a medida + IA aplicada para empresas reales.\nConstruyo en público: MCP, Claude, agentes y automatización.\nComparto casos.\n\n→ conditecrd.com", "displayName": "Jean Carlos Morla · Conditec" }, { "did": "did:plc:heffi4e2idq23rti57vbonjn", "url": "https://bsky.app/profile/raynabrown1.bsky.social", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:heffi4e2idq23rti57vbonjn/bafkreiew2lnzq2uba57uv5v6xe45g2uuypj6iciwsygj2fgkwsb27m3fkq", "handle": "raynabrown1.bsky.social", "createdAt": "2026-08-06T03:31:04.769Z", "indexedAt": "2026-08-06T07:21:33.663Z", "description": "This is a backup account of Trans Gender Candy gracy. Follow me up here. i will also follow you", "displayName": "TR Grace" } ] }

{ "ok": true, "count": 50, "cursor": "3mke3l7ulrc2t", "follows": [ { "did": "did:plc:klhtmrnregub7we7h6jwiljm", "url": "https://bsky.app/profile/ed3d.net", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:klhtmrnregub7we7h6jwiljm/bafkreiax76tzue7jcdk44ug6vv62ikttoq4c3waolhs2lo3yih6vdoje4a", "handle": "ed3d.net", "createdAt": "2023-04-27T23:01:37.442Z", "indexedAt": "2026-08-03T01:41:34.659Z", "description": "Main Character Syndrome, but fun. Boston-based. My wood shop and my dogs are my personality. If you're still reading this, I'm your dad now. Sorry, I don't make the rules.\n\nI don't…", "displayName": "Ed" }, { "did": "did:plc:5hhbgkktcpofpw4ovz6kjjau", "url": "https://bsky.app/profile/jdp.extropian.net", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:5hhbgkktcpofpw4ovz6kjjau/bafkreignnoa2x3p27l2xsbcy56tk5eljpvnc6qcehavb7klfzhrvjadkhu", "handle": "jdp.extropian.net", "createdAt": "2023-04-09T21:59:36.855Z", "indexedAt": "2026-04-07T03:06:19.249Z", "description": "Machine learning researcher, alignment-accelerationist, Fedorovist ancestor simulator, Dreamtime enjoyer. \n\nAll posts public domain under CC0 1.0.", "displayName": "John David Pressman" }, { "did": "did:plc:ps54mz3jlmxpiqw2xqvn66oc", "url": "https://bsky.app/profile/vagabond.quest", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ps54mz3jlmxpiqw2xqvn66oc/bafkreidnfgqwoc65x6ehyjwlkjllrudogf3knh2wqmlg7x6qwu7kmq4sou", "handle": "vagabond.quest", "createdAt": "2025-01-31T16:54:43.644Z", "indexedAt": "2026-04-14T04:02:32.346Z", "description": "Votre homme dans ville et l'elú de Saint-Soûlard.\n\n🚶‍♂️ vagabond.quest | 🎲 rpg.actor", "displayName": "Cousin Vagabond" } ], "hasMore": true, "subject": { "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd", "url": "https://bsky.app/profile/pfrazee.com", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq", "handle": "pfrazee.com", "createdAt": "2022-11-17T00:35:16.391Z", "indexedAt": "2026-02-09T17:34:52.546Z", "description": "CTO at Bluesky. Not a nerd.", "displayName": "Paul Frazee" } }

{ "ok": true, "post": { "cid": "bafyreiecjvmkj7tjmtiao5pqvunguiw3ggdweirg32nksimfd4pbhkso64", "uri": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3msfblue7uc2e", "lang": "en", "author": { "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd", "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq", "handle": "pfrazee.com", "displayName": "Paul Frazee" }, "createdAt": "2026-08-06T05:09:14.843Z", "indexedAt": "2026-08-06T05:09:16.969Z", "likeCount": 28, "quoteCount": 0, "replyCount": 0, "repostCount": 0 }, "replies": [], "repliesReturned": 0 }

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

TikTok Scraper

Instagram Scraper

Youtube Scraper

GitHub User

Kaskus

Telegram Channel

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

TikTok Scraper

Instagram Scraper

Youtube Scraper

GitHub User

Kaskus

Telegram Channel