# StackShare Search

## Overview

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

## Description

Extract detailed tech stack data from StackShare, including usage, popularity, and tools, with Piloterr's 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/stackshare/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "tags": [
    {
      "name": "general-purpose",
      "followers": 2552
    },
    {
      "name": "programming-language",
      "followers": 1887
    },
    {
      "name": "easy-to-learn",
      "followers": 1501
    },
    {
      "name": "interpreted-language",
      "followers": 1379
    },
    {
      "name": "object-oriented",
      "followers": 1012
    }
  ],
  "title": "Python",
  "stacks": [
    {
      "url": "https://udemy.com",
      "name": "Udemy",
      "description": "Online courses and tutorials"
    },
    {
      "url": "https://instagram.com",
      "name": "Instagram",
      "description": "Instagram is a video-sharing app for iOS, Android, and Windows Phone."
    },
    {
      "url": "https://spotify.com",
      "name": "Spotify",
      "description": "Spotify is a commercial music streaming service."
    },
    {
      "url": "https://reddit.com",
      "name": "Reddit",
      "description": "Reddit is a social news aggregation, web content rating, and discussion website."
    }
  ],
  "overview": {
    "rank": 1,
    "stacks": 132985,
    "upvotes": 20785,
    "followers": 2552
  },
  "categories": [
    "Languages"
  ],
  "description": "Python is a programming language that lets you work more quickly and integrate your systems more effectively."
}
```

## Documentation

## Overview
Extract detailed tech stack data from StackShare, including usage, popularity, and tools, with Piloterr's Search API.

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

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

## Main use cases
- Integrate StackShare Search 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