# Reddit Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/reddit/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/reddit-search |

## Description

Extract Rocket League subreddit data for real-time insights, market analysis, and user engagement with our Reddit Search API.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/reddit/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "data": [
    {
      "url": "https://www.reddit.com/r/RocketLeague/comments/example1",
      "title": "New Season Launch",
      "author": "user123",
      "upvotes": 452,
      "comments": 78,
      "created_at": "2023-10-01T12:34:56Z"
    },
    {
      "url": "https://www.reddit.com/r/RocketLeague/comments/example2",
      "title": "Best Goals Compilation",
      "author": "soccerfan99",
      "upvotes": 348,
      "comments": 56,
      "created_at": "2023-10-02T09:21:43Z"
    },
    {
      "url": "https://www.reddit.com/r/RocketLeague/comments/example3",
      "title": "Looking for Teammate",
      "author": "gamer_dude",
      "upvotes": 123,
      "comments": 34,
      "created_at": "2023-10-03T15:22:22Z"
    },
    {
      "url": "https://www.reddit.com/r/RocketLeague/comments/example4",
      "title": "Tips for New Players?",
      "author": "helpinghand",
      "upvotes": 278,
      "comments": 67,
      "created_at": "2023-10-04T08:19:01Z"
    }
  ],
  "status": "success"
}
```

## Documentation

## Overview
Extract Rocket League subreddit data for real-time insights, market analysis, and user engagement with our Reddit Search API.

## Quickstart
```
GET https://api.piloterr.com/v2/reddit/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Reddit Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Reddit without maintaining scrapers
- Power internal dashboards and workflow automations with live Reddit data