# Common jobs & recipes

Common jobs

# Choose a job, follow the calls

Each step’s curl, parameters and price are generated from the endpoint registry, and each step is labelled live only when real traffic has proven it.

## Replace the key and connect each step

Every request is a GET with your key in the `x-api-key` header and one envelope back — `data`, `credits_used`, `request_id`. Example values below are the registry’s documented examples, not identifiers returned by your earlier calls. Replace monitor, post, advertiser and company ids with the real values from the preceding response. Review previews before running create or confirmed run examples: they can spend credits and start schedules. Confirmed failed collection is uncharged or refunded; pending reconciliation can report an unknown charge. Successful retrievals may cost credits even when filters keep nothing.

## Choose your task

- [Search TikTok and retrieve exact music IDs](#tiktok-search-music)

- [Search YouTube with views and video durations](#youtube-search-metrics)

- [Track a creator’s follower count each day](#track-creator-growth)

- [Read recent customer feedback from both app stores](#read-app-feedback)

- [Find Instagram reels and learn about their creators](#instagram-reel-creators)

- [Find LinkedIn posts and inspect their authors](#linkedin-post-authors)

- [Track brand complaints and emerging issues](#brand-complaints-monitor)

- [Watch a competitor and identify switching intent](#competitor-switching-monitor)

- [Monitor new app or business reviews](#app-reviews-monitor)

- [A creator snapshot: profile plus recent videos](#creator-snapshot)

- [Turn a video into text](#video-to-text)

- [Brand listening across platforms in one call](#brand-listening)

- [An X conversation: search, then the replies](#x-conversation)

- [What a competitor is advertising](#ad-intelligence)

- [Watch a target on a schedule](#watch-a-target)

## Search TikTok and retrieve exact music IDs

every step live · proven2 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Keep the search page and look up a capped number of posts with missing music IDs. The workflow checks identities, previews normal component prices and enforces a total credit limit.

[Read the guide](https://www.monocrawl.com/docs/tiktok-search-music)[Download runnable Node example](https://www.monocrawl.com/examples/tiktok-search-music.mjs)

- `01``tiktok/search-top`live · proven1 credit

One page of videos and photo posts, keeping source dates and continuation.

**terminal**

```
curl "https://www.monocrawl.com/v1/tiktok/search-top?query=space%20exploration" \
  -H "x-api-key: mn_your_key_here"
```

- `02``tiktok/post`live · proven1 credit

Optional individual lookup for each selected distinct post missing an exact music ID. Match the returned post ID before enriching the search.

**terminal**

```
curl "https://www.monocrawl.com/v1/tiktok/post?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7665075736742530317" \
  -H "x-api-key: mn_your_key_here"
```

## Search YouTube with views and video durations

every step live · proven3 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Keep the precise search dates and page cursor, then join a bounded batch of video metrics by ID. The downloadable workflow previews both prices, caps total spending and retains search rows when metrics are unavailable.

[Read the guide](https://www.monocrawl.com/docs/youtube-search-metrics)[Download runnable Node example](https://www.monocrawl.com/examples/youtube-search-metrics.mjs)

- `01``youtube/search`live · proven1 credit

One discovery page, retaining its order, precise timestamps and continuation.

**terminal**

```
curl "https://www.monocrawl.com/v1/youtube/search?query=space%20exploration&type=video&max_results=25" \
  -H "x-api-key: mn_your_key_here"
```

- `02``youtube/videos`live · proven2 credits

Optional GET batch with up to 50 distinct video IDs from that page. Returns views, likes, comment counts and duration where available, at the normal batch price.

**terminal**

```
curl "https://www.monocrawl.com/v1/youtube/videos?ids=9bZkp7q19f0%2CkJQP7kiw5Fk" \
  -H "x-api-key: mn_your_key_here"
```

## Track a creator’s follower count each day

every step live · proven1 credit summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Select the exact numeric profile field. The first successful check records a baseline; missing values and true/false fields never become zero. Preview the scheduled cost before creating the monitor.

[Read the guide](https://www.monocrawl.com/docs/monitors#metric-fields)

- `01``monitors/create`live · proven1 credit

Schedules one profile check daily. Creation validates the numeric path using the published schema, without fetching a paid sample. Availability of a value still depends on the source.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?kind=change&schedule_minutes=1440&platform=instagram&endpoint=profile&params_json=%7B%22handle%22%3A%22nasa%22%7D&result_mode=changes&rules=%7B%22metric_fields%22%3A%5B%22%2Ffollowers%22%5D%7D" \
  -H "x-api-key: mn_your_key_here"
```

- `02``monitors/timeseries`live · proven0 credits

Read the selected metric for the created monitor. Use the returned monitor id and the exact /followers metric name.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/timeseries?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&metric=%2Ffollowers" \
  -H "x-api-key: mn_your_key_here"
```

## Read recent customer feedback from both app stores

every step live · proven4 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Collect one bounded page from each store, keeping review text, ratings and source links. Use the returned continuation when you need another normally priced source page.

- `01``app_store/app-reviews`live · proven2 credits

One App Store review page for the selected app and storefront. Store coverage is not a complete archive.

**terminal**

```
curl "https://www.monocrawl.com/v1/app_store/app-reviews?app_id=310633997" \
  -H "x-api-key: mn_your_key_here"
```

- `02``google_play/app-reviews`live · proven2 credits

One Google Play review page for the corresponding app. Country and language controls vary by source.

**terminal**

```
curl "https://www.monocrawl.com/v1/google_play/app-reviews?package=com.whatsapp" \
  -H "x-api-key: mn_your_key_here"
```

## Find Instagram reels and learn about their creators

every step live · proven12 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Search a keyword, then look up a bounded number of distinct creators. The downloadable workflow deduplicates creators, keeps country unknown when the source omits it, and checks a total credit ceiling before every call.

[Read the guide](https://www.monocrawl.com/docs/instagram-creators)[Download runnable Node example](https://www.monocrawl.com/examples/instagram-reel-creators.mjs)

- `01``instagram/search-reels`live · proven1 credit

One search page. Continue only with the returned cursor and the same search inputs; each acquired page uses its normal price.

**terminal**

```
curl "https://www.monocrawl.com/v1/instagram/search-reels?query=coffee" \
  -H "x-api-key: mn_your_key_here"
```

- `02``instagram/profile`live · proven1 credit

Optional: one profile lookup per selected distinct creator, using the handle returned by the search.

**terminal**

```
curl "https://www.monocrawl.com/v1/instagram/profile?handle=nasa" \
  -H "x-api-key: mn_your_key_here"
```

- `03``instagram/about`live · proven10 credits

Optional: one transparency lookup per selected creator for the source-reported account country. This does not establish where a reel was filmed.

**terminal**

```
curl "https://www.monocrawl.com/v1/instagram/about?handle=nasa" \
  -H "x-api-key: mn_your_key_here"
```

## Find LinkedIn posts and inspect their authors

every step live · proven10 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Use native keyword search, then enrich a bounded number of person authors. The runnable workflow caps pages, authors and total credits; source-reported author location is not post origin.

[Download runnable Node example](https://www.monocrawl.com/examples/linkedin-post-search.mjs)

- `01``linkedin/search-posts-native`live · proven5 credits

One relevance search page. Empty locally filtered pages may still have a continuation and do not imply the search is exhausted.

**terminal**

```
curl "https://www.monocrawl.com/v1/linkedin/search-posts-native?query=OpenAI&date_posted=last-week" \
  -H "x-api-key: mn_your_key_here"
```

- `02``linkedin/profile`live · proven5 credits

Optional: retrieve one selected person author. Company authors use a different endpoint. The workflow withholds contact fields.

**terminal**

```
curl "https://www.monocrawl.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fsatyanadella%2F" \
  -H "x-api-key: mn_your_key_here"
```

## Track brand complaints and emerging issues

every step live · proven1 credit summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Preview first (free, nothing metered), then switch on a complaints monitor: matching uses complaint rules and configured relevance checks; notifications follow your destinations and cadence.

- `01``monitors/preview`live · proven0 credits

The resolved subject (or the senses to choose from), the platforms with reasons, and the estimate from the price list.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/preview?query=Monzo&purpose=complaints&schedule_minutes=360" \
  -H "x-api-key: mn_your_key_here"
```

- `02``monitors/create`live · proven1 credit

Activates it. Pass the entity from the preview when the name was ambiguous; without it an ambiguous name is refused.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?kind=subject&query=Monzo&purpose=complaints&schedule_minutes=360&delivery_webhook=true" \
  -H "x-api-key: mn_your_key_here"
```

- `03``monitors/findings`live · proven0 credits

What it found since you last looked — each finding with its platform, link, relationship and the complaint phrases it matched.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/findings?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&unseen=true" \
  -H "x-api-key: mn_your_key_here"
```

## Watch a competitor and identify switching intent

every step live · proven2 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Two monitors on one rival: what they announce and what people say back, plus the people asking for an alternative.

- `01``monitors/create`live · proven1 credit

Official and audience material, kept apart on every finding.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?kind=subject&query=Revolut&purpose=competitor_watch&schedule_minutes=1440" \
  -H "x-api-key: mn_your_key_here"
```

- `02``monitors/create`live · proven1 credit

Requests independent-audience findings matching switching phrases. These are account-level classifications, not proof of real-world identity or intent.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?kind=subject&query=Revolut&purpose=switching&relationships=independent_audience&schedule_minutes=360" \
  -H "x-api-key: mn_your_key_here"
```

- `03``monitors/findings`live · proven0 credits

Read and mark as seen in one call; subsequent unseen reads exclude findings marked by this call.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/findings?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&unseen=true&mark_seen=true" \
  -H "x-api-key: mn_your_key_here"
```

## Monitor new app or business reviews

every step live · proven1 credit summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

A feed monitor reads one review endpoint on a schedule. The first run records what is already there; from then on only new reviews become findings.

- `01``monitors/create`live · proven1 credit

Both stores in one monitor via feeds_json. Keep one feed if you only need one store. With filters=complaints the documented complaint phrase filter applies; leave it out to keep all newly retrieved reviews.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?kind=feed&purpose=app_reviews&filters=complaints&schedule_minutes=1440&feeds_json=%5B%7B%22platform%22%3A%22app_store%22%2C%22endpoint%22%3A%22app-reviews%22%2C%22params%22%3A%7B%22app_id%22%3A%22310633997%22%7D%7D%2C%7B%22platform%22%3A%22google_play%22%2C%22endpoint%22%3A%22app-reviews%22%2C%22params%22%3A%7B%22package%22%3A%22com.whatsapp%22%7D%7D%5D" \
  -H "x-api-key: mn_your_key_here"
```

- `02``monitors/run`live · proven0 credits

Optional: run it now instead of waiting for the schedule. Without confirm=true the call only quotes the cost.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/run?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&confirm=true" \
  -H "x-api-key: mn_your_key_here"
```

- `03``monitors/findings`live · proven0 credits

New reviews since the baseline, with rating, author and text.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/findings?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a" \
  -H "x-api-key: mn_your_key_here"
```

## A creator snapshot: profile plus recent videos

every step live · proven2 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Two calls give you counts, bio and the latest content with per-video stats — the basis of most creator vetting.

- `01``tiktok/profile`live · proven1 credit

The account’s public profile.

**terminal**

```
curl "https://www.monocrawl.com/v1/tiktok/profile?handle=charlidamelio" \
  -H "x-api-key: mn_your_key_here"
```

- `02``tiktok/profile-videos`live · proven1 credit

Their recent videos with view, like and comment counts. Page with the returned cursor.

**terminal**

```
curl "https://www.monocrawl.com/v1/tiktok/profile-videos?handle=nasa" \
  -H "x-api-key: mn_your_key_here"
```

## Turn a video into text

every step live · proven2 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Transcripts are priced higher because the upstream does real work; a repeat of the same link inside the cache window costs nothing.

- `01``youtube/post-transcript`live · proven2 credits

Timestamped segments plus the full text. Use the platform’s documented transcript endpoint; X uses x/tweet-transcript, not x/post-transcript.

**terminal**

```
curl "https://www.monocrawl.com/v1/youtube/post-transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DjNQXAC9IVRw" \
  -H "x-api-key: mn_your_key_here"
```

## Brand listening across platforms in one call

every step live · proven10 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Mosaic resolves the entity first, fans out, ranks and de-duplicates, and every source leaves a receipt. Estimate first — it is free.

- `01``search/all`live · proven10 credits

The plan and the maximum charge, without running anything.

**terminal**

```
curl "https://www.monocrawl.com/v1/search/all?query=Monzo&estimate=true" \
  -H "x-api-key: mn_your_key_here"
```

- `02``search/all`live · proven10 credits

The real run. No useful results charges 0; partial source failures prorate.

**terminal**

```
curl "https://www.monocrawl.com/v1/search/all?query=Monzo" \
  -H "x-api-key: mn_your_key_here"
```

## An X conversation: search, then the replies

every step live · proven6 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Search finds the posts; replies rebuild the thread under any of them with conversation ids intact.

- `01``x/search-tweets`live · proven1 credit

Posts matching the query in latest mode where supported; page size and completeness depend on the source.

**terminal**

```
curl "https://www.monocrawl.com/v1/x/search-tweets?query=Monzo%20bank&mode=latest" \
  -H "x-api-key: mn_your_key_here"
```

- `02``x/tweet-replies`live · proven5 credits

The replies under one post — pass an id from the search, or the status URL.

**terminal**

```
curl "https://www.monocrawl.com/v1/x/tweet-replies?id=1876576540177105257" \
  -H "x-api-key: mn_your_key_here"
```

## What a competitor is advertising

every step live · proven13 credits summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

Find the advertiser, list their running creatives, then read what a video ad actually says.

- `01``meta_ads/search-companies`live · proven4 credits

Resolve the advertiser.

**terminal**

```
curl "https://www.monocrawl.com/v1/meta_ads/search-companies?query=nike" \
  -H "x-api-key: mn_your_key_here"
```

- `02``meta_ads/company-ads`live · proven4 credits

Their ads in rotation.

**terminal**

```
curl "https://www.monocrawl.com/v1/meta_ads/company-ads?pageId=15087023444" \
  -H "x-api-key: mn_your_key_here"
```

- `03``meta_ads/ad-transcript`live · proven5 credits

The spoken content of one video creative.

**terminal**

```
curl "https://www.monocrawl.com/v1/meta_ads/ad-transcript?id=4439810673014351" \
  -H "x-api-key: mn_your_key_here"
```

## Watch a target on a schedule

every step live · proven1 credit summed catalogue credits (previews excluded; optional repeats, variable charges and scheduled runs need an estimate)

A monitor re-checks the same call on a cadence and keeps a timeseries; reads of the monitor itself are free.

- `01``monitors/create`live · proven1 credit

Create the monitor at its creation price. Later checks have their own per-run estimate and account credit safeguards.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/create?schedule_minutes=1440&url=https%3A%2F%2Fexample.com" \
  -H "x-api-key: mn_your_key_here"
```

- `02``monitors/runs`live · proven0 credits

A page of recorded runs; follow the returned continuation to read more.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/runs?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a" \
  -H "x-api-key: mn_your_key_here"
```

- `03``monitors/timeseries`live · proven0 credits

One metric over time.

**terminal**

```
curl "https://www.monocrawl.com/v1/monitors/timeseries?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&metric=content_length" \
  -H "x-api-key: mn_your_key_here"
```

## Want a different flow?

The [decision guide](https://www.monocrawl.com/docs/which-endpoint) maps jobs to operations, and the [playground](https://www.monocrawl.com/dashboard/api/explorer) runs any of them with your key and shows the exact response.