Scrape social media from the command line.

Command reference

Export social media data to CSV

CSV and table output render the data of the response. A list becomes one row per item. If the result holds exactly one list, such as posts or users, that list becomes the rows. Nested objects become dotted columns like author.username, so the file opens cleanly in Excel, Numbers or Google Sheets.

# Latest posts of a subreddit, as a spreadsheet
bridgly reddit list-subreddit-posts --subreddit startups --sort top --output startups.csv
# A LinkedIn company page, as a readable table
bridgly linkedin get-company-from-url --universal-name microsoft --format table
# An X profile, as JSON on disk
bridgly x get-user --handle nasa --output nasa.json

Pass arrays, objects and booleans

Flags use kebab-case, and the original camelCase field names work too. Arrays take several values or a JSON array, nested objects take JSON or dotted flags, and a bare boolean flag means true.

bridgly github search-repositories --owners openai microsoft --topics ai
bridgly github search-repositories --stars.gte 100 --stars.lte 1000
bridgly github search-repositories --language TypeScript --archived false

Pipe JSON into jq

JSON is the default output and keeps the full envelope, including creditsCost and timeMs. Because only results go to stdout, piping works without extra flags.

bridgly reddit get-user --username spez | jq '.data.linkKarma'
bridgly x get-user --handle nasa | jq -r '.data.followerCount'

Use it in scripts, cron and CI

On servers and in CI, set BRIDGLY_API_KEY from your secret manager instead of logging in. The key is picked in this order: --api-key, then BRIDGLY_API_KEY, then the saved login. Each command makes exactly one request, with no hidden retries or pagination, so a scheduled job never spends more than you expect.

#!/usr/bin/env bash
set -euo pipefail
export BRIDGLY_API_KEY="$BRIDGLY_API_KEY"
date=$(date +%F)
bridgly reddit search-posts --query "your brand" --output "mentions/$date.csv"