# Explodingtopics — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover rapidly growing trends, emerging startups, and top-performing websites by filtering through trending topics by category and volatility. Programmatically access detailed trend analysis, related topics, blog coverage, and curated highlights to stay ahead of market movements.

**Category:** Business Directories | **Website:** [explodingtopics.com/](https://explodingtopics.com/) | **Docs:** [parse.bot/marketplace/f7a56941-cfc0-4b41-bbbc-22a1445f3530/explodingtopics-com-api](https://parse.bot/marketplace/f7a56941-cfc0-4b41-bbbc-22a1445f3530/explodingtopics-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_blog_posts

Get blog posts from the Exploding Topics blog. Returns an array of published blog posts with title, slug, body (HTML), summary, featured image, and publication dates. Includes pagination metadata (count, next_page, previous_page). The tag parameter is accepted but tag-based filtering is no longer supported upstream; all posts are returned regardless of tag value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tag` | string | No | Blog tag filter (accepted for compatibility but no longer applied by the upstream source). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag":"<string>"}'
```

### get_categories

Returns all topic category names mapped to their topic counts. The response is a flat object whose keys are category slugs and whose values are integers (topic counts), plus a lastUpdated Unix timestamp. Use these category names as filter values in get_trending_topics.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_home_highlights

Get a snapshot of top topics, startups, and websites as displayed on the homepage. Combines the top 3 trending topics, top 3 trending startups, and top websites into a single response. Useful as a quick overview without pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_home_highlights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_related_topics

Get topics semantically or thematically related to a given topic slug. Returns an array of related trend objects with their own growth metrics, categories, search history, and descriptions. Useful for discovering adjacent trends.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | integer | No | Time period in months. Accepted values: 3, 6, 12, 24, 60. |
| `slug` | string | Yes | Topic slug to find related topics for (e.g. 'glp-1-supplement'). Use the path field from get_trending_topics results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_related_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"<integer>","slug":"<string>"}'
```

### get_top_websites

Get the ranked list of top websites with engagement metrics. Returns an array of website objects ordered by rank, each with path (domain) and engagement data (visits). The response contains a list of top websites with their traffic volume.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_top_websites \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_topic_detail

Get comprehensive detail for a single topic by its slug. Returns the full trend object including search history (weekly volumes since 2004), regression models, growth metrics, social channel results, TikTok activity data, Amazon product data, predictions, and related keyword trends. The slug comes from the path field of get_trending_topics results. Returns input_not_found if the slug has no data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Topic slug from the path field of get_trending_topics results (e.g. 'glp-1-supplement', 'pdrn-toner-rBqL9YyX'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_topic_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_trending_startups

Fetch a paginated list of trending startups with growth metrics, funding data, and company information. Each startup includes keyword, path, growth percentages, and a startupData object with location, website, employee count, funding details, and founding date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |
| `period` | integer | No | Time period in months. Accepted values: 3, 6, 12, 24, 60. |
| `size` | integer | No | Number of results per page. |
| `sort` | string | No | Sort field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_trending_startups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","period":"<integer>","size":"<integer>","sort":"<string>"}'
```

### get_trending_topics

Fetch a paginated list of trending topics with growth metrics, categories, and search history data. Supports filtering by category, volatility, period, and whether peaked topics are excluded. Each trend object includes keyword, path (slug), growth percentages across periods, categories, and a brief description. Use the path field as the slug input for get_topic_detail and get_related_topics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `categories` | string | No | Comma-separated category names to filter by (e.g. 'technology,health'). Use names from get_categories. |
| `exclude_peaked` | string | No | Exclude peaked topics. |
| `page` | integer | No | Page number (0-based). |
| `period` | integer | No | Time period in months. Accepted values: 24, 60. |
| `size` | integer | No | Number of results per page. |
| `sort` | string | No | Sort field. |
| `volatile` | string | No | Volatility filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-explodingtopics-com-api-f7a56941/get_trending_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":"<string>","exclude_peaked":"<string>","page":"<integer>","period":"<integer>","size":"<integer>","sort":"<string>","volatile":"<string>"}'
```