Search Reddit posts, subreddits and users
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.reddit.search({ query: "typescript" });
console.log(result.data.results);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.reddit.search(query="typescript")
print(result["data"]["results"])
curl -X POST https://api.stophy.dev/v1/reddit/search \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"query":"typescript"}'
stophy reddit search typescript
{
"success": true,
"data": {
"results": [
{
"type": "post",
"postId": "abc123",
"postUrl": "https://example.com/",
"title": "Example title",
"text": "A short, readable summary of the result.",
"authorId": "abc123",
"authorUsername": "example",
"authorUrl": "https://example.com/",
"subreddit": "example",
"score": 4.5,
"upvotePercent": 1,
"comments": 1,
"publishedAt": "2026-09-28T12:00:00.000Z",
"flair": "example",
"linkUrl": "https://example.com/",
"thumbnailUrl": "https://example.com/image.jpg",
"isNsfw": false,
"isVideo": false,
"isPinned": false,
"imageUrls": [
"https://example.com/image.jpg"
],
"videoUrl": "https://example.com/",
"videoHlsUrl": "https://example.com/",
"videoDurationSeconds": 120,
"pollOptions": [
{
"text": "A short, readable summary of the result.",
"votes": 1
}
],
"pollTotalVotes": 1234,
"pollEndsAt": "2026-09-28T12:00:00.000Z",
"repostOfUrl": "https://example.com/"
}
]
},
"creditsUsed": 1,
"requestId": "88a2ad5a-4f37-426f-896f-bf70f9450877"
}
Endpoints
More ways to call it
Get a profile’s bio, stats and a page of its posts and reels
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.instagram.profile({ username: "natgeo" });
console.log(result.data.results);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.instagram.profile(username="natgeo")
print(result["data"]["results"])
curl -X POST https://api.stophy.dev/v1/instagram/profile \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"username":"natgeo"}'
stophy instagram profile --username natgeo
Get a person’s profile
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.linkedin.profile({ profileId: "satyanadella" });
console.log(result.data);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.linkedin.profile(profile_id="satyanadella")
print(result["data"])
curl -X POST https://api.stophy.dev/v1/linkedin/profile \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"profileId":"satyanadella"}'
stophy linkedin profile --profileId satyanadella
Reddit search works without a key. Instagram profile and LinkedIn profile cost 2 credits. Endpoints that return a
cursor or a page page. See Page through results.