Quickstart - Bridgly

1. Get an API key

Sign in to your Bridgly dashboard, open the API Keys page, and click Create key. Copy the key that appears — it starts with bgly_ and is shown only once.

Store the key somewhere safe the moment you create it. For security we only keep a hashed version, so it can never be shown again. If you lose it, revoke it and create a new one.

2. Make your first call

Every scraping endpoint is a POST that takes a JSON body and returns JSON. Send your key in the Authorization header as a bearer token.

curl https://api.bridgly.app/reddit/get-user \
  -H "Authorization: Bearer bgly_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "username": "spez" }'

const res = await fetch('https://api.bridgly.app/reddit/get-user', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer bgly_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ username: 'spez' }),
});

const { data } = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://api.bridgly.app/reddit/get-user",
    headers={"Authorization": "Bearer bgly_your_api_key"},
    json={"username": "spez"},
)

print(res.json()["data"])

3. Read the response

Every successful scraping response wraps your result in the same envelope. The scraped data is always in data; timeMs and creditsCost tell you how long the call took and what it cost. This example uses illustrative values:

{
  "timeMs": 842,
  "creditsCost": 1,
  "data": {
    "id": "1",
    "username": "spez",
    "profileUrl": "https://www.reddit.com/user/spez/",
    "commentKarma": 123456,
    "linkKarma": 7890,
    "createdUtc": 1118030400,
    "iconUrl": null,
    "isGold": false,
    "isMod": false,
    "isEmployee": true,
    "verified": true,
    "hasVerifiedEmail": true,
    "acceptFollowers": true
  }
}

Try other platforms

Swap the URL and body for any endpoint. A few to get you started:

curl https://api.bridgly.app/linkedin/get-profile-from-url \
  -H "Authorization: Bearer bgly_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "memberIdentity": "williamhgates" }'

curl https://api.bridgly.app/x/search \
  -H "Authorization: Bearer bgly_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "query": "openai lang:en" }'

curl https://api.bridgly.app/reddit/get-post \
  -H "Authorization: Bearer bgly_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.reddit.com/r/programming/comments/abc123/" }'

Next steps

Browse every endpoint

See each request schema and try calls live in the playground.

Understand responses

The envelope, credit costs, and how errors are reported.

Rate limits

Default limits and how to handle a 429 response.

​1. Get an API key

​2. Make your first call

​3. Read the response

​Try other platforms

​Next steps

Browse every endpoint

Understand responses

Rate limits

1. Get an API key

2. Make your first call

3. Read the response

Try other platforms

Next steps