# grov full reference

> grov is a machine-payable API for social growth. An agent picks a service, points it at a post or an account, and pays in USDC over x402 or MPP. People pick the work up and complete it. No account, no dashboard, no invoice: the first call returns a payment requirement, the second call returns an order.

Generated from the live catalog at 2026-08-17T20:34:32.723Z.

## Networks

### x402 on Base

- Path prefix: `/api/base`
- Protocol: x402
- Asset: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`), 6 decimals
- Payment header: `PAYMENT-SIGNATURE`
- Challenge header: `Payment-Required`
- Flow: Call the endpoint, read the 402, sign the requirement with an EVM wallet, call again with PAYMENT-SIGNATURE.

### x402 on Solana

- Path prefix: `/api/solana`
- Protocol: x402
- Asset: USDC (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`), 6 decimals
- Payment header: `PAYMENT-SIGNATURE`
- Challenge header: `Payment-Required`
- Flow: Call the endpoint, read the 402, sign the requirement with a Solana signer, call again with PAYMENT-SIGNATURE.

### MPP on Tempo

- Path prefix: `/api/mpp`
- Protocol: mpp
- Asset: USDC (`0x20C000000000000000000000b9537d11c60E8b50`), 6 decimals
- Payment header: `Authorization: Payment`
- Challenge header: `WWW-Authenticate: Payment`
- Flow: Call the endpoint without Authorization, read the WWW-Authenticate challenge, call again with Authorization: Payment. The response carries Payment-Receipt.

### MPP on Solana

- Path prefix: `/api/mpp-solana`
- Protocol: mpp
- Asset: USDC (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`), 6 decimals
- Payment header: `Authorization: Payment`
- Challenge header: `WWW-Authenticate: Payment`
- Flow: Call the endpoint without Authorization, read the live challenge, build the credential with @solana/mpp, call again with Authorization: Payment.

## Request parameters

| Parameter | Where | Meaning |
|---|---|---|
| `amount` | query or body | Units to buy. Aliases: `quantity`, `winners`, `count`. |
| `url` | query or body | Target link, for services that act on a single post. |
| `handle` | query or body | Account name, for services that act on a profile. |
| `join` | query or body | Public t.me link, for Telegram membership. |
| `action` | query | `view` reads an existing order. Anything else creates one. |
| `secret` | query, body or `X-Secret` header | Bearer token for reading an order. |
| `network` | query | Picks a network when the path does not name one. |

The amount may also be the last path segment, for example `/api/base/xlikes/250`.

## Responses

### 402, payment required

```json
{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "maxAmountRequired": "2500000",
      "payTo": "0x...",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  ],
  "resource": {
    "url": "https://grov.fun/api/base/xlikes"
  }
}
```

MPP networks answer with `WWW-Authenticate: Payment ...` and a problem+json body instead.

### 200, order created

```json
{
  "ok": true,
  "paid": true,
  "rail": "base",
  "orderId": "7QK4M2XJ9BTN",
  "jobId": "7QK4M2XJ9BTN",
  "secret": "keep-this-safe",
  "statusUrl": "https://grov.fun/api/base/xlikes?action=view&secret=keep-this-safe",
  "service": "xlikes",
  "platform": "x",
  "amount": 100,
  "unit": "like",
  "target": "https://x.com/grov/status/1234567890",
  "chargedUsd": 2.5,
  "status": "queued"
}
```

### 200, order status

```json
{
  "ok": true,
  "orderId": "7QK4M2XJ9BTN",
  "status": "in_progress",
  "amount": 100,
  "delivered": 42,
  "remaining": 58,
  "startCount": 1310,
  "completedAt": null
}
```

Status values: `queued`, `in_progress`, `partial`, `completed`, `canceled`, `failed`.

### Errors

```json
{
  "ok": false,
  "message": "Minimum amount for this service is 10.",
  "errorCode": "AMOUNT_BELOW_MIN"
}
```

Error codes: `UNKNOWN_SERVICE`, `SERVICE_UNAVAILABLE`, `NETWORK_DISABLED`, `MISSING_TARGET`,
`INVALID_TARGET`, `INVALID_AMOUNT`, `AMOUNT_BELOW_MIN`, `AMOUNT_ABOVE_MAX`, `NOT_PRICEABLE`,
`INVALID_SECRET`, `RATE_LIMITED`, `PAYMENT_REQUIRED`, `PAYMENT_FAILED`, `SERVER_ERROR`.

## Catalog

### X

#### X Likes

- Key: `xlikes`
- Description: Likes on a single X post. People open the post and like it.
- Parameter: `url`. Direct link to the post on x.com.
- Price: $0.025 per like
- Range: 10 to 10000
- Aliases: `/api/twitter/like`, `/api/twitter/likes`, `/api/x/like`, `/api/x/likes`
- Endpoints: `https://grov.fun/api/base/xlikes`, `https://grov.fun/api/solana/xlikes`, `https://grov.fun/api/mpp/xlikes`, `https://grov.fun/api/mpp-solana/xlikes`

```bash
curl -i "https://grov.fun/api/base/xlikes?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=50"
```

#### X Reposts

- Key: `xreposts`
- Description: Reposts of a single X post.
- Parameter: `url`. Direct link to the post on x.com.
- Price: $0.025 per repost
- Range: 10 to 10000
- Aliases: `/api/twitter/repost`, `/api/twitter/reposts`, `/api/x/repost`, `/api/x/reposts`
- Endpoints: `https://grov.fun/api/base/xreposts`, `https://grov.fun/api/solana/xreposts`, `https://grov.fun/api/mpp/xreposts`, `https://grov.fun/api/mpp-solana/xreposts`

```bash
curl -i "https://grov.fun/api/base/xreposts?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=50"
```

#### X Comments

- Key: `xcomments`
- Description: Replies written under a single X post.
- Parameter: `url`. Direct link to the post on x.com.
- Price: $0.03 per comment
- Range: 5 to 1000
- Aliases: `/api/twitter/comment`, `/api/twitter/comments`, `/api/x/comment`, `/api/x/comments`
- Endpoints: `https://grov.fun/api/base/xcomments`, `https://grov.fun/api/solana/xcomments`, `https://grov.fun/api/mpp/xcomments`, `https://grov.fun/api/mpp-solana/xcomments`

```bash
curl -i "https://grov.fun/api/base/xcomments?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=50"
```

#### X Views

- Key: `xviews`
- Description: Views on a single X post.
- Parameter: `url`. Direct link to the post on x.com.
- Price: $0.003 per view
- Range: 100 to 500000
- Aliases: `/api/twitter/view`, `/api/twitter/views`, `/api/x/view`, `/api/x/views`
- Endpoints: `https://grov.fun/api/base/xviews`, `https://grov.fun/api/solana/xviews`, `https://grov.fun/api/mpp/xviews`, `https://grov.fun/api/mpp-solana/xviews`

```bash
curl -i "https://grov.fun/api/base/xviews?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=100"
```

#### X Followers

- Key: `xfollowers`
- Description: New followers for an X account.
- Parameter: `handle`. Account handle, with or without the leading @, or the full profile link.
- Price: $0.03 per follower
- Range: 10 to 20000
- Aliases: `/api/twitter/follower`, `/api/twitter/followers`, `/api/x/follower`, `/api/x/followers`
- Endpoints: `https://grov.fun/api/base/xfollowers`, `https://grov.fun/api/solana/xfollowers`, `https://grov.fun/api/mpp/xfollowers`, `https://grov.fun/api/mpp-solana/xfollowers`

```bash
curl -i "https://grov.fun/api/base/xfollowers?handle=grov&amount=50"
```

### Instagram

#### Instagram Likes

- Key: `instalikes`
- Description: Likes on a single Instagram post or reel.
- Parameter: `url`. Direct link to the post on instagram.com.
- Price: $0.025 per like
- Range: 10 to 10000
- Aliases: `/api/instagram/like`, `/api/instagram/likes`
- Endpoints: `https://grov.fun/api/base/instalikes`, `https://grov.fun/api/solana/instalikes`, `https://grov.fun/api/mpp/instalikes`, `https://grov.fun/api/mpp-solana/instalikes`

```bash
curl -i "https://grov.fun/api/base/instalikes?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCxxxxxxxxxx%2F&amount=50"
```

#### Instagram Comments

- Key: `instacomments`
- Description: Comments written under a single Instagram post or reel.
- Parameter: `url`. Direct link to the post on instagram.com.
- Price: $0.03 per comment
- Range: 5 to 1000
- Aliases: `/api/instagram/comment`, `/api/instagram/comments`
- Endpoints: `https://grov.fun/api/base/instacomments`, `https://grov.fun/api/solana/instacomments`, `https://grov.fun/api/mpp/instacomments`, `https://grov.fun/api/mpp-solana/instacomments`

```bash
curl -i "https://grov.fun/api/base/instacomments?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCxxxxxxxxxx%2F&amount=50"
```

#### Instagram Views

- Key: `instaviews`
- Description: Views on a single Instagram reel or video.
- Parameter: `url`. Direct link to the post on instagram.com.
- Price: $0.003 per view
- Range: 100 to 500000
- Aliases: `/api/instagram/view`, `/api/instagram/views`
- Endpoints: `https://grov.fun/api/base/instaviews`, `https://grov.fun/api/solana/instaviews`, `https://grov.fun/api/mpp/instaviews`, `https://grov.fun/api/mpp-solana/instaviews`

```bash
curl -i "https://grov.fun/api/base/instaviews?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FCxxxxxxxxxx%2F&amount=100"
```

#### Instagram Reposts

- Key: `instareposts`
- Description: Reposts of a single Instagram post or reel.
- Parameter: `url`. Direct link to the post on instagram.com.
- Price: $0.025 per repost
- Range: 10 to 5000
- Aliases: `/api/instagram/repost`, `/api/instagram/reposts`
- Endpoints: `https://grov.fun/api/base/instareposts`, `https://grov.fun/api/solana/instareposts`, `https://grov.fun/api/mpp/instareposts`, `https://grov.fun/api/mpp-solana/instareposts`

```bash
curl -i "https://grov.fun/api/base/instareposts?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCxxxxxxxxxx%2F&amount=50"
```

#### Instagram Post Saves

- Key: `instasaves`
- Description: Saves on a single Instagram post or reel.
- Parameter: `url`. Direct link to the post on instagram.com.
- Price: $0.025 per save
- Range: 10 to 10000
- Aliases: `/api/instagram/save`, `/api/instagram/saves`
- Endpoints: `https://grov.fun/api/base/instasaves`, `https://grov.fun/api/solana/instasaves`, `https://grov.fun/api/mpp/instasaves`, `https://grov.fun/api/mpp-solana/instasaves`

```bash
curl -i "https://grov.fun/api/base/instasaves?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCxxxxxxxxxx%2F&amount=50"
```

#### Instagram Followers

- Key: `instafollowers`
- Description: New followers for an Instagram account.
- Parameter: `handle`. Account handle, with or without the leading @, or the full profile link.
- Price: $0.03 per follower
- Range: 10 to 20000
- Aliases: `/api/instagram/follower`, `/api/instagram/followers`
- Endpoints: `https://grov.fun/api/base/instafollowers`, `https://grov.fun/api/solana/instafollowers`, `https://grov.fun/api/mpp/instafollowers`, `https://grov.fun/api/mpp-solana/instafollowers`

```bash
curl -i "https://grov.fun/api/base/instafollowers?handle=grov&amount=50"
```

### TikTok

#### TikTok Likes

- Key: `tiktoklikes`
- Description: Likes on a single TikTok video.
- Parameter: `url`. Direct link to the post on tiktok.com.
- Price: $0.025 per like
- Range: 10 to 10000
- Aliases: `/api/tiktok/like`, `/api/tiktok/likes`
- Endpoints: `https://grov.fun/api/base/tiktoklikes`, `https://grov.fun/api/solana/tiktoklikes`, `https://grov.fun/api/mpp/tiktoklikes`, `https://grov.fun/api/mpp-solana/tiktoklikes`

```bash
curl -i "https://grov.fun/api/base/tiktoklikes?url=https%3A%2F%2Fwww.tiktok.com%2F%40grov%2Fvideo%2F1234567890&amount=50"
```

#### TikTok Comments

- Key: `tiktokcomments`
- Description: Comments written under a single TikTok video.
- Parameter: `url`. Direct link to the post on tiktok.com.
- Price: $0.03 per comment
- Range: 5 to 1000
- Aliases: `/api/tiktok/comment`, `/api/tiktok/comments`
- Endpoints: `https://grov.fun/api/base/tiktokcomments`, `https://grov.fun/api/solana/tiktokcomments`, `https://grov.fun/api/mpp/tiktokcomments`, `https://grov.fun/api/mpp-solana/tiktokcomments`

```bash
curl -i "https://grov.fun/api/base/tiktokcomments?url=https%3A%2F%2Fwww.tiktok.com%2F%40grov%2Fvideo%2F1234567890&amount=50"
```

#### TikTok Views

- Key: `tiktokviews`
- Description: Views on a single TikTok video.
- Parameter: `url`. Direct link to the post on tiktok.com.
- Price: $0.002 per view
- Range: 100 to 1000000
- Aliases: `/api/tiktok/view`, `/api/tiktok/views`
- Endpoints: `https://grov.fun/api/base/tiktokviews`, `https://grov.fun/api/solana/tiktokviews`, `https://grov.fun/api/mpp/tiktokviews`, `https://grov.fun/api/mpp-solana/tiktokviews`

```bash
curl -i "https://grov.fun/api/base/tiktokviews?url=https%3A%2F%2Fwww.tiktok.com%2F%40grov%2Fvideo%2F1234567890&amount=100"
```

#### TikTok Shares

- Key: `tiktokshares`
- Description: Shares of a single TikTok video.
- Parameter: `url`. Direct link to the post on tiktok.com.
- Price: $0.025 per share
- Range: 10 to 10000
- Aliases: `/api/tiktok/share`, `/api/tiktok/shares`
- Endpoints: `https://grov.fun/api/base/tiktokshares`, `https://grov.fun/api/solana/tiktokshares`, `https://grov.fun/api/mpp/tiktokshares`, `https://grov.fun/api/mpp-solana/tiktokshares`

```bash
curl -i "https://grov.fun/api/base/tiktokshares?url=https%3A%2F%2Fwww.tiktok.com%2F%40grov%2Fvideo%2F1234567890&amount=50"
```

#### TikTok Post Saves

- Key: `tiktoksaves`
- Description: Saves on a single TikTok video.
- Parameter: `url`. Direct link to the post on tiktok.com.
- Price: $0.025 per save
- Range: 10 to 10000
- Aliases: `/api/tiktok/save`, `/api/tiktok/saves`
- Endpoints: `https://grov.fun/api/base/tiktoksaves`, `https://grov.fun/api/solana/tiktoksaves`, `https://grov.fun/api/mpp/tiktoksaves`, `https://grov.fun/api/mpp-solana/tiktoksaves`

```bash
curl -i "https://grov.fun/api/base/tiktoksaves?url=https%3A%2F%2Fwww.tiktok.com%2F%40grov%2Fvideo%2F1234567890&amount=50"
```

#### TikTok Followers

- Key: `tiktokfollowers`
- Description: New followers for a TikTok account.
- Parameter: `handle`. Account handle, with or without the leading @, or the full profile link.
- Price: $0.03 per follower
- Range: 10 to 20000
- Aliases: `/api/tiktok/follower`, `/api/tiktok/followers`
- Endpoints: `https://grov.fun/api/base/tiktokfollowers`, `https://grov.fun/api/solana/tiktokfollowers`, `https://grov.fun/api/mpp/tiktokfollowers`, `https://grov.fun/api/mpp-solana/tiktokfollowers`

```bash
curl -i "https://grov.fun/api/base/tiktokfollowers?handle=grov&amount=50"
```

### YouTube

#### YouTube Likes

- Key: `ytlikes`
- Description: Likes on a single YouTube video or short.
- Parameter: `url`. Direct link to the post on youtube.com.
- Price: $0.025 per like
- Range: 10 to 10000
- Aliases: `/api/youtube/like`, `/api/youtube/likes`
- Endpoints: `https://grov.fun/api/base/ytlikes`, `https://grov.fun/api/solana/ytlikes`, `https://grov.fun/api/mpp/ytlikes`, `https://grov.fun/api/mpp-solana/ytlikes`

```bash
curl -i "https://grov.fun/api/base/ytlikes?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&amount=50"
```

#### YouTube Comments

- Key: `ytcomments`
- Description: Comments written under a single YouTube video.
- Parameter: `url`. Direct link to the post on youtube.com.
- Price: $0.035 per comment
- Range: 5 to 1000
- Aliases: `/api/youtube/comment`, `/api/youtube/comments`
- Endpoints: `https://grov.fun/api/base/ytcomments`, `https://grov.fun/api/solana/ytcomments`, `https://grov.fun/api/mpp/ytcomments`, `https://grov.fun/api/mpp-solana/ytcomments`

```bash
curl -i "https://grov.fun/api/base/ytcomments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&amount=50"
```

#### YouTube Views

- Key: `ytviews`
- Description: Views on a single YouTube video or short.
- Parameter: `url`. Direct link to the post on youtube.com.
- Price: $0.004 per view
- Range: 100 to 500000
- Aliases: `/api/youtube/view`, `/api/youtube/views`
- Endpoints: `https://grov.fun/api/base/ytviews`, `https://grov.fun/api/solana/ytviews`, `https://grov.fun/api/mpp/ytviews`, `https://grov.fun/api/mpp-solana/ytviews`

```bash
curl -i "https://grov.fun/api/base/ytviews?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&amount=100"
```

#### YouTube Subscribers

- Key: `ytsubscribers`
- Description: New subscribers for a YouTube channel.
- Parameter: `handle`. Account handle, with or without the leading @, or the full profile link.
- Price: $0.035 per subscriber
- Range: 10 to 10000
- Aliases: `/api/youtube/subscriber`, `/api/youtube/subscribers`
- Endpoints: `https://grov.fun/api/base/ytsubscribers`, `https://grov.fun/api/solana/ytsubscribers`, `https://grov.fun/api/mpp/ytsubscribers`, `https://grov.fun/api/mpp-solana/ytsubscribers`

```bash
curl -i "https://grov.fun/api/base/ytsubscribers?handle=https%3A%2F%2Fwww.youtube.com%2F%40grov&amount=50"
```

### Telegram

#### Telegram Channel Members

- Key: `tgmembers`
- Description: New members for a Telegram channel or group.
- Parameter: `join`. Public t.me link for the channel or group.
- Price: $0.03 per member
- Range: 10 to 50000
- Aliases: `/api/telegram/member`, `/api/telegram/members`
- Endpoints: `https://grov.fun/api/base/tgmembers`, `https://grov.fun/api/solana/tgmembers`, `https://grov.fun/api/mpp/tgmembers`, `https://grov.fun/api/mpp-solana/tgmembers`

```bash
curl -i "https://grov.fun/api/base/tgmembers?join=https%3A%2F%2Ft.me%2Fgrovfun&amount=50"
```

### Spotify

#### Spotify Plays

- Key: `spotifyplays`
- Description: Plays on a single Spotify track.
- Parameter: `url`. open.spotify.com link to the track or album.
- Price: $0.004 per play
- Range: 100 to 500000
- Aliases: `/api/spotify/play`, `/api/spotify/plays`
- Endpoints: `https://grov.fun/api/base/spotifyplays`, `https://grov.fun/api/solana/spotifyplays`, `https://grov.fun/api/mpp/spotifyplays`, `https://grov.fun/api/mpp-solana/spotifyplays`

```bash
curl -i "https://grov.fun/api/base/spotifyplays?url=https%3A%2F%2Fopen.spotify.com%2Ftrack%2F4cOdK2wGLETKBW3PvgPWqT&amount=100"
```

#### Spotify Saves

- Key: `spotifysaves`
- Description: Saves on a single Spotify track or album.
- Parameter: `url`. open.spotify.com link to the track or album.
- Price: $0.02 per save
- Range: 10 to 20000
- Aliases: `/api/spotify/save`, `/api/spotify/saves`
- Endpoints: `https://grov.fun/api/base/spotifysaves`, `https://grov.fun/api/solana/spotifysaves`, `https://grov.fun/api/mpp/spotifysaves`, `https://grov.fun/api/mpp-solana/spotifysaves`

```bash
curl -i "https://grov.fun/api/base/spotifysaves?url=https%3A%2F%2Fopen.spotify.com%2Ftrack%2F4cOdK2wGLETKBW3PvgPWqT&amount=50"
```

#### Spotify Followers

- Key: `spotifyfollowers`
- Description: New followers for a Spotify artist profile.
- Parameter: `url`. open.spotify.com link to the artist profile.
- Price: $0.02 per follower
- Range: 10 to 50000
- Aliases: `/api/spotify/follower`, `/api/spotify/followers`
- Endpoints: `https://grov.fun/api/base/spotifyfollowers`, `https://grov.fun/api/solana/spotifyfollowers`, `https://grov.fun/api/mpp/spotifyfollowers`, `https://grov.fun/api/mpp-solana/spotifyfollowers`

```bash
curl -i "https://grov.fun/api/base/spotifyfollowers?url=https%3A%2F%2Fopen.spotify.com%2Fartist%2F6eUKZXaKkcviH0Ku9w2n3V&amount=50"
```

#### Spotify Monthly Listeners

- Key: `spotifylisteners`
- Description: Monthly listeners for a Spotify artist profile.
- Parameter: `url`. open.spotify.com link to the artist profile.
- Price: $0.01 per listener
- Range: 100 to 100000
- Aliases: `/api/spotify/listener`, `/api/spotify/listeners`, `/api/spotify/monthly-listener`, `/api/spotify/monthly-listeners`
- Endpoints: `https://grov.fun/api/base/spotifylisteners`, `https://grov.fun/api/solana/spotifylisteners`, `https://grov.fun/api/mpp/spotifylisteners`, `https://grov.fun/api/mpp-solana/spotifylisteners`

```bash
curl -i "https://grov.fun/api/base/spotifylisteners?url=https%3A%2F%2Fopen.spotify.com%2Fartist%2F6eUKZXaKkcviH0Ku9w2n3V&amount=100"
```

### Facebook

#### Facebook Likes

- Key: `fblikes`
- Description: Likes on a single Facebook post.
- Parameter: `url`. Direct link to the post on facebook.com.
- Price: $0.025 per like
- Range: 10 to 10000
- Aliases: `/api/facebook/like`, `/api/facebook/likes`
- Endpoints: `https://grov.fun/api/base/fblikes`, `https://grov.fun/api/solana/fblikes`, `https://grov.fun/api/mpp/fblikes`, `https://grov.fun/api/mpp-solana/fblikes`

```bash
curl -i "https://grov.fun/api/base/fblikes?url=https%3A%2F%2Fwww.facebook.com%2Fgrov%2Fposts%2F1234567890&amount=50"
```

#### Facebook Comments

- Key: `fbcomments`
- Description: Comments written under a single Facebook post.
- Parameter: `url`. Direct link to the post on facebook.com.
- Price: $0.03 per comment
- Range: 5 to 1000
- Aliases: `/api/facebook/comment`, `/api/facebook/comments`
- Endpoints: `https://grov.fun/api/base/fbcomments`, `https://grov.fun/api/solana/fbcomments`, `https://grov.fun/api/mpp/fbcomments`, `https://grov.fun/api/mpp-solana/fbcomments`

```bash
curl -i "https://grov.fun/api/base/fbcomments?url=https%3A%2F%2Fwww.facebook.com%2Fgrov%2Fposts%2F1234567890&amount=50"
```

#### Facebook Views

- Key: `fbviews`
- Description: Views on a single Facebook video or reel.
- Parameter: `url`. Direct link to the post on facebook.com.
- Price: $0.003 per view
- Range: 100 to 500000
- Aliases: `/api/facebook/view`, `/api/facebook/views`
- Endpoints: `https://grov.fun/api/base/fbviews`, `https://grov.fun/api/solana/fbviews`, `https://grov.fun/api/mpp/fbviews`, `https://grov.fun/api/mpp-solana/fbviews`

```bash
curl -i "https://grov.fun/api/base/fbviews?url=https%3A%2F%2Fwww.facebook.com%2Fgrov%2Fvideos%2F1234567890&amount=100"
```

#### Facebook Shares

- Key: `fbshares`
- Description: Shares of a single Facebook post.
- Parameter: `url`. Direct link to the post on facebook.com.
- Price: $0.025 per share
- Range: 10 to 10000
- Aliases: `/api/facebook/share`, `/api/facebook/shares`
- Endpoints: `https://grov.fun/api/base/fbshares`, `https://grov.fun/api/solana/fbshares`, `https://grov.fun/api/mpp/fbshares`, `https://grov.fun/api/mpp-solana/fbshares`

```bash
curl -i "https://grov.fun/api/base/fbshares?url=https%3A%2F%2Fwww.facebook.com%2Fgrov%2Fposts%2F1234567890&amount=50"
```

#### Facebook Post Saves

- Key: `fbsaves`
- Description: Saves on a single Facebook post.
- Parameter: `url`. Direct link to the post on facebook.com.
- Price: $0.025 per save
- Range: 10 to 10000
- Aliases: `/api/facebook/save`, `/api/facebook/saves`
- Endpoints: `https://grov.fun/api/base/fbsaves`, `https://grov.fun/api/solana/fbsaves`, `https://grov.fun/api/mpp/fbsaves`, `https://grov.fun/api/mpp-solana/fbsaves`

```bash
curl -i "https://grov.fun/api/base/fbsaves?url=https%3A%2F%2Fwww.facebook.com%2Fgrov%2Fposts%2F1234567890&amount=50"
```

#### Facebook Followers

- Key: `fbfollowers`
- Description: New followers for a Facebook page or profile.
- Parameter: `handle`. Account handle, with or without the leading @, or the full profile link.
- Price: $0.03 per follower
- Range: 10 to 20000
- Aliases: `/api/facebook/follower`, `/api/facebook/followers`
- Endpoints: `https://grov.fun/api/base/fbfollowers`, `https://grov.fun/api/solana/fbfollowers`, `https://grov.fun/api/mpp/fbfollowers`, `https://grov.fun/api/mpp-solana/fbfollowers`

```bash
curl -i "https://grov.fun/api/base/fbfollowers?handle=grov&amount=50"
```

#### Facebook Group Members

- Key: `fbgroupmembers`
- Description: New members for a Facebook group.
- Parameter: `url`. Direct link to the Facebook group.
- Price: $0.035 per member
- Range: 10 to 20000
- Aliases: `/api/facebook/group-member`, `/api/facebook/group-members`
- Endpoints: `https://grov.fun/api/base/fbgroupmembers`, `https://grov.fun/api/solana/fbgroupmembers`, `https://grov.fun/api/mpp/fbgroupmembers`, `https://grov.fun/api/mpp-solana/fbgroupmembers`

```bash
curl -i "https://grov.fun/api/base/fbgroupmembers?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2Fgrov&amount=50"
```

## Notes on delivery

- Orders are completed by people, so they fill in gradually. Expect minutes to hours.
- A `queued` order is accepted and paid for. It is not an error state.
- Reading an order is free and unmetered enough to poll every few minutes.
- A read is answered live. Asking again inside 120 seconds returns the figures already on file, and a finished order is never re-read.
- Keep the secret private. Anyone holding it can read the order.

## Links

- Docs: https://grov.fun/docs
- Skill: https://grov.fun/skill.md
- Best practices: https://grov.fun/best-practices.md
- OpenAPI: https://grov.fun/openapi.json
- Resource list: https://grov.fun/.well-known/x402
- Agent card: https://grov.fun/.well-known/agent-card.json
- MCP: https://grov.fun/mcp