Name: Apify Store Trends API: Rising Actors and Niches
Brand: martindata
SKU: api-martindata-apifystoretrendsnich-api
Availability: InStock
Author: API Market

# Apify Store Trends API

## Overview

The Apify Store Trends API tracks the Apify Store over time and returns growth and competition data as JSON through one endpoint with three modes. Rising lists actors whose monthly users are growing fastest, niche shows for each search term how crowded the Store is and who leads it, and history returns the daily record of chosen actors.

It is built for Apify developers, indie hackers and analysts deciding what to build next or watching competitors. The Store itself only shows today's numbers, so this API keeps a daily archive and compares today with earlier snapshots to show momentum, user deltas and pricing.

## Features

*   **1 endpoint, 3 modes**: `rising`, `niche` and `history`, chosen with the `mode` field.
*   **Momentum score**: how much faster an actor grew in the last 7 days than its 30-day average.
*   **Niche saturation**: actor counts, active and clone actors, the leader and the top 3 share per term.
*   **Actor history**: daily users, ratings and pricing of chosen actors.
*   **Up to 1000 rows**: set with `limit`.
*   **Rate limit**: up to 10 requests per second on every plan.

## Use Cases

*   **Product ideas**: find niches with demand and few strong actors.
*   **Competitor tracking**: watch the users and pricing of rival actors.
*   **Market research**: see which categories are growing on the Store.
*   **Portfolio reviews**: follow your own actors' growth over time.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/martindata/apifystoretrendsnich-api
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Rising actors

Returns actors whose monthly users are growing, ranked by `sortBy`, with momentum, user deltas, categories and pricing.

**Method:** `POST`

**Endpoint:** `/m/apify-store-trends-niche-finder`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `rising` | string | Yes | - | - |
| search | body | Rising mode only. Optional keywords; only actors whose name, title or description match are returned. Leave empty for the whole Store. | array of strings | No | - | - |
| category | body | Rising mode only. Optional Apify Store category in capitals, for example AI, ECOMMERCE, SOCIAL_MEDIA, LEAD_GENERATION, DEVELOPER_TOOLS. Empty means all categories. | string | No | - | - |
| minUsers30 | body | Rising mode only. Ignore actors with fewer monthly users than this. Higher values remove noise from brand-new or tiny actors. | integer | No | - | - |
| sortBy | body | Rising mode only. momentum = how much faster the last 7 days grow than the 30-day average (above 1 means accelerating). users30Delta and users30DeltaPct = change in monthly users since the comparison day. users30 = biggest actors first. | string | No | - | - |
| lookbackDays | body | Rising mode only. Compare today with the archive snapshot about this many days ago. If the archive is younger, the oldest snapshot is used (see comparedWith in each row). | integer | No | - | - |
| limit | body | Maximum number of rows returned (1 to 1000). In niche mode it also limits how many top actors are listed per term. | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/apifystoretrendsnich-api/m/apify-store-trends-niche-finder' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "rising",
  "minUsers30": 10,
  "sortBy": "momentum",
  "limit": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 3,
  "items": [
    {
      "actor": "corent1robert/google-play-developer-contacts",
      "archiveFrom": "2026-11-03",
      "archiveSnapshots": 3,
      "categories": [
        "LEAD_GENERATION",
        "AUTOMATION"
      ],
      "comparedWith": "2026-11-03",
      "day": "2026-11-05",
      "momentum": 4.29,
      "priceUsd": 0.005,
      "pricingModel": "PAY_PER_EVENT",
      "rating": null,
      "reviews": 0,
      "runs30": 774,
      "successRate30": 100,
      "title": "Google Play · Developer Emails",
      "url": "https://apify.com/corent1robert/google-play-developer-contacts",
      "users30": 136,
      "users30Delta": 0,
      "users30DeltaPct": 0,
      "users30Then": 136,
      "users7": 136,
      "users90": 140,
      "usersTotal": 151,
      "usersTotalDelta": 0
    },
    {
      "actor": "vexaloom-labs/linkedin-people-search-by-name-with-company",
      "archiveFrom": "2026-11-03",
      "archiveSnapshots": 3,
      "categories": [
        "SOCIAL_MEDIA",
        "LEAD_GENERATION"
      ],
      "comparedWith": "2026-11-03",
      "day": "2026-11-05",
      "momentum": 4.29,
      "priceUsd": 0.00099,
      "pricingModel": "PAY_PER_EVENT",
      "rating": null,
      "reviews": 0,
      "runs30": 70,
      "successRate30": 98.6,
      "title": "LinkedIn People Search by Name with Company & School Filters",
      "url": "https://apify.com/vexaloom-labs/linkedin-people-search-by-name-with-company",
      "users30": 39,
      "users30Delta": null,
      "users30DeltaPct": null,
      "users30Then": null,
      "users7": 39,
      "users90": 39,
      "usersTotal": 39,
      "usersTotalDelta": null
    }
  ]
}
```

#### 2. Niche finder

Returns one row per search term with how many actors compete, how many are active or clones, the leader and its share.

**Method:** `POST`

**Endpoint:** `/m/apify-store-trends-niche-finder`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `niche` | string | Yes | - | - |
| searchTerms | body | Keywords that describe an actor idea, such as `tiktok` | array of strings | Yes | - | - |
| limit | body | Maximum number of rows returned (1 to 1000). In niche mode it also limits how many top actors are listed per term. | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/apifystoretrendsnich-api/m/apify-store-trends-niche-finder' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "niche",
  "searchTerms": [
    "tiktok"
  ],
  "limit": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 1,
  "items": [
    {
      "activeActors": 535,
      "actors": 1681,
      "cloneActors": 938,
      "comparedWith": "2026-11-03",
      "day": "2026-11-05",
      "leader": "clockworks/tiktok-scraper",
      "leaderPriceUsd": 0.0037,
      "leaderRating": 4.75,
      "leaderUsers30": 34123,
      "searchTerm": "tiktok",
      "top3SharePct": 57.7,
      "topActors": [
        {
          "actor": "clockworks/tiktok-scraper",
          "categories": [
            "SOCIAL_MEDIA",
            "VIDEOS"
          ],
          "comparedWith": "2026-11-03",
          "day": "2026-11-05",
          "momentum": 2.09,
          "priceUsd": 0.0037,
          "pricingModel": "PAY_PER_EVENT",
          "rating": 4.75,
          "reviews": 370,
          "runs30": 14737502,
          "successRate30": 98.2,
          "title": "TikTok Scraper",
          "url": "https://apify.com/clockworks/tiktok-scraper",
          "users30": 34123,
          "users30Delta": 543,
          "users30DeltaPct": 1.6,
          "users30Then": 33580,
          "users7": 16666,
          "users90": 50458,
          "usersTotal": 380410,
          "usersTotalDelta": 1721
        },
        {
          "actor": "clockworks/tiktok-profile-scraper",
          "categories": [
            "SOCIAL_MEDIA",
            "VIDEOS"
          ],
          "comparedWith": "2026-11-03",
          "day": "2026-11-05",
          "momentum": 2.15,
          "priceUsd": 0.003,
          "pricingModel": "PAY_PER_EVENT",
          "rating": 4.73,
          "reviews": 73,
          "runs30": 3344527,
          "successRate30": 98.8,
          "title": "TikTok Profile Scraper",
          "url": "https://apify.com/clockworks/tiktok-profile-scraper",
          "users30": 8879,
          "users30Delta": 148,
          "users30DeltaPct": 1.7,
          "users30Then": 8731,
          "users7": 4462,
          "users90": 14321,
          "usersTotal": 63058,
          "usersTotalDelta": 458
        }
      ],
      "users30Sum": 85712,
      "users30SumDeltaPct": 7.9,
      "users30SumThen": 79443,
      "verdict": "crowded: leader above 150 monthly users"
    }
  ]
}
```

#### 3. Actor history

Returns the current figures and the daily history of each chosen actor.

**Method:** `POST`

**Endpoint:** `/m/apify-store-trends-niche-finder`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `history` | string | Yes | - | - |
| actors | body | Actor IDs in the form `username/name`, such as `apify/website-content-crawler` | array of strings | Yes | - | - |
| limit | body | Maximum number of rows returned (1 to 1000). In niche mode it also limits how many top actors are listed per term. | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/apifystoretrendsnich-api/m/apify-store-trends-niche-finder' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "history",
  "actors": [
    "apify/website-content-crawler"
  ],
  "limit": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 1,
  "items": [
    {
      "actor": "apify/website-content-crawler",
      "archiveFrom": "2026-11-03",
      "archiveSnapshots": 3,
      "current": {
        "actor": "apify/website-content-crawler",
        "categories": [
          "AI",
          "DEVELOPER_TOOLS"
        ],
        "comparedWith": "2026-11-03",
        "day": "2026-11-05",
        "momentum": 1.63,
        "priceUsd": null,
        "pricingModel": "FREE",
        "rating": 4.61,
        "reviews": 234,
        "runs30": 3897448,
        "successRate30": 96.4,
        "title": "Website Content Crawler",
        "url": "https://apify.com/apify/website-content-crawler",
        "users30": 14361,
        "users30Delta": 161,
        "users30DeltaPct": 1.1,
        "users30Then": 14200,
        "users7": 5451,
        "users90": 26213,
        "usersTotal": 174753,
        "usersTotalDelta": 357
      },
      "found": true,
      "history": [
        {
          "day": "2026-11-03",
          "priceUsd": null,
          "rating": 4.613140687527266,
          "reviews": 234,
          "runs30": 3803581,
          "users30": 14200,
          "users7": 5392,
          "users90": 26144,
          "usersTotal": 174396
        },
        {
          "day": "2026-11-04",
          "priceUsd": null,
          "rating": 4.613140687527266,
          "reviews": 234,
          "runs30": 3879481,
          "users30": 14189,
          "users7": 5381,
          "users90": 26133,
          "usersTotal": 174385
        }
      ],
      "title": "Website Content Crawler"
    }
  ]
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than 10 requests per second. Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

Every plan allows up to 10 requests per second. Subscription plans also have a monthly call quota shown on the pricing page. Sending more than 10 requests per second returns `429 Too Many Requests`. Throttle your client to stay under 10 requests per second, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Which mode should I use?**

    Use `rising` to find growing actors, `niche` to check how crowded an idea is, and `history` to follow specific actors.

*   **How far back does the history go?**

    The archive starts on 2026-11-03 and grows by one snapshot a day, so `lookbackDays` is limited by the archive age.

*   **What is momentum?**

    The growth rate of the last 7 days divided by the 30-day average. Above 1 means growth is speeding up.

*   **How long does a call take?**

    Most calls answer in 5 to 30 seconds because the data is fetched live. Some modes can take up to a minute or more on large inputs, so set your client timeout to at least 150 seconds.

*   **Are repeated requests cached?**

    Yes. An identical request made within 6 hours returns the cached result straight away.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Find rising Apify Store actors, check how crowded a niche is and track actor history with daily users, ratings and pricing.

Apify Store Trends API: Rising Actors and Niches