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.

Before you paste

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

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 guideDownload runnable Node example

  1. 01tiktok/search-toplive · 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"
  2. 02tiktok/postlive · 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 guideDownload runnable Node example

  1. 01youtube/searchlive · 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"
  2. 02youtube/videoslive · 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

  1. 01monitors/createlive · 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"
  2. 02monitors/timeserieslive · 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.

  1. 01app_store/app-reviewslive · 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"
  2. 02google_play/app-reviewslive · 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 guideDownload runnable Node example

  1. 01instagram/search-reelslive · 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"
  2. 02instagram/profilelive · 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"
  3. 03instagram/aboutlive · 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

  1. 01linkedin/search-posts-nativelive · 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"
  2. 02linkedin/profilelive · 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.

  1. 01monitors/previewlive · 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"
  2. 02monitors/createlive · 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"
  3. 03monitors/findingslive · 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.

  1. 01monitors/createlive · 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"
  2. 02monitors/createlive · 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"
  3. 03monitors/findingslive · 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.

  1. 01monitors/createlive · 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"
  2. 02monitors/runlive · 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"
  3. 03monitors/findingslive · 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.

  1. 01tiktok/profilelive · 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"
  2. 02tiktok/profile-videoslive · 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.

  1. 01youtube/post-transcriptlive · 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.

  1. 01search/alllive · 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"
  2. 02search/alllive · 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.

  1. 01x/search-tweetslive · 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"
  2. 02x/tweet-replieslive · 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.

  1. 01meta_ads/search-companieslive · 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"
  2. 02meta_ads/company-adslive · 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"
  3. 03meta_ads/ad-transcriptlive · 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.

  1. 01monitors/createlive · 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"
  2. 02monitors/runslive · 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"
  3. 03monitors/timeserieslive · 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 maps jobs to operations, and the playground runs any of them with your key and shows the exact response.

First call in under a minute

150 free credits and a ready-made key the moment you sign up. No card.