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
- Search YouTube with views and video durations
- Track a creator’s follower count each day
- Read recent customer feedback from both app stores
- Find Instagram reels and learn about their creators
- Find LinkedIn posts and inspect their authors
- Track brand complaints and emerging issues
- Watch a competitor and identify switching intent
- Monitor new app or business reviews
- A creator snapshot: profile plus recent videos
- Turn a video into text
- Brand listening across platforms in one call
- An X conversation: search, then the replies
- What a competitor is advertising
- Watch a target on a schedule
Search TikTok and retrieve exact music IDs
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
01tiktok/search-toplive · proven1 creditOne page of videos and photo posts, keeping source dates and continuation.
terminalcurl "https://www.monocrawl.com/v1/tiktok/search-top?query=space%20exploration" \ -H "x-api-key: mn_your_key_here"
02tiktok/postlive · proven1 creditOptional individual lookup for each selected distinct post missing an exact music ID. Match the returned post ID before enriching the search.
terminalcurl "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
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
01youtube/searchlive · proven1 creditOne discovery page, retaining its order, precise timestamps and continuation.
terminalcurl "https://www.monocrawl.com/v1/youtube/search?query=space%20exploration&type=video&max_results=25" \ -H "x-api-key: mn_your_key_here"
02youtube/videoslive · proven2 creditsOptional 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.
terminalcurl "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
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.
01monitors/createlive · proven1 creditSchedules 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.
terminalcurl "https://www.monocrawl.com/v1/monitors/create?kind=change&schedule_minutes=1440&platform=instagram&endpoint=profile¶ms_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"
02monitors/timeserieslive · proven0 creditsRead the selected metric for the created monitor. Use the returned monitor id and the exact /followers metric name.
terminalcurl "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
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.
01app_store/app-reviewslive · proven2 creditsOne App Store review page for the selected app and storefront. Store coverage is not a complete archive.
terminalcurl "https://www.monocrawl.com/v1/app_store/app-reviews?app_id=310633997" \ -H "x-api-key: mn_your_key_here"
02google_play/app-reviewslive · proven2 creditsOne Google Play review page for the corresponding app. Country and language controls vary by source.
terminalcurl "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
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
01instagram/search-reelslive · proven1 creditOne search page. Continue only with the returned cursor and the same search inputs; each acquired page uses its normal price.
terminalcurl "https://www.monocrawl.com/v1/instagram/search-reels?query=coffee" \ -H "x-api-key: mn_your_key_here"
02instagram/profilelive · proven1 creditOptional: one profile lookup per selected distinct creator, using the handle returned by the search.
terminalcurl "https://www.monocrawl.com/v1/instagram/profile?handle=nasa" \ -H "x-api-key: mn_your_key_here"
03instagram/aboutlive · proven10 creditsOptional: one transparency lookup per selected creator for the source-reported account country. This does not establish where a reel was filmed.
terminalcurl "https://www.monocrawl.com/v1/instagram/about?handle=nasa" \ -H "x-api-key: mn_your_key_here"
Track brand complaints and emerging issues
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.
01monitors/previewlive · proven0 creditsThe resolved subject (or the senses to choose from), the platforms with reasons, and the estimate from the price list.
terminalcurl "https://www.monocrawl.com/v1/monitors/preview?query=Monzo&purpose=complaints&schedule_minutes=360" \ -H "x-api-key: mn_your_key_here"
02monitors/createlive · proven1 creditActivates it. Pass the entity from the preview when the name was ambiguous; without it an ambiguous name is refused.
terminalcurl "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"
03monitors/findingslive · proven0 creditsWhat it found since you last looked — each finding with its platform, link, relationship and the complaint phrases it matched.
terminalcurl "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
Two monitors on one rival: what they announce and what people say back, plus the people asking for an alternative.
01monitors/createlive · proven1 creditOfficial and audience material, kept apart on every finding.
terminalcurl "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"
02monitors/createlive · proven1 creditRequests independent-audience findings matching switching phrases. These are account-level classifications, not proof of real-world identity or intent.
terminalcurl "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"
03monitors/findingslive · proven0 creditsRead and mark as seen in one call; subsequent unseen reads exclude findings marked by this call.
terminalcurl "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
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.
01monitors/createlive · proven1 creditBoth 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.
terminalcurl "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"
02monitors/runlive · proven0 creditsOptional: run it now instead of waiting for the schedule. Without confirm=true the call only quotes the cost.
terminalcurl "https://www.monocrawl.com/v1/monitors/run?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a&confirm=true" \ -H "x-api-key: mn_your_key_here"
03monitors/findingslive · proven0 creditsNew reviews since the baseline, with rating, author and text.
terminalcurl "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
Two calls give you counts, bio and the latest content with per-video stats — the basis of most creator vetting.
01tiktok/profilelive · proven1 creditThe account’s public profile.
terminalcurl "https://www.monocrawl.com/v1/tiktok/profile?handle=charlidamelio" \ -H "x-api-key: mn_your_key_here"
02tiktok/profile-videoslive · proven1 creditTheir recent videos with view, like and comment counts. Page with the returned cursor.
terminalcurl "https://www.monocrawl.com/v1/tiktok/profile-videos?handle=nasa" \ -H "x-api-key: mn_your_key_here"
Turn a video into text
Transcripts are priced higher because the upstream does real work; a repeat of the same link inside the cache window costs nothing.
01youtube/post-transcriptlive · proven2 creditsTimestamped segments plus the full text. Use the platform’s documented transcript endpoint; X uses x/tweet-transcript, not x/post-transcript.
terminalcurl "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
Mosaic resolves the entity first, fans out, ranks and de-duplicates, and every source leaves a receipt. Estimate first — it is free.
01search/alllive · proven10 creditsThe plan and the maximum charge, without running anything.
terminalcurl "https://www.monocrawl.com/v1/search/all?query=Monzo&estimate=true" \ -H "x-api-key: mn_your_key_here"
02search/alllive · proven10 creditsThe real run. No useful results charges 0; partial source failures prorate.
terminalcurl "https://www.monocrawl.com/v1/search/all?query=Monzo" \ -H "x-api-key: mn_your_key_here"
An X conversation: search, then the replies
Search finds the posts; replies rebuild the thread under any of them with conversation ids intact.
01x/search-tweetslive · proven1 creditPosts matching the query in latest mode where supported; page size and completeness depend on the source.
terminalcurl "https://www.monocrawl.com/v1/x/search-tweets?query=Monzo%20bank&mode=latest" \ -H "x-api-key: mn_your_key_here"
02x/tweet-replieslive · proven5 creditsThe replies under one post — pass an id from the search, or the status URL.
terminalcurl "https://www.monocrawl.com/v1/x/tweet-replies?id=1876576540177105257" \ -H "x-api-key: mn_your_key_here"
What a competitor is advertising
Find the advertiser, list their running creatives, then read what a video ad actually says.
01meta_ads/search-companieslive · proven4 creditsResolve the advertiser.
terminalcurl "https://www.monocrawl.com/v1/meta_ads/search-companies?query=nike" \ -H "x-api-key: mn_your_key_here"
02meta_ads/company-adslive · proven4 creditsTheir ads in rotation.
terminalcurl "https://www.monocrawl.com/v1/meta_ads/company-ads?pageId=15087023444" \ -H "x-api-key: mn_your_key_here"
03meta_ads/ad-transcriptlive · proven5 creditsThe spoken content of one video creative.
terminalcurl "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
A monitor re-checks the same call on a cadence and keeps a timeseries; reads of the monitor itself are free.
01monitors/createlive · proven1 creditCreate the monitor at its creation price. Later checks have their own per-run estimate and account credit safeguards.
terminalcurl "https://www.monocrawl.com/v1/monitors/create?schedule_minutes=1440&url=https%3A%2F%2Fexample.com" \ -H "x-api-key: mn_your_key_here"
02monitors/runslive · proven0 creditsA page of recorded runs; follow the returned continuation to read more.
terminalcurl "https://www.monocrawl.com/v1/monitors/runs?id=mon_0f2c8b1d4e6a7c9b0d1e2f3a" \ -H "x-api-key: mn_your_key_here"
03monitors/timeserieslive · proven0 creditsOne metric over time.
terminalcurl "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.