Log in

Recipes

Workflow examples, step by step

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. Failed requests cost 0 credits; successful retrievals may cost credits even when filters keep nothing.

Track brand complaints and emerging issues

every step live · proven1 credit summed catalogue credits (not a quote for variable charges or future scheduled runs)

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&monthly_cap_credits=200" \
  -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&monthly_cap_credits=200&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 (not a quote for variable charges or future scheduled runs)

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 (not a quote for variable charges or future scheduled runs)

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%22reviews%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%22reviews%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 (not a quote for variable charges or future scheduled runs)

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 · proven5 credits summed catalogue credits (not a quote for variable charges or future scheduled runs)

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 · proven5 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 · proven20 credits summed catalogue credits (not a quote for variable charges or future scheduled runs)

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 (not a quote for variable charges or future scheduled runs)

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 · proven11 credits summed catalogue credits (not a quote for variable charges or future scheduled runs)

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

  1. 01meta_ads/search-companieslive · proven3 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 · proven3 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"

Due diligence on a UK company

every step live · proven3 credits summed catalogue credits (not a quote for variable charges or future scheduled runs)

Public register data: find the company, read its profile, list its officers.

  1. 01companies_house/searchlive · proven1 credit

    Find the company number.

    terminal
    curl "https://www.monocrawl.com/v1/companies_house/search?query=NTV%20LTD" \
  -H "x-api-key: mn_your_key_here"
  2. 02companies_house/companylive · proven1 credit

    Status, incorporation, filings due.

    terminal
    curl "https://www.monocrawl.com/v1/companies_house/company?number=11364012" \
  -H "x-api-key: mn_your_key_here"
  3. 03companies_house/officerslive · proven1 credit

    Current and resigned officers.

    terminal
    curl "https://www.monocrawl.com/v1/companies_house/officers?number=11364012" \
  -H "x-api-key: mn_your_key_here"

Watch a target on a schedule

every step live · proven1 credit summed catalogue credits (not a quote for variable charges or future scheduled runs)

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 monthly cap.

    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.

Start free Quickstart