crawlbaseДокументация
Войти

Использование API

Добавьте &scraper=reddit-serp к запросу Crawling API. URL-кодируйте целевой URL в параметре url.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://www.reddit.com/search/?q=web+scraping' \
  --data-urlencode 'scraper=reddit-serp' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.reddit.com/search/?q=web+scraping',
    {'scraper': 'reddit-serp'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://www.reddit.com/search/?q=web+scraping',
  { scraper: 'reddit-serp' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.reddit.com/search/?q=web+scraping', scraper: 'reddit-serp')
data = JSON.parse(res.body)

Пример входного URL

URL, передаваемый в параметре url (URL-декодированный для удобства чтения):

https://www.reddit.com/search/?q=web+scraping

Структура ответа

Тело ответа в формате JSON. Типы полей могут быть null, если исходная страница не содержит значения.

query
string
Поисковый запрос, по которому получены эти результаты.
sort
string
Порядок сортировки, применённый к поиску (например, relevance, new, top).
time
string
Временное окно, применённое к поиску (например, all, day, week).
restrictSubreddit
boolean
True, если поиск был ограничен одним сабреддитом.
resultCount
integer
Количество результатов, возвращённых в results.
pagination
object
Курсор пагинации для следующей и предыдущей страниц.
pagination.next_page_url
string | null
URL следующей страницы результатов или null на последней странице.
pagination.previous_page_url
string | null
URL предыдущей страницы результатов или null на первой странице.
pagination.has_next
boolean
True, если доступна следующая страница.
results
array
Результаты поиска, в ранжированном порядке.
results[].position
integer
Позиция результата в возвращённом списке (начиная с 1).
results[].id
string
Полное имя (fullname) поста в Reddit (например, t3_...).
results[].title
string
Заголовок поста.
results[].url
string
URL результата в Reddit.
results[].author
string
Имя пользователя автора поста.
results[].subreddit
string
Сабреддит, которому принадлежит пост (без префикса r/).
results[].score
integer
Счёт поста (плюсы минус минусы).
results[].commentsCount
integer
Количество комментариев к посту.
results[].createdAt
string
Время создания поста (ISO 8601).
results[].linkUrl
string
Внешняя ссылка, на которую указывает пост.
results[].domain
string
Домен внешней ссылки.
subreddits
array
Связанные сабреддиты, показанные рядом с результатами.
subreddits[].name
string
Название сабреддита (без префикса r/).
subreddits[].url
string
Канонический URL сабреддита.
subreddits[].subscribers
integer | null
Количество подписчиков сабреддита.
subreddits[].description
string | null
Краткое описание сабреддита.

Пример ответа

{
  "query": "web scraping",
  "sort": "relevance",
  "time": "all",
  "restrictSubreddit": false,
  "resultCount": 2,
  "pagination": {
    "next_page_url": "https://old.reddit.com/search?q=web+scraping&count=25&after=t3_1c7aaaa",
    "previous_page_url": null,
    "has_next": true
  },
  "results": [
    {
      "position": 1,
      "id": "t3_1c7aaaa",
      "title": "What is the most reliable way to do web scraping at scale in 2026?",
      "url": "https://old.reddit.com/r/webdev/comments/1c7aaaa/what_is_the_most_reliable_way_to_do_web_scraping/",
      "author": "datawrangler",
      "subreddit": "webdev",
      "score": 486,
      "commentsCount": 133,
      "createdAt": "2026-06-30T14:22:10+00:00",
      "linkUrl": "https://old.reddit.com/r/webdev/comments/1c7aaaa/what_is_the_most_reliable_way_to_do_web_scraping/",
      "domain": "old.reddit.com"
    }
  ],
  "subreddits": [
    {
      "name": "webscraping",
      "url": "https://old.reddit.com/r/webscraping/",
      "subscribers": 84210,
      "description": "A community for web scraping, crawling and data extraction."
    }
  ]
}