Social media scraping API. One POST request, clean JSON back.

How the Bridgly REST API works

The API has one shape for everything. You pick an endpoint, such as /linkedin/get-profile-from-url or /x/get-user-tweets, send its input as a JSON body, and receive the data. There is no OAuth app to register with LinkedIn, X or Reddit, no developer account approval and no per-platform rate card. One Bridgly key covers every platform.

Call the API from JavaScript

Any HTTP client works. This example uses the built-in fetch in Node.js to read a LinkedIn profile. Keep the key on the server: anyone holding it can spend your credits.

const res = await fetch(
  "https://api.bridgly.app/linkedin/get-profile-from-url",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BRIDGLY_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ memberIdentity: "satya-nadella" }),
  },
);
if (!res.ok) throw new Error(`Bridgly ${res.status}`);
const { data, creditsCost } = await res.json();
console.log(data.headline, creditsCost);

Writing TypeScript? The TypeScript SDK wraps these same endpoints with typed inputs, typed results, automatic pagination and rate-limit retries.

Call the API from Python

There is nothing to install beyond an HTTP library. Here requests pulls the newest posts of a subreddit.

import os
import requests
r = requests.post(
    "https://api.bridgly.app/reddit/list-subreddit-posts",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_API_KEY']}"},
    json={"subreddit": "programming", "sort": "new", "count": 10},
    timeout=60,
)
r.raise_for_status()
for post in r.json()["data"]["posts"]:
    print(post["title"])

Paginate through results

List endpoints return one page at a time. count sets the page size where an endpoint takes it, and nextCursor points at the next page. Loop until nextCursor is null: a page can hold fewer results than count and still have more after it.

let cursor;
do {
  const res = await fetch("https://api.bridgly.app/x/get-followers", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BRIDGLY_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ userId: "44196397", cursor }),
  });
  const { data } = await res.json();
  console.log(data.users.length);
  cursor = data.nextCursor ?? undefined;
} while (cursor);

Errors and status codes

Errors use one body, { "status": "error", "message": "..." }, and the HTTP status tells you what happened. Branch on the status, not the message text.

Rate limits

Limits apply per platform and are shared by every key on your account, so a LinkedIn burst never slows down your Reddit calls. The standard limit is 2 requests per second and 80 per minute per platform. Larger credit purchases raise it to 5 per second (Growth) or 25 per second (Scale). Every response carries X-RateLimit-Limit and X-RateLimit-Remaining, and a 429 carries Retry-After. Rejected requests cost no credits. See pricing for the tiers.