Reddit Subreddit Search
Find subreddits by keyword - name, description, subscriber count, NSFW and quarantine flags, icon and URL - with cursor pagination, as JSON. Costs 1 credit per request.
POST/api/v1/reddit/search/subreddits
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredSearch keywords, up to 500 characters.
Example: web scraping
cursorstringPagination cursor from a previous response (next_cursor). Keep passing it while has_more is true.
Notes
Pass a name to Subreddit Info or Subreddit Posts. About 10 results per page.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.reddit.search_subreddits(query="web scraping")
print(results)Response
"next_cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIwXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfMF9zdWJyZWRkaXRfc2VhcmNoXCI6XCIxMFwifSIsImV4cGVyaWVuY2Vfc2VsZWN0aW9uIjoiY29tbXVuaXR5IiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVmYXVsdCIsInNlY3Rpb25fMl9waXBlbGluZV8wX3N1YnJlZGRpdF9zZWFyY2giOiIxMCJ9",
"has_more": true
},
"response_time": 4174
}