Search Reddit posts, comments, 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",
"id": "abc123",
"url": "https://example.com/",
"title": "Example title",
"text": "A short, readable summary of the result.",
"author": {
"id": "abc123",
"username": "example",
"name": "Example title",
"url": "https://example.com/",
"avatar": "https://example.com/image.jpg",
"isVerified": false
},
"subreddit": "example",
"score": 4.5,
"upvotePercent": 1,
"comments": 1,
"createdAt": "2026-09-28T12:00:00.000Z",
"flair": "example",
"link": {
"url": "https://example.com/",
"title": "Example title",
"description": "A short, readable summary of the result.",
"image": "https://example.com/image.jpg"
},
"thumbnail": "https://example.com/image.jpg",
"isNsfw": false,
"isVideo": false,
"isPinned": false,
"images": [
{
"url": "https://example.com/",
"caption": "example",
"alt": "example"
}
],
"video": {
"url": "https://example.com/",
"hls": "https://example.com/",
"durationSeconds": 120
},
"poll": {
"options": [
{
"text": "A short, readable summary of the result.",
"votes": 1
}
],
"totalVotes": 1234,
"endsAt": "2026-09-28T12:00:00.000Z"
},
"repostOf": {
"id": "abc123",
"url": "https://example.com/",
"subreddit": "example",
"title": "Example title"
}
}
]
},
"creditsUsed": 2,
"requestId": "cd4daa30-af72-4522-a14d-98fa6f73196a"
}
Endpoints
More ways to call it
Get a profile’s bio, stats and recent posts
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.instagram.profile({ user: "natgeo" });
console.log(result.data.profile);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.instagram.profile(user="natgeo")
print(result["data"]["profile"])
curl -X POST https://api.stophy.dev/v1/instagram/profile \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"user":"natgeo"}'
stophy instagram profile natgeo
Get a post’s text, author and stats
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.x.tweet({ tweet: "https://x.com/jack/status/20" });
console.log(result.data.tweet);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.x.tweet(tweet="https://x.com/jack/status/20")
print(result["data"]["tweet"])
curl -X POST https://api.stophy.dev/v1/x/tweet \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"tweet":"https://x.com/jack/status/20"}'
stophy x tweet https://x.com/jack/status/20
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({ profile: "satyanadella" });
console.log(result.data.profile);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.linkedin.profile(profile="satyanadella")
print(result["data"]["profile"])
curl -X POST https://api.stophy.dev/v1/linkedin/profile \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"profile":"satyanadella"}'
stophy linkedin profile satyanadella
Endpoints that return a list, like Reddit search and Instagram posts, page. See Page through results.