# Stackshare Posts

## Overview

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

## Description

Extract key insights from Stackshare posts for tech trends, market analysis, and competitive intelligence with our 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/stackshare/posts' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "data": {
    "posts": [
      {
        "url": "https://stackshare.io/posts/python-vs-java",
        "date": "2023-02-15",
        "title": "Python vs Java: Battle of Popularity",
        "author": "Amanda Smith",
        "content_snippet": "Python and Java are two powerful programming languages..."
      },
      {
        "url": "https://stackshare.io/posts/top-python-libraries",
        "date": "2023-01-10",
        "title": "Top 10 Python Libraries in 2023",
        "author": "John Doe",
        "content_snippet": "Discover the most popular Python libraries used by developers..."
      },
      {
        "url": "https://stackshare.io/posts/get-started-with-django",
        "date": "2022-11-20",
        "title": "How to Get Started with Django",
        "author": "Emily Johnson",
        "content_snippet": "Django is a high-level Python web framework that encourages rapid development..."
      }
    ]
  },
  "status": "success"
}
```

## Documentation

## Overview
Extract key insights from Stackshare posts for tech trends, market analysis, and competitive intelligence with our API.

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

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

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