# Monocrawl — agent context

Base URL: https://www.monocrawl.com/v1
Auth: send your API key in the `x-api-key` header on every request.
Read each operation’s method below. Most data reads use GET with query parameters. POST /v1/batch accepts a JSON body; MCP uses POST /mcp with JSON-RPC. Other operations can require different methods.

Success envelope: { success: true, platform, endpoint, data, credits_used, credits_remaining, request_id, cached }
Error envelope:   { success: false, error: { type, message, status, doc_url, details? }, credits_used: number | null, request_id }
These are standard routed JSON envelopes. Batch has a separate wrapper with per-item envelopes; SSE carries its envelope in the final result event. Fields inside data vary by endpoint; missing or null fields do not mean zero or false.
Errors may omit credits_remaining when the balance is unknown. Idempotent replays carry the original historical balance; use credits/balance for the current balance.
Error types: UNAUTHORIZED, KEY_REVOKED, KEY_LIMIT_EXCEEDED, RATE_LIMITED, INSUFFICIENT_CREDITS, RESOURCE_NOT_FOUND, INVALID_PARAMETERS, UPSTREAM_ERROR, UPSTREAM_TIMEOUT, ENDPOINT_NOT_FOUND, INTERNAL_ERROR, FREE_CAPACITY_UNAVAILABLE, CAPACITY_UNAVAILABLE. Confirmed uncharged or refunded failures report zero. credits_used: null with error.details.billing_status: pending_reconciliation means unresolved accounting; retain request_id and the original idempotency key before retrying (https://www.monocrawl.com/docs/errors).
Many list endpoints use { items, count, cursor }; data is endpoint-specific, and bundles can use named collections. Follow the endpoint reference and returned continuation metadata. Keep cursors opaque and retain the original filters; use all supplied next_params together. A null or missing cursor is not proof that all history was retrieved; has_more: null means continuation is unknown. Inspect warnings and complete, partial and legs when supplied.
Response reference: https://www.monocrawl.com/docs/responses · Pagination: https://www.monocrawl.com/docs/pagination-caching

## airbnb
- GET /v1/airbnb/locations (6cr) — params: query*, limit, language, dry_run — The places the site knows for a name, each with the place id the searches take, its Google place id, country and bounds.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/locations.md
  - query (required): A city, area or address Example: "Lisbon"
  - limit (optional): Suggestions, 1 to 20 Example: "5"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/search-stays (11cr) — params: location, place_id, checkin, checkout, adults, children, infants, pets, min_price, max_price, type_of_place, property_type, bedrooms, beds, bathrooms, amenities, booking_options, host_language, top_tier, total_price, limit, cursor, currency, language, dry_run — Stays in a place for a trip: name, city, room type, rating and review count, position, the nightly price and the trip total as the site shows them, photos, instant booking and the host with their rating and years hosting. Pages by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/search-stays.md
  - location (optional): A city, area or address; resolved to a place once and remembered (or pass place_id) Example: "Lisbon"
  - place_id (optional): A place id from airbnb/locations Example: ""
  - checkin (optional): Check-in date, YYYY-MM-DD (with checkout) Example: "2026-10-10"
  - checkout (optional): Check-out date, YYYY-MM-DD (with checkin) Example: "2026-10-14"
  - adults (optional): Adults, up to 16 Example: "2"
  - children (optional): Children, up to 15 Example: ""
  - infants (optional): Infants, up to 5 Example: ""
  - pets (optional): Pets, up to 5 Example: ""
  - min_price (optional): Minimum price per night in the currency Example: ""
  - max_price (optional): Maximum price per night in the currency Example: ""
  - type_of_place (optional): The site's type-of-place filter Example: ""
  - property_type (optional): The site's property-type filter Example: ""
  - bedrooms (optional): Minimum bedrooms Example: ""
  - beds (optional): Minimum beds Example: ""
  - bathrooms (optional): Minimum bathrooms Example: ""
  - amenities (optional): The site's amenity ids, separated by commas Example: ""
  - booking_options (optional): The site's booking-option filters Example: ""
  - host_language (optional): The site's host-language filter Example: ""
  - top_tier (optional): The site's top-tier-stays filter Example: ""
  - total_price (optional): Show the trip total instead of the nightly price Example: "false"
  - limit (optional): Results per page, 1 to 50 Example: "16"
  - cursor (optional): The cursor from the previous page Example: ""
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/stay (6cr) — params: id*, url, checkin, checkout, adults, children, infants, pets, currency, language, dry_run — One stay's page: name and headline, property type, location and position, capacity, rating and reviews, description, highlights, amenities by group, house rules, safety, cancellation policies, instant booking, the host with their tags and response figures, and the photos. Sections the page carried beyond this are named in _warnings.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/stay.md
  - id (required): The listing number (or pass url, the stay's page) Example: "6332745"
  - url (optional): The stay's page URL instead of an id Example: ""
  - checkin (optional): Check-in date, YYYY-MM-DD (with checkout), for dated pricing Example: ""
  - checkout (optional): Check-out date, YYYY-MM-DD (with checkin) Example: ""
  - adults (optional): Adults, up to 16 Example: "2"
  - children (optional): Children, up to 15 Example: ""
  - infants (optional): Infants, up to 5 Example: ""
  - pets (optional): Pets, up to 5 Example: ""
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/stay-availability (6cr) — params: id*, url, month, year, months, dry_run — One stay's calendar month by month: each day's availability, whether check-in and check-out are allowed, the minimum and maximum nights and the price where the site shows one.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/stay-availability.md
  - id (required): The listing number (or pass url, the stay's page) Example: "6332745"
  - url (optional): The stay's page URL instead of an id Example: ""
  - month (optional): First month, 1 to 12 Example: "10"
  - year (optional): First year Example: "2026"
  - months (optional): How many months, 1 to 12 Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/stay-price (6cr) — params: id*, url, checkin*, checkout*, adults, children, infants, pets, total_price, currency, language, dry_run — Accommodation price for the requested dates and guests. Taxes and service fees are not included in this response.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/stay-price.md
  - id (required): The listing number (or pass url, the stay's page) Example: "6332745"
  - url (optional): The stay's page URL instead of an id Example: ""
  - checkin (required): Check-in date, YYYY-MM-DD Example: "2026-10-10"
  - checkout (required): Check-out date, YYYY-MM-DD Example: "2026-10-12"
  - adults (optional): Adults, up to 16 Example: "2"
  - children (optional): Children, up to 15 Example: ""
  - infants (optional): Infants, up to 5 Example: ""
  - pets (optional): Pets, up to 5 Example: ""
  - total_price (optional): Show the trip total instead of the nightly price Example: "false"
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/stay-rating (6cr) — params: id*, url, language, currency, dry_run — One stay's overall rating and review count with the category ratings (cleanliness, accuracy, communication, location, check-in, value).
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/stay-rating.md
  - id (required): The listing number (or pass url, the stay's page) Example: "6332745"
  - url (optional): The stay's page URL instead of an id Example: ""
  - language (optional): Language code for the site's text Example: ""
  - currency (optional): Three-letter currency code Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/airbnb/stay-reviews (3cr) — params: id, url, limit, cursor, page, sort, language, dry_run — Guest reviews with text, rating, date, reviewer and host reply where supplied. Cursor pagination preserves the requested stay and language. Text search and other sort modes are not supported.
  Reference: https://www.monocrawl.com/docs/endpoints/airbnb/stay-reviews.md
  - id (optional): Stay identifier from search-stays, or use url. Example: "1010503905929192028"
  - url (optional): Public Airbnb stay URL instead of id. Example: ""
  - limit (optional): Results per page, 1 to 50. Keep unchanged between pages. Example: "10"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - page (optional): Optional initial page; use cursor for subsequent pages. Example: "1"
  - sort (optional): Newest first; only newest/MOST_RECENT is supported. Example: "newest"
  - language (optional): Two-letter language code with optional region. Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## aliexpress
- GET /v1/aliexpress/categories (1cr) — params: language, dry_run — AliExpress's top-level categories with their children and ids for aliexpress/search.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/categories.md
  - language (optional): Locale Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/description (1cr) — params: id*, language, dry_run — The full description text and images of an AliExpress product, with its property list.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/description.md
  - id (required): AliExpress item id Example: "1005005244562338"
  - language (optional): Locale Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/product (3cr) — params: id*, region, currency, language, dry_run — One AliExpress product: title, price range and promotion, rating, sales, images and video, properties, description, variants and options, shipping options and the seller.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/product.md
  - id (required): AliExpress item id (the number in its URL), or the URL Example: "1005005244562338"
  - region (optional): Storefront country Example: "US"
  - currency (optional): Currency code Example: "USD"
  - language (optional): Locale Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/promos (1cr) — params: dry_run — The featured AliExpress promotions currently running, with the number of products in each; a name goes to aliexpress/search-promo.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/promos.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/reviews (3cr) — params: id*, page, filter, sort, dry_run — Reviews of an AliExpress product, twenty per page, with the rating distribution and buyer country.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/reviews.md
  - id (required): AliExpress item id Example: "3256809769628322"
  - page (optional): Page number (20 per page) Example: "1"
  - filter (optional): A filter value from the response's filters list Example: "allReviews"
  - sort (optional): A sort value from the response Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/search (3cr) — params: query*, page, sort, category_id, min_price, max_price, ship_from, region, currency, language, dry_run — Products matching a keyword, twenty per page, with price, promotion price, sales, rating and shipping.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/search.md
  - query (required): Search keyword Example: "iphone"
  - page (optional): Page number (20 per page) Example: "1"
  - sort (optional): A sort value from the response's sorts list Example: "default"
  - category_id (optional): Category id from aliexpress/categories Example: ""
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - ship_from (optional): Ship-from country code Example: ""
  - region (optional): Storefront country Example: "US"
  - currency (optional): Currency code Example: "USD"
  - language (optional): Locale Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/search-hot (3cr) — params: query, category_id, sort_by, page, limit, country, currency, dry_run — Currently hot AliExpress products, optionally filtered by keyword or category, with prices, discount, sales volume and shop.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/search-hot.md
  - query (optional): Keyword filter Example: "xiaomi"
  - category_id (optional): Category id filter Example: ""
  - sort_by (optional): price_asc, price_desc, volume or discount Example: "volume"
  - page (optional): Page number Example: "1"
  - limit (optional): Products per page, up to 50 Example: "10"
  - country (optional): Ship-to country Example: "US"
  - currency (optional): Price currency Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/search-promo (3cr) — params: promotion_name*, query, page, limit, country, currency, dry_run — Products in a named AliExpress promotion, with prices, discount, sales volume and shop.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/search-promo.md
  - promotion_name (required): A promotion name from aliexpress/promos Example: "New Arrival"
  - query (optional): Keyword filter Example: ""
  - page (optional): Page number Example: "1"
  - limit (optional): Products per page, up to 50 Example: "10"
  - country (optional): Ship-to country Example: "US"
  - currency (optional): Price currency Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/shipping (1cr) — params: id*, region, quantity, ext, dry_run — Shipping options for an AliExpress product to a country: carrier, fee, days and tracking.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/shipping.md
  - id (required): AliExpress item id Example: "3256804591426248"
  - region (optional): Ship-to country Example: "US"
  - quantity (optional): Quantity Example: "1"
  - ext (optional): A variant's ext token from aliexpress/product, for variant-specific rates Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/similar (3cr) — params: product_id, query, country, currency, dry_run — Products similar to an AliExpress product (or to a keyword), from the marketplace's own matching.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/similar.md
  - product_id (optional): A product id or URL Example: "3256806145778732"
  - query (optional): A keyword, when no product id is given Example: "headphones"
  - country (optional): Ship-to country Example: "US"
  - currency (optional): Price currency Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/store (1cr) — params: id*, dry_run — One AliExpress store: name, followers, product count, positive rate and seller level.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/store.md
  - id (required): Seller id from a product Example: "231651707"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/aliexpress/store-products (3cr) — params: seller_id*, store_id*, query, page, sort, dry_run — Products of one AliExpress store, optionally matching a keyword.
  Reference: https://www.monocrawl.com/docs/endpoints/aliexpress/store-products.md
  - seller_id (required): Seller id from aliexpress/product's seller block Example: "6003681832"
  - store_id (required): Store id from the same seller block Example: "1105134056"
  - query (optional): Keyword within the store Example: ""
  - page (optional): Page number Example: "1"
  - sort (optional): A sort value from the response Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## amazon
- GET /v1/amazon/best-sellers (5cr) — params: category*, country, type, page, dry_run — A marketplace best-seller chart: rank, product, price, rating and rank movement.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/best-sellers.md
  - category (required): Best-sellers category or subcategory path Example: "software"
  - country (optional): Marketplace country code (default GB) Example: "US"
  - type (optional): BEST_SELLERS, NEW_RELEASES, MOVERS_AND_SHAKERS, MOST_WISHED_FOR or GIFT_IDEAS Example: "BEST_SELLERS"
  - page (optional): Page of 50 Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/categories (5cr) — params: country, dry_run — The marketplace's departments with the ids the product search takes.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/categories.md
  - country (optional): Marketplace country code (default GB) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/deals (5cr) — params: country, categories, brands, cursor, dry_run — The marketplace deals feed with deal and list price, savings, badge, state and timing.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/deals.md
  - country (optional): Marketplace country code (default GB) Example: "US"
  - categories (optional): Departments, comma-separated Example: "electronics"
  - brands (optional): Brands, comma-separated Example: "Anker"
  - cursor (optional): Offset from the previous page Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/product (5cr) — params: asin*, location, language, dry_run — One Amazon product by ASIN: title, description, images, price, rating, brand, categories and availability. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/product.md
  - asin (required): ASIN, or an Amazon product URL Example: "B0CHX3QBCH"
  - location (optional): Location name (sets the marketplace) Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/reviews (5cr) — params: asin*, location, language, sort, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of an Amazon product with rating, text, date, verification and helpful votes. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/reviews.md
  - asin (required): ASIN, or an Amazon product URL Example: "B0CHX3QBCH"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - sort (optional): helpful or recent Example: "recent"
  - limit (optional): Reviews, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/amazon/search (5cr) — params: query*, location, language, department, limit, dry_run — Products for a query on Amazon with price range, rating, review count, badges and delivery. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/search.md
  - query (required): Search terms Example: "standing desk"
  - location (optional): Location name (sets the marketplace) Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - department (optional): Amazon department Example: "Electronics"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/seller (5cr) — params: id*, country, dry_run — A marketplace seller's public profile with rating, positive percentage and feedback summary. Contact details are never included.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/seller.md
  - id (required): Seller id (from a product's seller or offers) Example: "AY7AQ12Q1GTNE"
  - country (optional): Marketplace country code (default GB) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/seller-products (5cr) — params: id*, country, page, dry_run — The products a marketplace seller lists, with price, rating and badges.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/seller-products.md
  - id (required): Seller id Example: "AY7AQ12Q1GTNE"
  - country (optional): Marketplace country code (default GB) Example: "US"
  - page (optional): Page Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/seller-reviews (5cr) — params: id*, country, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Feedback left for a marketplace seller with rating, text, date and whether the seller responded.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/seller-reviews.md
  - id (required): Seller id Example: "AY7AQ12Q1GTNE"
  - country (optional): Marketplace country code (default GB) Example: "US"
  - page (optional): Page Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/amazon/sellers (5cr) — params: asin*, location, language, dry_run — Every seller offering an Amazon product with price, condition, shipping and seller rating. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/sellers.md
  - asin (required): ASIN, or an Amazon product URL Example: "B0CHX3QBCH"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/amazon/shop (14cr) — params: url*, country, dry_run — An Amazon shop page: the storefront profile, its posts (idea lists, photos, videos) and the products of its first idea list with prices and ratings.
  Reference: https://www.monocrawl.com/docs/endpoints/amazon/shop.md
  - url (required): An Amazon shop (influencer storefront) page URL, or the shop name Example: "https://www.amazon.com/shop/tastemade"
  - country (optional): Amazon marketplace Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## app_store
- GET /v1/app_store/app-info (1cr) — params: app_id*, country, language, dry_run — Full App Store app record: description, price, ratings, genres, screenshots, current version, release notes and size. similar_apps and more_apps_by_developer are filled only when the answering source supplies them (related_apps_included says which); the official store lookup does not carry them.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/app-info.md
  - app_id (required): Numeric App Store track id, or a bundle id like com.spotify.client Example: "324684580"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - language (optional): Result language code (e.g. en_us, ja_jp) Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/app-list (2cr) — params: app_collection*, app_category, country, language, depth, dry_run — Apple Marketing Tools top-free / top-paid app chart for a storefront, ranked.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/app-list.md
  - app_collection (required): top-free or top-paid (aliases topfreeapplications / toppaidapplications accepted) Example: "top-free"
  - app_category (optional): Not supported by the Apple charts feed; acknowledged in _warnings and ignored Example: "6014"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - language (optional): Not supported by the charts feed; acknowledged in _warnings and ignored Example: "en_us"
  - depth (optional): Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. Example: "100"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/app-reviews (2cr) — params: app_id*, country, language, depth, sort_by, rating, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Customer reviews for an app from the per-storefront Apple reviews feed: rating, title, text, author and app version.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/app-reviews.md
  - app_id (required): Numeric App Store track id Example: "324684580"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - language (optional): Not supported by the Apple reviews feed; acknowledged in _warnings and ignored Example: "en_us"
  - depth (optional): Pages of up to 50 reviews to fetch (max 5) Example: "1"
  - sort_by (optional): mostrecent (default) or mosthelpful Example: "mostrecent"
  - rating (optional): 1-5; filter applied locally after fetch (noted in _warnings) Example: "5"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/app_store/app-search (3cr) — params: query*, country, language, depth, dry_run — Search Apple App Store apps by keyword — name, developer, price, rating and genre per hit.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/app-search.md
  - query (required): Search keywords Example: "spotify"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - language (optional): Result language code (e.g. en_us, ja_jp) Example: "en_us"
  - depth (optional): Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. Example: "100"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/categories (0cr) — params: dry_run — Reference list of Apple App Store genre ids (6xxx) and Games sub-genres (7xxx). Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/languages (0cr) — params: dry_run — Reference list of iTunes Search API language codes (lang parameter). Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/languages.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/locations (0cr) — params: dry_run — Reference list of Apple App Store storefront country codes. Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/locations.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/app_store/search-suggestions (1cr) — params: query*, country, dry_run — The search terms the App Store suggests for a partial query, in the order the store ranks them.
  Reference: https://www.monocrawl.com/docs/endpoints/app_store/search-suggestions.md
  - query (required): Partial search term Example: "spotify"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## apple_music
- GET /v1/apple_music/album (1cr) — params: id, url, dry_run — Look up one Apple Music album by id or music.apple.com URL, including its full track listing.
  Reference: https://www.monocrawl.com/docs/endpoints/apple_music/album.md
  - id (optional): Apple Music album id (this or url) Example: "697194953"
  - url (optional): music.apple.com album URL (this or id) Example: "https://music.apple.com/us/album/discovery/697194953"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/apple_music/artist (1cr) — params: id, url, dry_run — Look up one Apple Music artist by id or music.apple.com URL.
  Reference: https://www.monocrawl.com/docs/endpoints/apple_music/artist.md
  - id (optional): Apple Music artist id (this or url) Example: "5468295"
  - url (optional): music.apple.com artist URL (this or id) Example: "https://music.apple.com/us/artist/daft-punk/5468295"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/apple_music/search (3cr) — params: query*, type, limit, dry_run — Search Apple Music artists, albums, and tracks by keyword.
  Reference: https://www.monocrawl.com/docs/endpoints/apple_music/search.md
  - query (required): Search terms Example: "daft punk"
  - type (optional): Restrict results: artist, album, or track (omit for all music) Example: "artist"
  - limit (optional): Max results, 1-50 (default 25) Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/apple_music/track (1cr) — params: id, url, dry_run — Look up one Apple Music track by id or music.apple.com URL, with preview audio and album context.
  Reference: https://www.monocrawl.com/docs/endpoints/apple_music/track.md
  - id (optional): Apple Music track id (this or url) Example: "697195462"
  - url (optional): music.apple.com track or album?i= URL (this or id) Example: "https://music.apple.com/us/album/discovery/697194953?i=697195462"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## bluesky
- GET /v1/bluesky/post (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Fetch a single Bluesky post from its bsky.app URL: text, author and like/repost/reply/quote counts.
  Reference: https://www.monocrawl.com/docs/endpoints/bluesky/post.md
  - url (required): bsky.app post link or at:// post URI Example: "https://bsky.app/profile/espn.com/post/3lqdfq7fkvm2g"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/bluesky/profile (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Fetch a Bluesky profile by handle or DID: display name, bio, follower/following/post counts and avatar.
  Reference: https://www.monocrawl.com/docs/endpoints/bluesky/profile.md
  - handle (required): Bluesky handle (e.g. alice.bsky.social) or DID Example: "bsky.app"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/bluesky/search (3cr) — params: query*, limit, sort, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Full-text search over public Bluesky posts with engagement counts.
  Reference: https://www.monocrawl.com/docs/endpoints/bluesky/search.md
  - query (required): Search text Example: "nextjs"
  - limit (optional): Max results (1-100) Example: "25"
  - sort (optional): top or latest Example: "latest"
  - cursor (optional): Continue a previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/bluesky/user/posts (1cr) — params: handle, user_id, limit, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — List a Bluesky account's posts (newest first) with like/repost/reply/quote counts; reposts are included and labeled is_repost.
  Reference: https://www.monocrawl.com/docs/endpoints/bluesky/user/posts.md
  - handle (optional): Bluesky handle (provide this or user_id) Example: "bsky.app"
  - user_id (optional): Account DID (provide this or handle) Example: "did:plc:z72i7hdynmk6r22z27h6tvur"
  - limit (optional): Posts per page, 1-100 (default 25) Example: "25"
  - cursor (optional): Opaque cursor from a previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## booking
- GET /v1/booking/attraction (3cr) — params: slug*, url, currency, language, dry_run — One attraction's page: description, price, rating and reviews, cancellation, operator, what is included and not, languages, photos, meeting and departure addresses, offers and the latest reviews.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/attraction.md
  - slug (required): The attraction's slug from booking/search-attractions (or pass url, its page) Example: "pr4z1zrjq9hl-skip-the-queue-tickets-into-the-lisbon-oceanarium"
  - url (optional): The attraction's page URL instead of a slug Example: ""
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/attraction-locations (2cr) — params: query*, language, dry_run — The attractions destinations the site knows for a name, each with the id booking/search-attractions takes and how many things to do it holds, plus the named attractions that match.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/attraction-locations.md
  - query (required): A city or an attraction name Example: "Lisbon"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/flight-locations (2cr) — params: query*, language, dry_run — The airports and cities the flight search knows for a name, each with the code booking/search-flights takes (LHR.AIRPORT, LON.CITY).
  Reference: https://www.monocrawl.com/docs/endpoints/booking/flight-locations.md
  - query (required): A city or airport name Example: "London"
  - language (optional): Language code for the site's text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/hotel (3cr) — params: id*, checkin*, checkout*, adults, children_ages, rooms, currency, language, units, temperature_unit, dry_run — One hotel's page for a stay: address and position, type, the price with its per-night and all-inclusive figures, facilities and highlights, breakfast and Wi-Fi scores, sustainability tier, the important information, each room with its beds, facilities and photos, and every bookable offer with its cancellation and prepayment terms.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/hotel.md
  - id (required): The hotel's number, from booking/search-hotels Example: "4045490"
  - checkin (required): Check-in date, YYYY-MM-DD Example: "2026-10-10"
  - checkout (required): Check-out date, YYYY-MM-DD Example: "2026-10-12"
  - adults (optional): Adults, 1 to 30 Example: "2"
  - children_ages (optional): Children's ages, separated by commas Example: ""
  - rooms (optional): Rooms, 1 to 30 Example: "1"
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: "en-gb"
  - units (optional): metric or imperial Example: ""
  - temperature_unit (optional): c or f Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/hotel-availability (3cr) — params: id*, from*, to*, adults, rooms, currency, dry_run — The nights a hotel has available between two dates, each with its price and minimum stay.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/hotel-availability.md
  - id (required): The hotel's number, from booking/search-hotels Example: "4045490"
  - from (required): First date, YYYY-MM-DD Example: "2026-12-20"
  - to (required): Last date, YYYY-MM-DD Example: "2026-12-31"
  - adults (optional): Adults, 1 to 30 Example: "2"
  - rooms (optional): Rooms, 1 to 30 Example: "1"
  - currency (optional): Three-letter currency code Example: "GBP"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/hotel-review-scores (2cr) — params: id*, language, dry_run — How one hotel's score breaks down: by traveller type and question (cleanliness, staff, location…) against the area's average, by score band, and the distribution of scores.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/hotel-review-scores.md
  - id (required): The hotel's number, from booking/search-hotels Example: "4045490"
  - language (optional): Language code for the site's text Example: "en-us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/hotel-reviews (3cr) — params: id*, page, sort, language, dry_run — Guest reviews of one hotel: title, what they liked and disliked, score, date, purpose of travel, the reviewer's country and traveller type, the room and nights they stayed, photos and the hotel's reply.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/hotel-reviews.md
  - id (required): The hotel's number, from booking/search-hotels Example: "4045490"
  - page (optional): Page number (25 a page) Example: "1"
  - sort (optional): relevant, newest, oldest, highest or lowest Example: "relevant"
  - language (optional): Language code for the site's text Example: "en-us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/hotel-rooms (3cr) — params: id*, checkin*, checkout*, adults, children_ages, rooms, currency, language, units, dry_run — One hotel's rooms for a stay and every bookable offer on them: price with its per-night and all-inclusive figures, occupancy, size, meal plan, cancellation and prepayment terms, deposit, and how many are left.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/hotel-rooms.md
  - id (required): The hotel's number, from booking/search-hotels Example: "4045490"
  - checkin (required): Check-in date, YYYY-MM-DD Example: "2026-10-10"
  - checkout (required): Check-out date, YYYY-MM-DD Example: "2026-10-12"
  - adults (optional): Adults, 1 to 30 Example: "2"
  - children_ages (optional): Children's ages, separated by commas Example: ""
  - rooms (optional): Rooms, 1 to 30 Example: "1"
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: "en-gb"
  - units (optional): metric or imperial Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/locations (2cr) — params: query*, dry_run — The destinations the site knows for a name: cities, districts, landmarks and hotels, each with the id and type booking/search-hotels takes and how many hotels it holds.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/locations.md
  - query (required): A city, district, landmark or hotel name Example: "Manhattan"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/search-attractions (3cr) — params: location, destination_id, page, sort, start_date, end_date, currency, language, types, labels, prices, areas, dry_run — Things to do in a destination: name, description, price, free cancellation, rating and review count, photo and the city.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/search-attractions.md
  - location (optional): A city; resolved to a destination once and remembered (or pass destination_id) Example: "Lisbon"
  - destination_id (optional): A destination id from booking/attraction-locations Example: "eyJ1ZmkiOi0yMTY3OTczfQ=="
  - page (optional): Page number Example: "1"
  - sort (optional): trending, attr_book_score or lowest_price Example: "trending"
  - start_date (optional): First date, YYYY-MM-DD Example: ""
  - end_date (optional): Last date, YYYY-MM-DD Example: ""
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: ""
  - types (optional): The site's type filters, separated by commas Example: ""
  - labels (optional): The site's label filters, separated by commas Example: ""
  - prices (optional): The site's price filters, separated by commas Example: ""
  - areas (optional): The site's area filters, separated by commas Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/search-flights (3cr) — params: from*, to*, depart_date*, return_date, adults, children_ages, cabin, sort, stops, page, currency, dry_run — Flights between two places: each offer's price with its base fare and tax, seats left, and every segment and leg with airports, times, carrier, flight number, cabin and luggage allowance; plus the search's summary (cheapest fare, airlines, stops).
  Reference: https://www.monocrawl.com/docs/endpoints/booking/search-flights.md
  - from (required): Departure place code from booking/flight-locations Example: "LON.CITY"
  - to (required): Arrival place code from booking/flight-locations Example: "LIS.AIRPORT"
  - depart_date (required): Outbound date, YYYY-MM-DD Example: "2026-11-25"
  - return_date (optional): Return date, YYYY-MM-DD, for a round trip Example: ""
  - adults (optional): Adults, 1 to 9 Example: "1"
  - children_ages (optional): Children's ages, separated by commas Example: ""
  - cabin (optional): economy, premium_economy, business or first Example: "economy"
  - sort (optional): best, cheapest or fastest Example: "best"
  - stops (optional): none, 0, 1 or 2 Example: ""
  - page (optional): Page number Example: "1"
  - currency (optional): Three-letter currency code Example: "GBP"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/booking/search-hotels (3cr) — params: location, destination_id, destination_type, checkin*, checkout*, adults, children_ages, rooms, page, sort, min_price, max_price, filters, currency, language, units, temperature_unit, dry_run — Hotels in a destination for a stay: name, stars, review score and count, the price for the stay, check-in and check-out times, position, photos and whether the site prefers it.
  Reference: https://www.monocrawl.com/docs/endpoints/booking/search-hotels.md
  - location (optional): A city, district, landmark or hotel name; resolved to a destination once and remembered (or pass destination_id and destination_type) Example: "Lisbon"
  - destination_id (optional): A destination id from booking/locations Example: "-2167973"
  - destination_type (optional): The destination's type from booking/locations Example: "CITY"
  - checkin (required): Check-in date, YYYY-MM-DD Example: "2026-10-10"
  - checkout (required): Check-out date, YYYY-MM-DD Example: "2026-10-12"
  - adults (optional): Adults, 1 to 30 Example: "2"
  - children_ages (optional): Children's ages, separated by commas Example: ""
  - rooms (optional): Rooms, 1 to 30 Example: "1"
  - page (optional): Page number Example: "1"
  - sort (optional): popularity, price, class, review_score or distance Example: ""
  - min_price (optional): Minimum price per night in the currency Example: ""
  - max_price (optional): Maximum price per night in the currency Example: ""
  - filters (optional): The site's category filters, separated by commas (class::4, free_cancellation::1…) Example: ""
  - currency (optional): Three-letter currency code Example: "GBP"
  - language (optional): Language code for the site's text Example: "en-gb"
  - units (optional): metric or imperial Example: ""
  - temperature_unit (optional): c or f Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## cohort-queries
- GET /v1/cohort-queries/delete (0cr) — params: query_id*, dry_run — Delete one of your cohort sweeps and its results. A sweep still queued is cancelled and refunded; one already running is cancelled and its charge stands.
  Reference: https://www.monocrawl.com/docs/endpoints/cohort-queries/delete.md
  - query_id (required): Cohort query id (the {queryId} path segment) Example: "cq_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohort-queries/get (0cr) — params: query_id*, dry_run — The status of one cohort keyword sweep, with per-member progress while it runs.
  Reference: https://www.monocrawl.com/docs/endpoints/cohort-queries/get.md
  - query_id (required): Cohort query id (the {queryId} path segment) Example: "cq_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohort-queries/results (0cr) — params: query_id*, cursor, limit, dry_run — The keyword matches a finished cohort sweep found, per member, newest page first.
  Reference: https://www.monocrawl.com/docs/endpoints/cohort-queries/results.md
  - query_id (required): Cohort query id (the {queryId} path segment) Example: "cq_0f2c8b1d4e6a7c9b0d1e2f3a"
  - cursor (optional): Opaque cursor from the previous page of matches Example: ""
  - limit (optional): Matches per page, 1-100 (default 25) Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## cohorts
- GET /v1/cohorts/create (1cr) — params: name*, members*, dry_run — Save a set of up to 100 accounts, subreddits or handles as a cohort you can sweep with one keyword.
  Reference: https://www.monocrawl.com/docs/endpoints/cohorts/create.md
  - name (required): Human label for this cohort (max 200 characters) Example: "Rust ecosystem"
  - members (required): The accounts to sweep: a comma-separated platform:identifier list, or a JSON array of {"platform","identifier"} objects. 1-100 members; every platform must exist in the catalogue. Example: "reddit:rust,hackernews:steveklabnik,github:rust-lang/rust,bluesky:rust-lang.bsky.social"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohorts/delete (0cr) — params: cohort_id*, dry_run — Delete one of your cohorts and every query it ran. A running sweep is cancelled first; its charge is refunded only if it had not started.
  Reference: https://www.monocrawl.com/docs/endpoints/cohorts/delete.md
  - cohort_id (required): Cohort id (the {cohortId} path segment) Example: "coh_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohorts/get (0cr) — params: cohort_id*, dry_run — One cohort with its members and the most recent keyword queries run against it.
  Reference: https://www.monocrawl.com/docs/endpoints/cohorts/get.md
  - cohort_id (required): Cohort id (the {cohortId} path segment) Example: "coh_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohorts/members (0cr) — params: cohort_id*, members*, dry_run — Replace a cohort's member list in one call. Sweeps already completed keep the results they produced.
  Reference: https://www.monocrawl.com/docs/endpoints/cohorts/members.md
  - cohort_id (required): Cohort id (the {cohortId} path segment) Example: "coh_0f2c8b1d4e6a7c9b0d1e2f3a"
  - members (required): The new member list, replacing the old one entirely: a comma-separated platform:identifier list, or a JSON array of {"platform","identifier"} objects. 1-100 members; every platform must exist in the catalogue. Example: "reddit:rust,hackernews:steveklabnik,github:rust-lang/rust"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/cohorts/queries (10cr) — params: cohort_id*, keyword*, dry_run — Run one keyword across every member of a cohort. Asynchronous: returns a query id to poll.
  Reference: https://www.monocrawl.com/docs/endpoints/cohorts/queries.md
  - cohort_id (required): Cohort id (the {cohortId} path segment) Example: "coh_0f2c8b1d4e6a7c9b0d1e2f3a"
  - keyword (required): The keyword swept across every member of the cohort (max 200 characters) Example: "async runtime"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## companies_house
- GET /v1/companies_house/company (1cr) — params: number*, dry_run — Full register entry: status, type, incorporation date, registered office, SIC codes, accounts and filing due dates.
  Reference: https://www.monocrawl.com/docs/endpoints/companies_house/company.md
  - number (required): Eight-character company number. Example: "11364012"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/companies_house/officers (1cr) — params: number*, limit, dry_run — Directors and secretaries: role, appointment and resignation dates, nationality, and month/year of birth only.
  Reference: https://www.monocrawl.com/docs/endpoints/companies_house/officers.md
  - number (required): Eight-character company number. Example: "11364012"
  - limit (optional): Results per page, 1–100 (default 20). Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/companies_house/search (1cr) — params: query*, limit, cursor, dry_run — Search the UK register by company name or number. Returns number, status, type and incorporation date.
  Reference: https://www.monocrawl.com/docs/endpoints/companies_house/search.md
  - query (required): Company name or number to search for. Example: "NTV LTD"
  - limit (optional): Results per page, 1–100 (default 20). Example: "20"
  - cursor (optional): Opaque cursor from a previous page. Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## content_analysis
- GET /v1/content_analysis/categories (0cr) — params: dry_run — Monocrawl's own mention-classification taxonomy (taxonomy id monocrawl.content_analysis.v1), including the full keyword list behind each category so any classification can be audited. Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/filters (0cr) — params: dry_run — The filterable fields for the content analysis endpoints — field, type, operators, allowed values, which endpoints accept it and whether it is applied upstream or locally. Generated from the adapter's own filter implementation, so it cannot drift. Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/filters.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/languages (0cr) — params: dry_run — Reference list of the ISO-639-1 language codes content analysis can genuinely filter on, each marked with which source honours it. Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/languages.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/locations (0cr) — params: dry_run — Reference list of the ISO-3166 alpha-2 country codes content analysis can genuinely filter on — publisher country for news, storefront for rating-distribution. Static, costs no credits.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/locations.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/phrase-trends (5cr) — params: keyword*, date_from*, date_to, date_group, page_type, internal_list_limit, depth, filters, dry_run — Mention volume and sentiment for a keyword bucketed by day, week or month across the sources we can reach. Bucket heights are bounded by each source's per-query cap, so the series is a shape, not a census — the response says so explicitly.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/phrase-trends.md
  - keyword (required): Phrase to trend Example: "kubernetes"
  - date_from (required): ISO-8601 start of the window Example: "2026-08-01"
  - date_to (optional): ISO-8601 end of the window (default now) Example: "2026-08-31"
  - date_group (optional): day (default), week or month; max 400 buckets Example: "day"
  - page_type (optional): all, news, forum, social or discussion Example: "all"
  - internal_list_limit (optional): Length of the embedded top-terms list (max 50) Example: "10"
  - depth (optional): Items fetched PER SOURCE before bucketing (max 100) Example: "100"
  - filters (optional): field:op:value segments joined by ; — see /v1/content_analysis/filters Example: "source:eq:hackernews"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/rating-distribution (3cr) — params: keyword*, country, depth, filters, dry_run — Real 1-5 star histogram for a keyword that resolves to an App Store app, built from actual published reviews plus Apple's own lifetime average. If the keyword resolves to nothing rateable it returns 404 — no histogram is ever synthesised.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/rating-distribution.md
  - keyword (required): Name of a rateable entity — currently an App Store app Example: "Spotify"
  - country (optional): 2-letter App Store storefront (default us); filters=location_code:eq:gb works too Example: "us"
  - depth (optional): Pages of up to 50 reviews to sample (max 5) Example: "3"
  - filters (optional): Only location_code applies here — see /v1/content_analysis/filters Example: "location_code:eq:gb"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/search (3cr) — params: keyword*, page_type, search_mode, limit, cursor, order_by, depth, positive_connotation_threshold, sentiments_connotation_threshold, filters, dry_run — Web citations of a keyword from news, Hacker News and Reddit with deterministic per-mention sentiment (in-adapter lexicon, no AI), Monocrawl category labels and per-source provenance. Fans out to 3 upstreams; coverage is partial and every response names what it could not consult.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/search.md
  - keyword (required): Phrase to find mentions of Example: "kubernetes"
  - page_type (optional): all, news, forum, social or discussion — maps onto our source roster; review/blog/ecommerce classes are rejected with an explanation rather than silently served from the wrong sources Example: "all"
  - search_mode (optional): as_is (default) or one_per_domain (keep the first mention per publisher) Example: "as_is"
  - limit (optional): Mentions per page after merging (max 100) Example: "25"
  - cursor (optional): Offset into the merged result set, from a previous response Example: "25"
  - order_by (optional): published_at:desc|asc, sentiment:desc|asc, source or relevance Example: "published_at:desc"
  - depth (optional): Items fetched PER SOURCE before merging (max 100) Example: "25"
  - positive_connotation_threshold (optional): Score in (0,1] at or above which a mention is labelled positive Example: "0.25"
  - sentiments_connotation_threshold (optional): Score magnitude at or below which a mention is labelled negative Example: "0.25"
  - filters (optional): field:op:value segments joined by ; — see /v1/content_analysis/filters Example: "source:in:hackernews,reddit;sentiment:eq:negative"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/sentiment (3cr) — params: keyword*, page_type, positive_connotation_threshold, sentiments_connotation_threshold, depth, filters, dry_run — Positive / neutral / negative split for a keyword with mean, median and a score histogram, plus the most positive and most negative mentions. Lexicon-based and fully deterministic — the method, its thresholds and its limits are returned with every response.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/sentiment.md
  - keyword (required): Phrase to score Example: "kubernetes"
  - page_type (optional): all, news, forum, social or discussion Example: "all"
  - positive_connotation_threshold (optional): Score in (0,1] at or above which a mention is positive Example: "0.25"
  - sentiments_connotation_threshold (optional): Score magnitude at or below which a mention is negative Example: "0.25"
  - depth (optional): Items fetched PER SOURCE before aggregating (max 100) Example: "50"
  - filters (optional): field:op:value segments joined by ; — see /v1/content_analysis/filters Example: "source:eq:hackernews"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/content_analysis/summary (3cr) — params: keyword*, page_type, positive_connotation_threshold, sentiments_connotation_threshold, internal_list_limit, depth, filters, dry_run — Aggregate view of a keyword's mentions: volume, per-source breakdown, sentiment split, category mix, top publishers and top terms — all computed deterministically from the mentions we could reach.
  Reference: https://www.monocrawl.com/docs/endpoints/content_analysis/summary.md
  - keyword (required): Phrase to summarise mentions of Example: "kubernetes"
  - page_type (optional): all, news, forum, social or discussion Example: "all"
  - positive_connotation_threshold (optional): Score in (0,1] at or above which a mention is positive Example: "0.25"
  - sentiments_connotation_threshold (optional): Score magnitude at or below which a mention is negative Example: "0.25"
  - internal_list_limit (optional): Length of the embedded top-terms / category / publisher lists (max 50) Example: "10"
  - depth (optional): Items fetched PER SOURCE before aggregating (max 100) Example: "50"
  - filters (optional): field:op:value segments joined by ; — see /v1/content_analysis/filters Example: "category:eq:reliability_outage"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## credits
- GET /v1/credits/balance (0cr) — params: dry_run — Your current credit balance: credits remaining, lifetime credits, and when the balance last changed. Free to call.
  Reference: https://www.monocrawl.com/docs/endpoints/credits/balance.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/credits/transactions (0cr) — params: limit, cursor, request_id, dry_run — Your credit ledger, newest first: grants, purchases, spends and refunds with the balance after each. Cursor-paginated; free to call.
  Reference: https://www.monocrawl.com/docs/endpoints/credits/transactions.md
  - limit (optional): Rows per page (default 25, max 100) Example: "25"
  - cursor (optional): Opaque cursor from the previous page Example: "18432"
  - request_id (optional): Only ledger rows tied to this API request id Example: "req_1a2b3c"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## ebay
- GET /v1/ebay/product (1cr) — params: product_id*, country, dry_run — Look up one eBay listing by item id or ebay.com/itm URL: full price, condition, seller, item specifics, availability, shipping, returns, and ratings.
  Reference: https://www.monocrawl.com/docs/endpoints/ebay/product.md
  - product_id (required): eBay item id: a numeric legacy id, a v1|…|… RESTful id, or an ebay.com/itm/ URL Example: "327256602116"
  - country (optional): Marketplace: a country code (us, gb, de…) or a raw eBay marketplace id (EBAY_US). Default us. Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/ebay/search (3cr) — params: query*, country, page, sort_by, condition, buying_format, show_only, min_price, max_price, aspects, cursor, dry_run — Search live eBay listings by keyword: title, price, condition, seller, shipping, and thumbnails, with filters for price, condition, and buying format.
  Reference: https://www.monocrawl.com/docs/endpoints/ebay/search.md
  - query (required): Keywords to search listing titles for Example: "iphone 11"
  - country (optional): Marketplace: a country code (us, gb, de, au, ca, fr…) or a raw eBay marketplace id (EBAY_US). Default us. Example: "us"
  - page (optional): 1-based page number (mapped to offset = (page-1)*limit); use cursor to paginate reliably Example: "1"
  - sort_by (optional): Best-effort sort: price_asc, price_desc, newest, or distance (unrecognized values are ignored) Example: "price_asc"
  - condition (optional): Item condition filter, comma-separated: new, used, refurbished, open_box, for_parts Example: "new"
  - buying_format (optional): Buying format filter, comma-separated: fixed_price, auction, best_offer, classified_ad Example: "auction"
  - show_only (optional): Extra filters, comma-separated: free_shipping, returns_accepted, authenticity_guarantee Example: "free_shipping"
  - min_price (optional): Minimum price in the marketplace currency Example: "50"
  - max_price (optional): Maximum price in the marketplace currency Example: "500"
  - aspects (optional): Raw eBay aspect_filter expression to narrow by item aspects Example: "Brand:{Apple}"
  - cursor (optional): Opaque pagination cursor returned by the previous page (a stringified offset) Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## etsy
- GET /v1/etsy/categories (4cr) — params: parent_id, depth, query, dry_run — The Etsy category tree, or one branch of it.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/categories.md
  - parent_id (optional): Parent category id for its children Example: ""
  - depth (optional): Tree depth, 1-3 Example: "1"
  - query (optional): Category name search Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/category-products (4cr) — params: path*, page, sort, min_price, max_price, dry_run — Listings in an Etsy category, 64 per page.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/category-products.md
  - path (required): Category path, or its etsy.com/c/ URL Example: "jewelry/necklaces"
  - page (optional): Page number (64 per page) Example: "1"
  - sort (optional): relevancy, most_recent, price_asc, price_desc or highest_reviews Example: ""
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/product (4cr) — params: id*, currency, region, language, dry_run — One Etsy listing: title, description, price, availability, images, tags, materials, category, shop, favourites, views and recent reviews.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/product.md
  - id (required): Etsy listing id, or its URL Example: "4429284280"
  - currency (optional): Currency code Example: "USD"
  - region (optional): Two-letter region Example: "US"
  - language (optional): Language Example: "en-US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/reviews (4cr) — params: id*, page, scope, sort, rating, dry_run — Reviews of an Etsy listing, eight per page, with the rating distribution and review themes.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/reviews.md
  - id (required): Etsy listing id, or its URL Example: "4429284280"
  - page (optional): Page number (8 per page) Example: "1"
  - scope (optional): listing or shop Example: "listing"
  - sort (optional): relevancy, recency, highest or lowest Example: "relevancy"
  - rating (optional): Only this star rating (1-5) Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/search (4cr) — params: query*, page, sort, min_price, max_price, ship_to, currency, region, language, dry_run — Listings matching a keyword, twelve per page, with price, discount, shop, rating and badges.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/search.md
  - query (required): Search keyword Example: "wool socks"
  - page (optional): Page number (12 per page) Example: "1"
  - sort (optional): relevancy, most_recent, price_asc, price_desc or highest_reviews Example: "relevancy"
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - ship_to (optional): Two-letter country Example: ""
  - currency (optional): Currency code Example: "USD"
  - region (optional): Two-letter region Example: "US"
  - language (optional): Language Example: "en-US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/shop (4cr) — params: shop*, dry_run — One Etsy shop: sales, rating, seller, location, listing counts and sections.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/shop.md
  - shop (required): Shop name, numeric id or URL Example: "Qorux"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/shop-products (4cr) — params: shop*, page, limit, section_id, sort, dry_run — The listings of an Etsy shop, with price, discount, badges and processing time.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/shop-products.md
  - shop (required): Shop name, numeric id or URL Example: "Qorux"
  - page (optional): Page number Example: "1"
  - limit (optional): Up to 48 per page Example: "24"
  - section_id (optional): A section id from etsy/shop Example: ""
  - sort (optional): created, price_asc, price_desc or score Example: "created"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/shop-reviews (4cr) — params: shop*, page, sort, rating, dry_run — Reviews of an Etsy shop across its listings, eight per page.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/shop-reviews.md
  - shop (required): Shop name, numeric id or URL Example: "Qorux"
  - page (optional): Page number (8 per page) Example: "1"
  - sort (optional): recency, relevancy, highest or lowest Example: "recency"
  - rating (optional): Only this star rating (1-5) Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/shops (4cr) — params: query*, page, sort, dry_run — Shops matching a keyword, twelve per page.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/shops.md
  - query (required): Search keyword Example: "ceramic"
  - page (optional): Page number (12 per page) Example: "1"
  - sort (optional): most_relevant, most_recent or alphabetical Example: "most_relevant"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/similar (4cr) — params: id*, limit, dry_run — Listings similar to one listing.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/similar.md
  - id (required): Etsy listing id, or its URL Example: "4429284280"
  - limit (optional): Up to 48 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/etsy/suggestions (4cr) — params: query*, dry_run — Search suggestions for a partial query, with the categories each suggests.
  Reference: https://www.monocrawl.com/docs/endpoints/etsy/suggestions.md
  - query (required): Partial search text Example: "gift"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## facebook
- GET /v1/facebook/city-events (4cr) — params: url*, time, cursor, dry_run — The public events on a city's Facebook events page, one page at a time and optionally limited to today, this week or next week: name, when, where, kind, cover, price range and interest counts.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/city-events.md
  - url (required): A city's Facebook events page URL Example: "https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547"
  - time (optional): today, this_week or next_week; omitted = all time Example: "this_week"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/comment-replies (2cr) — params: feedback_id*, expansion_token*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The reply thread under one Facebook comment — chain feedback_id + expansion_token from facebook/post-comments. Facebook hides some reply threads; an empty list is the platform's real answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/comment-replies.md
  - feedback_id (required): feedback_id from a facebook/post-comments row.
  - expansion_token (required): expansion_token from the same facebook/post-comments row.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/event (2cr) — params: id*, url, dry_run — One event in full: description, timing, location and coordinates, attendance count, hosts, creator, ticket link and cover.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/event.md
  - id (required): Event id (or pass url) Example: "1234567890123456"
  - url (optional): Event URL, instead of id Example: "https://www.facebook.com/events/1234567890123456"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/events (2cr) — params: url*, cursor, dry_run — The events a page has published, one page at a time: name, when, where, kind and whether it is online, past or cancelled.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/events.md
  - url (required): Page URL Example: "https://www.facebook.com/nasa"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/events-search (2cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public events matching a query, one page at a time. A search result carries the event id, name and link; this source lists no timing, place or flags, so those fields are null here. Read one event in full (timing, location, hosts, attendance) with facebook/event.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/events-search.md
  - query (required): Search query Example: "astronomy night"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/group (2cr) — params: url*, dry_run — A public Facebook group: name, member count and description.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/group.md
  - url (required): Facebook group URL. Example: "https://www.facebook.com/groups/366190054572553/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/group-posts (2cr) — params: url*, cursor, sort_by, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts in a public Facebook group with reaction and comment counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/group-posts.md
  - url (required): Facebook group URL. Example: "https://www.facebook.com/groups/366190054572553/"
  - cursor (optional): Opaque cursor from the previous page.
  - sort_by (optional): CHRONOLOGICAL or TOP_POSTS.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/marketplace-item (2cr) — params: id*, url, dry_run — One Marketplace listing in full: description, photos, attributes, availability and price as displayed. Fields the seller did not publish stay null.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/marketplace-item.md
  - id (required): Listing id from facebook/marketplace-search (or pass url). Example: "28157874247229481"
  - url (optional): Full marketplace item URL — alternative to id.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/marketplace-locations (2cr) — params: query*, dry_run — Resolve a place name to Marketplace-usable coordinates. Returns candidate locations with lat/lng — pick the right one before searching.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/marketplace-locations.md
  - query (required): City or place name to resolve. Example: "Austin"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/marketplace-search (2cr) — params: query*, lat*, lng*, radius_km, min_price, max_price, sort_by, condition, date_listed, availability, delivery_method, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search Facebook Marketplace listings around a point: title, price, image and listing URL. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/marketplace-search.md
  - query (required): What to search for. Example: "bike"
  - lat (required): Latitude from facebook/marketplace-locations. Example: "30.2672"
  - lng (required): Longitude from facebook/marketplace-locations. Example: "-97.7431"
  - radius_km (optional): Search radius in km.
  - min_price (optional): Minimum price.
  - max_price (optional): Maximum price.
  - sort_by (optional): e.g. creation_time_descend.
  - condition (optional): e.g. used_good.
  - date_listed (optional): Listed within N days.
  - availability (optional): e.g. available.
  - delivery_method (optional): e.g. local_pickup.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/photos (2cr) — params: url*, cursor, dry_run — A profile's photos with captions and reaction counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/photos.md
  - url (required): Facebook profile or page URL. Example: "https://www.facebook.com/NASA"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/post (2cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One Facebook post: text, reaction breakdown, comment and share counts.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/post.md
  - url (required): Full Facebook post URL. Example: "https://www.facebook.com/reel/2839681326387786/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/post-comments (2cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Comments on a Facebook post with reaction and reply counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/post-comments.md
  - url (required): Full Facebook post URL. Example: "https://www.facebook.com/reel/2839681326387786/"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/post-transcript (5cr) — params: url*, dry_run — The spoken words of a Facebook video or reel as text. transcript is null when the video has no speech or captions — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/post-transcript.md
  - url (required): Facebook video post or reel URL, video under ~2 minutes. Example: "https://www.facebook.com/reel/1114235920664408"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/facebook/posts (2cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts on a Facebook page with reaction and comment counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/posts.md
  - url (required): Facebook page URL. Example: "https://www.facebook.com/nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/profile (2cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A Facebook page's public profile: category, contact details, follower and like counts.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/profile.md
  - url (required): Facebook page URL. Example: "https://www.facebook.com/nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/profile/full (47cr) — params: url*, posts, cursor, include, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields are transparent page arithmetic, not SocialCrawl metric-schema equivalence.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/profile/full.md
  - url (required): Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. Example: "https://www.facebook.com/mrbeast"
  - posts (optional): Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. Example: "25"
  - cursor (optional): Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
  - include (optional): CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. Example: "posts,computed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/reels (2cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A profile's reels: description, view count, duration, music and video URL per reel. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/reels.md
  - url (required): Facebook profile URL (personal profiles expose a reels tab; pages often do not). Example: "https://www.facebook.com/pacemorby"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/reels/full (25cr) — params: url*, cursor, max_pages, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Bounded automatic pagination through registered sources. Retains entire pages, removes duplicate IDs, returns stop_reason, complete and next_params. Up to five pages per request; not guaranteed full account history. Charges successful fresh component calls at max(5, underlying price), with normal lower cache-hit pricing.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/reels/full.md
  - url (required): Public profile identifier. Example: "https://www.facebook.com/mrbeast"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - max_pages (optional): Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/search-pages (12cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/search-pages.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/search-people (12cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/search-people.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/search-posts (12cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/search-posts.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/facebook/search-videos (12cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.
  Reference: https://www.monocrawl.com/docs/endpoints/facebook/search-videos.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## finance
- GET /v1/finance/history (1cr) — params: symbol*, interval, range, dry_run — OHLCV bars for one instrument over a range at an interval.
  Reference: https://www.monocrawl.com/docs/endpoints/finance/history.md
  - symbol (required): Ticker symbol Example: "AAPL"
  - interval (optional): 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo or 3mo Example: "1d"
  - range (optional): 1d, 5d, 7d, 15d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd or max Example: "1mo"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/finance/news (1cr) — params: symbol*, dry_run — Recent news articles about one instrument: title, publisher, link, time and related tickers.
  Reference: https://www.monocrawl.com/docs/endpoints/finance/news.md
  - symbol (required): Ticker symbol Example: "AAPL"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/finance/options (2cr) — params: symbol*, dry_run — The nearest expiry's options chain for one instrument: calls and puts with strike, last, bid, ask, volume, open interest and implied volatility, plus the other expiries.
  Reference: https://www.monocrawl.com/docs/endpoints/finance/options.md
  - symbol (required): Ticker symbol Example: "AAPL"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/finance/statements (3cr) — params: symbol*, statement, period, dry_run — Income statement, balance sheet or cash-flow statement of a listed company, one row per fiscal period: annual rows for each fiscal year, quarter-end rows with trailing-twelve-month figures, plus the latest trailing twelve months.
  Reference: https://www.monocrawl.com/docs/endpoints/finance/statements.md
  - symbol (required): Ticker symbol Example: "AAPL"
  - statement (optional): income, balance or cash Example: "income"
  - period (optional): all, annual or quarterly Example: "all"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## g2
- GET /v1/g2/category (2cr) — params: category*, page, sort, dry_run — The products in a G2 software category, with their typical user roles, industries and market segments. Re-wired 6 Sep 2026 on the platform's own page reader (migration 195) after the listing failed.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/category.md
  - category (required): Category slug or the full G2 category URL Example: "marketing-automation"
  - page (optional): Page of 15 products Example: "1"
  - sort (optional): g2-score, popularity or satisfaction Example: "g2-score"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/category-links (1cr) — params: page, dry_run — The directory of every software category on G2, 500 links per page.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/category-links.md
  - page (optional): Page of 500 category links Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/product (8cr) — params: product*, dry_run — A software product's G2 profile: rating, review count, pricing plans, feature scores, alternatives, comparisons, company details and public social profiles. Contact details are never included.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/product.md
  - product (required): Product slug or the full G2 product URL Example: "postman"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/product-links (2cr) — params: page, dry_run — The directory of every product profile on G2, 500 links per page, for crawling the catalogue end to end.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/product-links.md
  - page (optional): Page of 500 product links Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/reviews (8cr) — params: product*, page, stars, segment, industry, role, region, sort, keywords, dry_run — Reviews of a software product, ten per page, with rating, text, date and the reviewer's role, company size and industry; filterable by stars, segment, industry, role, region and keywords.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/reviews.md
  - product (required): Product slug or the full G2 product URL Example: "postman"
  - page (optional): Page of 10 reviews; the response carries last_page and a cursor Example: "1"
  - stars (optional): Star ratings to include, comma-separated Example: "4,5"
  - segment (optional): small-business, mid-market or enterprise Example: "mid-market"
  - industry (optional): Industry ids from available_filters, comma-separated Example: "274"
  - role (optional): Reviewer role names or ids, comma-separated Example: "user"
  - region (optional): Reviewer region, comma-separated Example: "Europe"
  - sort (optional): default, most-recent, most-helpful, highest-rated or lowest-rated Example: "most-recent"
  - keywords (optional): Only reviews mentioning this text Example: "api testing"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/seller (1cr) — params: seller*, products_page, reviews_page, dry_run — A software vendor's G2 seller profile with its product portfolio and cross-product review teasers. Re-wired 6 Sep 2026 on the platform's own page reader (migration 195) after the listing failed.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/seller.md
  - seller (required): Seller slug or the full G2 seller URL Example: "hubspot"
  - products_page (optional): Page of the seller's products (9 per page) Example: "1"
  - reviews_page (optional): Page of cross-product review teasers (3 per page, up to 10 pages) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/g2/seller-products (2cr) — params: seller*, page, dry_run — The products a software vendor lists on G2, nine per page, with ratings and review counts. Re-wired 6 Sep 2026 on the platform's own page reader (migration 195) after the listing failed.
  Reference: https://www.monocrawl.com/docs/endpoints/g2/seller-products.md
  - seller (required): Seller slug or the full G2 seller URL Example: "google"
  - page (optional): Page of 9 products Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## github
- GET /v1/github/issue (1cr) — params: url*, dry_run — One issue or pull request: title, state, labels, reactions and full body.
  Reference: https://www.monocrawl.com/docs/endpoints/github/issue.md
  - url (required): Issue or pull request URL Example: "https://github.com/vercel/next.js/issues/1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/issue/comments (1cr) — params: url*, since, limit, cursor, dry_run — Comments on an issue or pull request, oldest first.
  Reference: https://www.monocrawl.com/docs/endpoints/github/issue/comments.md
  - url (required): Issue or pull request URL Example: "https://github.com/vercel/next.js/issues/1"
  - since (optional): Only comments updated at or after this ISO-8601 timestamp Example: "2026-01-01T00:00:00Z"
  - limit (optional): Items per page, max 100 Example: "25"
  - cursor (optional): Opaque page cursor from a previous response Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/profile (1cr) — params: handle*, dry_run — Public profile, follower counts and repository totals for a GitHub user.
  Reference: https://www.monocrawl.com/docs/endpoints/github/profile.md
  - handle (required): GitHub username Example: "torvalds"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/profile/repos (1cr) — params: handle*, type, sort, direction, limit, cursor, dry_run — List a GitHub user's public repositories, most recently updated first.
  Reference: https://www.monocrawl.com/docs/endpoints/github/profile/repos.md
  - handle (required): GitHub username Example: "torvalds"
  - type (optional): Repository affiliation filter: all, owner or member Example: "owner"
  - sort (optional): Sort key: created, updated, pushed or full_name (default updated) Example: "updated"
  - direction (optional): Sort direction: asc or desc Example: "desc"
  - limit (optional): Items per page, max 100 Example: "25"
  - cursor (optional): Opaque page cursor from a previous response Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo (1cr) — params: url, owner, repo, dry_run — Stars, forks, issues and metadata for a public repository, addressed by URL or owner/repo.
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo.md
  - url (optional): Repository URL - or pass owner + repo instead Example: "https://github.com/vercel/next.js"
  - owner (optional): Repository owner (used with repo when url is not given) Example: "vercel"
  - repo (optional): Repository name (used with owner when url is not given) Example: "next.js"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo/dossier (5cr) — params: url*, dry_run — One-call project dossier: repo stats, README excerpt, latest releases, top issues and top contributors.
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo/dossier.md
  - url (required): Repository URL Example: "https://github.com/vercel/next.js"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo/issues (1cr) — params: url*, state, labels, type, sort, direction, since, limit, cursor, dry_run — List a repository's issues (pull requests included, flagged per item).
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo/issues.md
  - url (required): Repository URL Example: "https://github.com/vercel/next.js"
  - state (optional): Issue state: open, closed or all (default open) Example: "open"
  - labels (optional): Comma-separated label names to filter by Example: "bug"
  - type (optional): Client-side filter: issue or pr (GitHub's feed mixes both) Example: "issue"
  - sort (optional): Sort key: created, updated or comments Example: "created"
  - direction (optional): Sort direction: asc or desc Example: "desc"
  - since (optional): Only items updated at or after this ISO-8601 timestamp Example: "2026-01-01T00:00:00Z"
  - limit (optional): Items per page, max 100 Example: "25"
  - cursor (optional): Opaque page cursor from a previous response Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo/readme (1cr) — params: url*, dry_run — The repository's README decoded to markdown, with file metadata.
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo/readme.md
  - url (required): Repository URL Example: "https://github.com/vercel/next.js"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo/releases (1cr) — params: url*, limit, cursor, dry_run — Release history for a repository: tags, notes and downloadable assets.
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo/releases.md
  - url (required): Repository URL Example: "https://github.com/vercel/next.js"
  - limit (optional): Items per page, max 100 Example: "25"
  - cursor (optional): Opaque page cursor from a previous response Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/repo/top-issues (3cr) — params: url*, dry_run — The most-reacted open feature request and the most-reacted open complaint for a repository.
  Reference: https://www.monocrawl.com/docs/endpoints/github/repo/top-issues.md
  - url (required): Repository URL Example: "https://github.com/vercel/next.js"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/search (3cr) — params: query*, sort, order, limit, cursor, dry_run — Search GitHub issues and pull requests with full advanced-search query syntax.
  Reference: https://www.monocrawl.com/docs/endpoints/github/search.md
  - query (required): GitHub advanced search query, passed through verbatim Example: "repo:vercel/next.js is:issue is:open label:bug"
  - sort (optional): Sort key, e.g. comments, reactions, created, updated Example: "reactions"
  - order (optional): Sort direction: asc or desc Example: "desc"
  - limit (optional): Items per page, max 100 Example: "25"
  - cursor (optional): Opaque page cursor from a previous response Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/github/user/profile-velocity (5cr) — params: handle*, depth, dry_run — Weekly commit, PR, issue and review velocity for a user, computed from their recent public activity.
  Reference: https://www.monocrawl.com/docs/endpoints/github/user/profile-velocity.md
  - handle (required): GitHub username Example: "torvalds"
  - depth (optional): Event pages to analyze, 1-3 (100 events per page, default 3) Example: "3"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google
- GET /v1/google/search (4cr) — params: query*, page, region, date_posted, dry_run — Google organic results for a query: position, title, URL and description. Paged by page number.
  Reference: https://www.monocrawl.com/docs/endpoints/google/search.md
  - query (required): Search term. Example: "best espresso machine"
  - page (optional): Results page number, starting at 1.
  - region (optional): Two-letter region code to search from. Example: "US"
  - date_posted (optional): Restrict by recency, e.g. past-week.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_ads
- GET /v1/google_ads/ad (4cr) — params: url*, dry_run — One Google ad creative: impression band, regions shown, and the creative variations (headline, description, destination).
  Reference: https://www.monocrawl.com/docs/endpoints/google_ads/ad.md
  - url (required): adstransparency.google.com creative URL from google_ads/company-ads. Example: "https://adstransparency.google.com/advertiser/AR02903092099014459393/creative/CR09470540953698697217"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_ads/company-ads (4cr) — params: advertiser_id*, domain, region, platform, format, topic, start_date, end_date, cursor, dry_run — Ads a company runs across Google surfaces: creative ids, formats and transparency-page links. Listing mode by design — drill into one ad with google_ads/ad. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/google_ads/company-ads.md
  - advertiser_id (required): Advertiser id from google_ads/search-advertisers (or pass domain instead). Example: "AR02903092099014459393"
  - domain (optional): Company domain — alternative to advertiser_id. Example: "lululemon.com"
  - region (optional): Two-letter region code.
  - platform (optional): youtube, search, shopping, maps or play.
  - format (optional): text, image or video.
  - topic (optional): Topic filter.
  - start_date (optional): YYYY-MM-DD.
  - end_date (optional): YYYY-MM-DD.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_ads/search-advertisers (4cr) — params: query*, region, dry_run — Search Google Ads Transparency advertisers: verified advertiser ids, names and regions. The advertiser id feeds google_ads/company-ads.
  Reference: https://www.monocrawl.com/docs/endpoints/google_ads/search-advertisers.md
  - query (required): Advertiser or brand name. Example: "lululemon"
  - region (optional): Two-letter region code. Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_finance
- GET /v1/google_finance/explore (4cr) — params: query, location, language, dry_run — The Google Finance explore board of notable movers.
  Reference: https://www.monocrawl.com/docs/endpoints/google_finance/explore.md
  - query (optional): Optional theme Example: "tech"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_finance/markets (4cr) — params: market, location, language, dry_run — A Google Finance market board: indexes, most active, gainers, losers, cryptocurrencies or currencies.
  Reference: https://www.monocrawl.com/docs/endpoints/google_finance/markets.md
  - market (optional): indexes, most_active, gainers, losers, climate_leaders, cryptocurrencies or currencies Example: "indexes"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_finance/quote (4cr) — params: ticker*, location, language, dry_run — A quote from Google Finance: price, change, ranges, market cap and ratios.
  Reference: https://www.monocrawl.com/docs/endpoints/google_finance/quote.md
  - ticker (required): Ticker with exchange Example: "AAPL:NASDAQ"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_finance/ticker-search (4cr) — params: query*, location, language, dry_run — Tickers matching a query on Google Finance.
  Reference: https://www.monocrawl.com/docs/endpoints/google_finance/ticker-search.md
  - query (required): Company or ticker text Example: "nvidia"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_news
- GET /v1/google_news/search (3cr) — params: keyword*, depth, language_code, location_code, publisher, time_range, from, to, dry_run, group — Worldwide news search with publisher, language, country and date filters.
  Reference: https://www.monocrawl.com/docs/endpoints/google_news/search.md
  - keyword (required): Search phrase Example: "artificial intelligence"
  - depth (optional): Number of articles to return (1-250) Example: "25"
  - language_code (optional): ISO-639-1 language of the publisher Example: "en"
  - location_code (optional): ISO-3166 country of the publisher Example: "us"
  - publisher (optional): Restrict to one publisher domain Example: "bbc.co.uk"
  - time_range (optional): hour, day, week or month Example: "week"
  - from (optional): ISO-8601 start of an explicit window Example: "2026-08-01"
  - to (optional): ISO-8601 end of an explicit window Example: "2026-08-31"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - group (optional): Optional stories groups related returned news headlines with links back to every original row. Default none. A conservative local comparison, not AI, deduplication, corroboration, a count of distinct events or a claim of article equivalence. Original results and order remain available; at most 100 returned rows are compared. No extra source or model calls or credit surcharge. Example: "stories"
## google_places
- GET /v1/google_places/hotel (4cr) — params: hotel_id*, check_in, check_out, location, language, dry_run — One hotel on Google Hotels with prices by seller, amenities, rating and contact details.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/hotel.md
  - hotel_id (required): Hotel identifier from a hotels search Example: "ChkIoYjXwK-S_okHGg0vZy8xMW1fd3MzY243EAE"
  - check_in (optional): Check-in date Example: "2026-10-10"
  - check_out (optional): Check-out date Example: "2026-10-12"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/hotels-search (4cr) — params: query*, check_in, check_out, location, language, limit, dry_run — Hotels for a query on Google Hotels with price, stars, rating and amenities.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/hotels-search.md
  - query (required): Search terms Example: "hotels in Bath"
  - check_in (optional): Check-in date Example: "2026-10-10"
  - check_out (optional): Check-out date Example: "2026-10-12"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/listing (4cr) — params: query*, location, language, dry_run — A business's Google listing: categories, description, hours, attributes, rating, contact details and images.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/listing.md
  - query (required): Business name, optionally with a place Example: "Dishoom Shoreditch"
  - location (optional): Location name Example: "London,England,United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/place (6cr) — params: id*, dry_run — Full place record: contact details, opening hours, price level, rating and business status.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/place.md
  - id (required): Google place id from a search result. Example: "ChIJl1wfOSCjdUgRhrFnqMsMhQM"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/questions (4cr) — params: query*, location, language, limit, dry_run — Questions asked on a business's Google listing with their answers.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/questions.md
  - query (required): Business name, optionally with a place Example: "Dishoom Shoreditch"
  - location (optional): Location name Example: "London,England,United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Questions, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/reviews (2cr) — params: id*, dry_run — The most relevant reviews for a place (Google returns at most five; no pagination), with the place's overall rating.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/reviews.md
  - id (required): Google place id from a search result. Example: "ChIJl1wfOSCjdUgRhrFnqMsMhQM"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/search (2cr) — params: query*, limit, dry_run — Search places and businesses by free text. Returns identity, address, coordinates, rating and links.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/search.md
  - query (required): Free-text search: what and where. Example: "coffee in Worthing"
  - limit (optional): Requested results, 1–20 (default 20); the source may return fewer. No per-item detail enrichment. Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_places/updates (5cr) — params: query*, location, language, dry_run — Posts a business has published on its Google listing. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/google_places/updates.md
  - query (required): Business name, optionally with a place Example: "Dishoom Shoreditch"
  - location (optional): Location name Example: "London,England,United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_play
- GET /v1/google_play/app-info (1cr) — params: package*, country, language, dry_run — One Google Play app by package name: title, developer, score, ratings and review counts, installs, price, version, release and update dates, rating histogram.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/app-info.md
  - package (required): Play package name (or a Play Store URL) Example: "co.uk.getmondo"
  - country (optional): 2-letter storefront country (default us) Example: "gb"
  - language (optional): Language code (default en) Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/app-list (2cr) — params: collection, category, country, language, limit, dry_run — A Google Play chart, ranked: top free, top paid or top grossing for a storefront, optionally within one category — rank, package name, title, developer, summary, score, price and icon for each entry.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/app-list.md
  - collection (optional): top_free (default), top_paid or top_grossing Example: "top_free"
  - category (optional): Play category id such as FINANCE, PRODUCTIVITY or GAME_PUZZLE (default: all apps) Example: "FINANCE"
  - country (optional): 2-letter storefront country (default us) Example: "gb"
  - language (optional): Language code (default en) Example: "en"
  - limit (optional): Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. Example: "100"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/app-reviews (2cr) — params: package*, country, language, sort_by, limit, rating, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a Google Play app, newest first by default: id, title, text, rating, author, date, version, helpful votes and the developer reply when there is one. Page with the returned cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/app-reviews.md
  - package (required): Play package name (or a Play Store URL) Example: "co.uk.getmondo"
  - country (optional): 2-letter storefront country (default us) Example: "gb"
  - language (optional): Language code (default en) Example: "en"
  - sort_by (optional): newest (default), helpful or rating Example: "newest"
  - limit (optional): Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. Example: "100"
  - rating (optional): Keep only reviews with this star rating (1-5), applied after the fetch Example: "1"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/google_play/app-search (2cr) — params: query*, country, language, limit, dry_run — Apps matching a term on Google Play: package name, title, developer, summary, score and price.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/app-search.md
  - query (required): Search term Example: "budgeting"
  - country (optional): 2-letter storefront country (default us) Example: "gb"
  - language (optional): Language code (default en) Example: "en"
  - limit (optional): Results, 1-50 (default 20) Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/categories (0cr) — params: dry_run — The list of Google Play app categories.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/languages (0cr) — params: dry_run — The list of Google Play store languages.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/languages.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/locations (0cr) — params: dry_run — The list of Google Play store locations.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/locations.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_play/search-suggestions (1cr) — params: query*, country, language, dry_run — The search terms Google Play suggests for a partial query, in the order the store ranks them.
  Reference: https://www.monocrawl.com/docs/endpoints/google_play/search-suggestions.md
  - query (required): Partial search term Example: "spotify"
  - country (optional): 2-letter storefront country code (default us) Example: "us"
  - language (optional): Language code (default en) Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_search
- GET /v1/google_search/images (4cr) — params: query*, location, language, limit, dry_run — Image results for a query with the image and the page it appears on.
  Reference: https://www.monocrawl.com/docs/endpoints/google_search/images.md
  - query (required): Search terms Example: "aurora borealis"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_search/maps (4cr) — params: query*, location, language, limit, dry_run — Places matching a query on Google Maps with rating, address, phone, website and coordinates.
  Reference: https://www.monocrawl.com/docs/endpoints/google_search/maps.md
  - query (required): Search terms Example: "coffee near Shoreditch"
  - location (optional): Location name Example: "London,England,United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_search/news (4cr) — params: query*, location, language, limit, dry_run — News results for a query with source, snippet and publication time.
  Reference: https://www.monocrawl.com/docs/endpoints/google_search/news.md
  - query (required): Search terms Example: "semiconductors"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_search/search (4cr) — params: query*, location, language, limit, device, dry_run — Organic web results for a query in a chosen location and language, with rank, domain, title and description.
  Reference: https://www.monocrawl.com/docs/endpoints/google_search/search.md
  - query (required): Search terms Example: "open source llm"
  - location (optional): Location name; defaults to the United Kingdom Example: "London,England,United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - device (optional): desktop or mobile Example: "desktop"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_shopping
- GET /v1/google_shopping/deals (2cr) — params: query*, location, language, min_price, max_price, stores, limit, page, dry_run — Discounted products for a query on Google Shopping with sale and original price, discount and store.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/deals.md
  - query (required): Search terms Example: "laptop"
  - location (optional): Country name (default United Kingdom) Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - min_price (optional): Lowest price Example: "100"
  - max_price (optional): Highest price Example: "900"
  - stores (optional): Store names, comma-separated Example: "argos,currys"
  - limit (optional): Results, up to 120 Example: "40"
  - page (optional): Page Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/price-history (2cr) — params: id*, location, language, page, dry_run — Each store's price history for a Google Shopping product alongside its current price.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/price-history.md
  - id (required): Product id from google_shopping/search Example: "catalogid:7310953537322941042,productid:2695666608789071335"
  - location (optional): Country name (default United Kingdom) Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - page (optional): Page of 10 stores Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/product (5cr) — params: id*, location, language, dry_run — One Google Shopping product with its description, images, specification and rating. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/product.md
  - id (required): Google Shopping product id from a search result Example: "1749519698216963169"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/reviews (5cr) — params: id*, docid, product_id, location, language, limit, dry_run — Reviews of a Google Shopping product (keyed by the gid on a search card) with rating, text, date and reviewer name. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/reviews.md
  - id (required): Google Shopping product gid (the gid on a google_shopping/search card) Example: "3896066944466806859"
  - docid (optional): The card's docid, sent alongside for a precise match Example: "11901315168138976013"
  - product_id (optional): The card's product id, sent alongside for a precise match Example: "4891805616949897996"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Reviews, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/search (5cr) — params: query*, location, language, limit, dry_run — Products for a query on Google Shopping with seller, price, currency and rating. Prepared as a queued task; a retry within fifteen minutes picks up the same result.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/search.md
  - query (required): Search terms Example: "noise cancelling headphones"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/sellers (5cr) — params: id*, location, language, dry_run — Every seller offering a Google Shopping product with price, shipping and total. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/sellers.md
  - id (required): Google Shopping product id Example: "1234567890123456789"
  - location (optional): Location name Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_shopping/store-reviews (2cr) — params: domain*, location, language, limit, cursor, dry_run — Shopper reviews of an online store as shown on Google Shopping, with rating, text, author and date.
  Reference: https://www.monocrawl.com/docs/endpoints/google_shopping/store-reviews.md
  - domain (required): Store domain Example: "amazon.co.uk"
  - location (optional): Country name (default United Kingdom) Example: "United Kingdom"
  - language (optional): Language code Example: "en"
  - limit (optional): Reviews, up to 100 Example: "20"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## google_trends
- GET /v1/google_trends/interest (4cr) — params: query*, location, time_range, type, dry_run — Interest over time for up to five terms on Google Trends.
  Reference: https://www.monocrawl.com/docs/endpoints/google_trends/interest.md
  - query (required): Up to five terms, comma-separated Example: "electric bikes"
  - location (optional): Location name; worldwide when empty Example: "United Kingdom"
  - time_range (optional): past_hour … past_5_years Example: "past_12_months"
  - type (optional): web, news, youtube, images or froogle Example: "web"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_trends/related (4cr) — params: query*, location, time_range, type, dry_run — Related queries and topics, top and rising, for a term on Google Trends.
  Reference: https://www.monocrawl.com/docs/endpoints/google_trends/related.md
  - query (required): One term Example: "electric bikes"
  - location (optional): Location name; worldwide when empty Example: "United Kingdom"
  - time_range (optional): past_hour … past_5_years Example: "past_12_months"
  - type (optional): web, news, youtube, images or froogle Example: "web"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/google_trends/trending (2cr) — params: location*, hours, category, status, sort, limit, dry_run — Trending searches, approximate volumes, timing, categories, breakdowns and up to three related articles, read from the public Trending Now page.
  Reference: https://www.monocrawl.com/docs/endpoints/google_trends/trending.md
  - location (required): Country or region code Example: "DE"
  - hours (optional): 4, 24, 48 or 168 Example: "24"
  - category (optional): Category ID or page category name Example: "all"
  - status (optional): all, active or ended Example: "all"
  - sort (optional): relevance, volume, recency or title Example: "relevance"
  - limit (optional): Whole number from 1 to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## gumtree
- GET /v1/gumtree/categories (2cr) — params: id, dry_run — The category tree, or one category's subtree.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/categories.md
  - id (optional): Category id to return a subtree; omit for the whole tree Example: "9311"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/filters (2cr) — params: category*, dry_run — The filters a category offers, with their kinds, parameters and options.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/filters.md
  - category (required): Category id Example: "9311"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/locations (2cr) — params: query*, type, dry_run — Location ids for a place name, with coordinates, for use in searches.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/locations.md
  - query (required): Place name, outcode or postcode Example: "london"
  - type (optional): location, outcode or postcode Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/locations-nearest (2cr) — params: latitude*, longitude*, dry_run — The site's location record nearest to a coordinate.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/locations-nearest.md
  - latitude (required): Latitude Example: "51.5074"
  - longitude (required): Longitude Example: "-0.1278"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/product (2cr) — params: id*, url, dry_run — One listing's page: description, price, category path, location, attributes, images, the seller's profile and the seller ids the seller routes take.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/product.md
  - id (required): Ad id (or pass url, the listing's page) Example: "1513645531"
  - url (optional): The listing's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/product-similar (2cr) — params: id*, dry_run — Listings similar to one listing.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/product-similar.md
  - id (required): Ad id Example: "1513645531"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/search (5cr) — params: query*, category, location, page, dry_run — One page of Gumtree UK listings for a keyword: title, price, location, age, seller flags and URL.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/search.md
  - query (required): Search keyword Example: "laptop"
  - category (optional): Category slug Example: "laptops"
  - location (optional): Location slug Example: "london"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/search-suggestions (2cr) — params: query*, category, dry_run — Keyword suggestions for a partial search, each with the category it belongs to.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/search-suggestions.md
  - query (required): Partial keyword Example: "iph"
  - category (optional): Category id to scope the suggestions Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/gumtree/trending (2cr) — params: dry_run — The search terms trending on the site right now.
  Reference: https://www.monocrawl.com/docs/endpoints/gumtree/trending.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## hackernews
- GET /v1/hackernews/profile (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Karma, join date, about text and submission count for a Hacker News account, merged from the official Firebase API and the Algolia index.
  Reference: https://www.monocrawl.com/docs/endpoints/hackernews/profile.md
  - handle (required): Hacker News username Example: "pg"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/hackernews/search (1cr) — params: query*, tags, numericFilters, hitsPerPage, page, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Full-text search over Hacker News stories and comments with tag and numeric filters, via the Algolia HN index.
  Reference: https://www.monocrawl.com/docs/endpoints/hackernews/search.md
  - query (required): Full-text search query Example: "dropbox"
  - tags (optional): Algolia tag filter: story, comment, poll, show_hn, ask_hn, front_page, author_USERNAME, story_ID. Comma-separated tags AND together; parentheses OR. Example: "story"
  - numericFilters (optional): Comma-separated numeric conditions on points, num_comments or created_at_i Example: "points>100"
  - hitsPerPage (optional): Results per page, 1-100 (default 25) Example: "25"
  - page (optional): Zero-based page number Example: "0"
  - cursor (optional): Pagination cursor from a previous response; equivalent to page Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/hackernews/story (1cr) — params: id*, dry_run — A Hacker News story with score, author, text and an exact comment count in one call.
  Reference: https://www.monocrawl.com/docs/endpoints/hackernews/story.md
  - id (required): Numeric Hacker News item id Example: "8863"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hackernews/story/comments (1cr) — params: id*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The full comment tree of a Hacker News story in one call, flattened with depth and parent ids (up to 500 comments).
  Reference: https://www.monocrawl.com/docs/endpoints/hackernews/story/comments.md
  - id (required): Numeric Hacker News story id Example: "8863"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## hm
- GET /v1/hm/categories (5cr) — params: country, dry_run — The category tree of an H&M storefront.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/categories.md
  - country (optional): Storefront code Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/countries (1cr) — params: dry_run — The retailer's country and language list, by region, with each country's storefront language links.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/countries.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/new-arrivals (5cr) — params: country, page, limit, dry_run — The newest products on an H&M storefront.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/new-arrivals.md
  - country (optional): Storefront code Example: "en_us"
  - page (optional): Page number Example: "1"
  - limit (optional): Per page Example: "22"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/product (5cr) — params: id*, country, dry_run — One H&M product: title, price, description, composition, care, colours and variants.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/product.md
  - id (required): Article code (the number in the product URL) Example: "1258254001"
  - country (optional): Storefront code Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/product-suppliers (2cr) — params: id*, language, dry_run — The supplier and factory record the retailer publishes for a product: country, supplier and each factory's name, address and workforce band.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/product-suppliers.md
  - id (required): Product id, the digits in the product page URL Example: "1303341009"
  - language (optional): Language code such as en_us Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/search (5cr) — params: query*, country, page, limit, dry_run — Products matching a keyword on an H&M storefront, with price, colours and images.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/search.md
  - query (required): Search keyword Example: "jacket"
  - country (optional): Storefront code from hm/countries Example: "en_us"
  - page (optional): Page number Example: "1"
  - limit (optional): Per page, up to 60 Example: "36"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/similar (5cr) — params: id*, country, dry_run — Products similar to one product.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/similar.md
  - id (required): Article code Example: "1258254001"
  - country (optional): Storefront code Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/stores (1cr) — params: country*, language, dry_run — Every store in a country: address, coordinates, opening hours, departments and status.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/stores.md
  - country (required): Two-letter country code Example: "us"
  - language (optional): Language code such as en_us Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/hm/suggestions (5cr) — params: query*, country, dry_run — Search suggestions for a partial query.
  Reference: https://www.monocrawl.com/docs/endpoints/hm/suggestions.md
  - query (required): Partial search text Example: "jack"
  - country (optional): Storefront code Example: "en_us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## home_depot
- GET /v1/home_depot/product (1cr) — params: item_id, url, store_id, dry_run — One Home Depot product: title, brand, model and UPC, price and any promotion, rating and review count, availability, description, highlights, specifications by group, images and videos, category path.
  Reference: https://www.monocrawl.com/docs/endpoints/home_depot/product.md
  - item_id (optional): The item id, the number at the end of a homedepot.com product URL. Send this or url. Example: "203203319"
  - url (optional): Product page URL Example: "https://www.homedepot.com/p/Krud-Kutter-32-oz-Brush-Wash-and-Renewer-BW326/203203319"
  - store_id (optional): Store number to localise price and availability; store 1087 stands in when omitted (store_defaulted says so) Example: "1087"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/home_depot/reviews (3cr) — params: id*, page, sort, rating, verified, keywords, dry_run — Reviews of a Home Depot product with rating, author, photos and store responses.
  Reference: https://www.monocrawl.com/docs/endpoints/home_depot/reviews.md
  - id (required): Home Depot item id (the number at the end of its product URL), or the URL Example: "204279858"
  - page (optional): Page number Example: "1"
  - sort (optional): newest, oldest, helpful, highest, lowest or photos Example: "newest"
  - rating (optional): Only this star rating Example: ""
  - verified (optional): 1 for verified purchases only Example: ""
  - keywords (optional): Only reviews mentioning this text Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/home_depot/search (2cr) — params: query*, page, sort_by, min_price, max_price, store_id, delivery_zip, free_ship_to_store, dry_run — Search the Home Depot catalogue: product cards with id, title, brand, model number, price (current, was, saving), rating and review count, badges, thumbnails, delivery and pickup, with the page's filters, total and a cursor to the next page (up to 30 pages). Reactivated 6 Sep 2026 on a search-results supplier after the marketplace listing failed (188).
  Reference: https://www.monocrawl.com/docs/endpoints/home_depot/search.md
  - query (required): Search words Example: "cordless drill"
  - page (optional): Page number, 1 to 30 (24 products per page) Example: "1"
  - sort_by (optional): best_match (default), top_sellers, top_rated, price_low_to_high or price_high_to_low Example: "top_sellers"
  - min_price (optional): Lowest price to include, in dollars Example: "20"
  - max_price (optional): Highest price to include, in dollars Example: "150"
  - store_id (optional): Store number to localise price and availability Example: "1087"
  - delivery_zip (optional): ZIP code for delivery availability Example: "10001"
  - free_ship_to_store (optional): Only products with free ship-to-store Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## instagram
- GET /v1/instagram/about (10cr) — params: handle*, user_id, dry_run — Public account transparency: country, month joined and verification status when supplied. Unknown ads and former-name counts remain null. Handle lookup is included in the credit price.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/about.md
  - handle (required): Instagram username or profile URL Example: "nasa"
  - user_id (optional): The numeric account id, if already known: skips the lookup request Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/audio-reels (2cr) — params: audio_id*, cursor, dry_run — Reels that use a specific audio track — sound-trend intelligence for Instagram. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/audio-reels.md
  - audio_id (required): Instagram audio id. Example: "1392969992841787"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/basic-profile (1cr) — params: user_id*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A profile looked up by its numeric id — the id comments and tags carry — in the same shape as the profile route.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/basic-profile.md
  - user_id (required): Numeric Instagram user id Example: "528817151"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/comment (25cr) — params: url*, comment_id*, parent_id, cursor, max_pages, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Bounded comment lookup within a specified post or parent thread. Returns found, comment, comments_scanned, search_complete and next_params. A completed paid scan may return found=false; this does not establish deletion. Each successful fresh scanned page costs at least 5 credits (or the underlying price if higher); failed pages are free and cache hits use their normal lower charge.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/comment.md
  - url (required): Public post or video URL. Example: "https://www.instagram.com/reel/DdRyQxKteC1/"
  - comment_id (required): Exact target comment ID as a string.
  - parent_id (optional): For a reply lookup, the parent comment ID. Otherwise scans top-level comments.
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - max_pages (optional): Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/comment-replies (2cr) — params: url*, comment_id*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The reply thread under one Instagram comment. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/comment-replies.md
  - url (required): Full Instagram post/reel URL. Example: "https://www.instagram.com/reel/C8rKmYvsrck"
  - comment_id (required): Comment id from instagram/post-comments. Example: "18038110327814211"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/engagement (10cr) — params: handle*, dry_run — One profile plus one posts page. Computes mean likes plus comments divided by current followers, with paired sample size and formula. Missing metrics excluded. No account-wide or historical inference. Each fresh component call costs at least 5 credits; cache hits use their lower normal price.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/engagement.md
  - handle (required): Instagram username without @. Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/highlight (1cr) — params: id*, dry_run — Every item inside one story highlight, as normalized media.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/highlight.md
  - id (required): Highlight id from instagram/highlights. Example: "18195781759377100"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/highlights (1cr) — params: handle*, user_id, dry_run — An account's story highlights: id, title and cover. The id feeds instagram/highlight.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/highlights.md
  - handle (required): Instagram username (or pass user_id). Example: "nasa"
  - user_id (optional): Numeric user id — alternative to handle.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/location-posts (2cr) — params: id*, tab, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Posts tagged at a place, most recent or top-ranked, with captions, counts and authors; paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/location-posts.md
  - id (required): Numeric location id — the number in an Instagram place page URL (instagram.com/explore/locations/<id>/…) Example: "212988663"
  - tab (optional): recent (chronological, default) or top (ranked) Example: "recent"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/post (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One Instagram post or reel: caption, media URLs, author and current counts.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post.md
  - url (required): Instagram post or reel URL. Example: "https://www.instagram.com/p/B9KI0D2HHe7/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/post-comments (3cr) — params: url*, cursor, sort, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Comments on an Instagram post with like and reply counts. Paged by cursor. With sort=top or sort=recent the order is the platform's own, through the direct supplier.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post-comments.md
  - url (required): Instagram post or reel URL. Example: "https://www.instagram.com/p/B9KI0D2HHe7/"
  - cursor (optional): Opaque cursor from the previous page.
  - sort (optional): top (the platform's popular order) or recent (newest first); omitted = the answering source's own order. Send a cursor back with the sort it came with. Example: "recent"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/post-count (4cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — How many posts an Instagram profile has published.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post-count.md
  - handle (required): Instagram handle Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/post-likers (5cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A ranked sample of the accounts that liked a post or reel (handle, name, verification, privacy, avatar), with the post's like count as total. One sample per post; the platform exposes no further pages. Restored 6 September 2026 through the fourth Instagram listing.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post-likers.md
  - url (required): Post or reel URL, or its shortcode Example: "https://www.instagram.com/p/B9KI0D2HHe7/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/post-stats (5cr) — params: url*, dry_run — Public post statistics with a share-capable source preferred through the standard guarded chain. Shares mean public reshares; saves/reposts remain null when absent. Not private creator analytics. Fresh lookup costs at least 5 credits; the ordinary post route is unchanged.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post-stats.md
  - url (required): Public post/reel URL. Example: "https://www.instagram.com/reel/DdRyQxKteC1/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/post-transcript (5cr) — params: url*, dry_run — The spoken words of an Instagram reel as text. A photo post answers 404 — there is nothing to transcribe.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/post-transcript.md
  - url (required): Instagram reel URL (must be a video). Example: "https://www.instagram.com/reel/DcuQVFLvJMX/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/posts (1cr) — params: handle*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts for an Instagram account with engagement counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/posts.md
  - handle (required): Instagram username. Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/posts/full (25cr) — params: handle*, cursor, max_pages, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Bounded automatic pagination through registered sources. Retains entire pages, removes duplicate IDs, returns stop_reason, complete and next_params. Up to five pages per request; not guaranteed full account history. Charges successful fresh component calls at max(5, underlying price), with normal lower cache-hit pricing. Public share counts are included where available, with metrics_coverage; richer source preferred. Photos may have no share count. Saves and reposts are not guaranteed.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/posts/full.md
  - handle (required): Public profile identifier. Example: "nasa"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - max_pages (optional): Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/profile (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public Instagram profile: identity, bio, follower/following/post counts.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/profile.md
  - handle (required): Instagram username, with or without the leading @. Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/profile-embed (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public profile embed HTML. Treat returned HTML as third-party content and render in an isolated embed context.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/profile-embed.md
  - handle (required): Instagram username without @. Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/profile-followers (10cr) — params: handle*, limit, cursor, query, dry_run — Public follower accounts, subject to the source platform's available sample. Returns an opaque continuation when another page is available; this is not a guaranteed complete follower export.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/profile-followers.md
  - handle (required): Instagram username, with or without the leading @ Example: "nasa"
  - limit (optional): Accounts per page, at most 50 Example: "50"
  - cursor (optional): Opaque cursor from the previous response; keep the same handle and query Example: ""
  - query (optional): Filter names and handles within each fetched page; a matching page may be short Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/profile-following (10cr) — params: handle*, limit, cursor, query, dry_run — Accounts a public account follows, fifty per page with handle, name, verification and privacy flags; paged by offset.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/profile-following.md
  - handle (required): Instagram username, with or without the leading @ Example: "nasa"
  - limit (optional): Accounts per page, at most 50 Example: "50"
  - cursor (optional): Opaque cursor from the previous response; keep the same handle and query Example: ""
  - query (optional): Filter names and handles within each fetched page; a matching page may be short Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/profile/full (8cr) — params: handle*, posts, cursor, include, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields are transparent page arithmetic, not SocialCrawl metric-schema equivalence.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/profile/full.md
  - handle (required): Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. Example: "mrbeast"
  - posts (optional): Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. Example: "25"
  - cursor (optional): Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
  - include (optional): CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. Example: "posts,computed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/reels (1cr) — params: handle*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent reels for an Instagram account with play counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/reels.md
  - handle (required): Instagram username. Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/reels-trending (4cr) — params: dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A batch of currently-trending reels from Instagram's public reels surface. Small batches that can overlap — call repeatedly for more.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/reels-trending.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/reels/full (25cr) — params: handle*, cursor, max_pages, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Bounded automatic pagination through registered sources. Retains entire pages, removes duplicate IDs, returns stop_reason, complete and next_params. Up to five pages per request; not guaranteed full account history. Charges successful fresh component calls at max(5, underlying price), with normal lower cache-hit pricing. Public share counts are included where available, with metrics_coverage; richer source preferred. Photos may have no share count. Saves and reposts are not guaranteed.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/reels/full.md
  - handle (required): Public profile identifier. Example: "nasa"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - max_pages (optional): Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/reposts (3cr) — params: handle, user_id, cursor, dry_run — Posts an account has reposted to its own feed from other accounts, with captions, counts and original authors; paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/reposts.md
  - handle (optional): Instagram username (or pass user_id) Example: "nasa"
  - user_id (optional): Numeric account id — alternative to handle Example: "528817151"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/search (1cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Popular Instagram posts and reels for a search term, with captions, play counts and authors. Niche phrases with no curated page return NOT_FOUND unchanged — that response is free. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search.md
  - query (required): Search term. Works best for topics Instagram curates a popular page for (brands, subjects, places). Example: "nike"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/search-hashtag (3cr) — params: hashtag*, date_posted, media_type, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Posts under an Instagram hashtag with captions, URLs and authors. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-hashtag.md
  - hashtag (required): Hashtag without the #. Example: "makeup"
  - date_posted (optional): Restrict by post date, e.g. last-week.
  - media_type (optional): all, photo or video.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/search-locations (5cr) — params: query*, limit, dry_run — Instagram places matching a name: the location id, address, city and coordinates, as Instagram's own place search suggests them.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-locations.md
  - query (required): A place name Example: "Louvre"
  - limit (optional): Places to return, up to 50 Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/search-music (5cr) — params: query*, dry_run — Instagram audio tracks matching a keyword: title, artist, duration, the Reels count label, trending rank and the public 30-second preview link. Served from 6 September 2026 by the fourth Instagram listing (Ultra plan).
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-music.md
  - query (required): Keyword: a title, an artist or a lyric fragment Example: "espresso"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/search-profiles (1cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search Instagram accounts by keyword, with follower counts inline.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-profiles.md
  - query (required): Search term. Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/search-reels (1cr) — params: query*, date_posted, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search Instagram reels by keyword: caption, URL, author and engagement. Paged by page-number cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-reels.md
  - query (required): What to search for. Example: "dogs"
  - date_posted (optional): Restrict by post date, e.g. last-week.
  - cursor (optional): Page number, starting at 1.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/search-top (4cr) — params: query*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Instagram's own ranked search: accounts, hashtags, places and keyword suggestions in one response. Single page by design.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/search-top.md
  - query (required): What to search for. Example: "nike"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/similar-accounts (3cr) — params: handle, user_id, dry_run — Accounts the platform surfaces as similar to a given account (its suggested follows). Large verified accounts may surface none.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/similar-accounts.md
  - handle (optional): Instagram username (or pass user_id) Example: "nasa"
  - user_id (optional): Numeric account id — alternative to handle Example: "528817151"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/stories (5cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A public account's stories live right now: media URLs, posting and expiry times, mentions, hashtags, link and music stickers. Empty when nothing is live.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/stories.md
  - handle (required): Instagram username, with or without the leading @ Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/story (5cr) — params: story_id*, dry_run — One Instagram story by id while it is live: media links at every size, whether it is a video, when it was taken, the author and the caption. Stories expire after a day; an expired one is a 404.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/story.md
  - story_id (required): The story id from instagram/stories (with or without the _userid suffix) Example: "3979517011039436364"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/instagram/tagged-posts (2cr) — params: user_id*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Posts a user has been tagged in, one page at a time, with codes, captions, counts and the posting author.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/tagged-posts.md
  - user_id (required): Numeric Instagram user id Example: "528817151"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/instagram/username-suggestions (5cr) — params: query*, cursor, dry_run — Matching existing public accounts through profile search. Not username availability checks or generated handle suggestions. Fresh search costs at least 5 credits; cache hits use their lower normal price.
  Reference: https://www.monocrawl.com/docs/endpoints/instagram/username-suggestions.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## jobs
- GET /v1/jobs/bing/job (1cr) — params: id*, dry_run — One aggregated job posting from Bing with its description and apply link.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/bing/job.md
  - id (required): Job id from a search result Example: "MTE5OTc2NjYxOS5SZXRybw=="
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/bing/search (3cr) — params: location*, query, date_posted, employment_types, remote_only, cursor, dry_run — Search Bing's aggregated job postings by location and keywords.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/bing/search.md
  - location (required): Country or city Example: "Switzerland"
  - query (optional): Keywords, title, company or position Example: "java"
  - date_posted (optional): week or day Example: "week"
  - employment_types (optional): contractor, fulltime, parttime or temporary Example: "fulltime"
  - remote_only (optional): true to keep remote roles only Example: "true"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/indeed/job (1cr) — params: id*, dry_run — One Indeed job posting with its description, employer and apply link.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/indeed/job.md
  - id (required): Job id from a search result Example: "aWQ9NWExYzEwM2YzOTEzODljNDtjYz11cw=="
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/indeed/search (3cr) — params: country_code*, query, location, sort, radius, radius_unit, cursor, dry_run — Search Indeed job postings in a country by keywords, location and radius.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/indeed/search.md
  - country_code (required): Two-letter country code Example: "gb"
  - query (optional): Keywords, title, company or position Example: "nurse"
  - location (optional): City, town or province Example: "Manchester"
  - sort (optional): relevance or date Example: "date"
  - radius (optional): Search radius Example: "20"
  - radius_unit (optional): km or miles Example: "km"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/linkedin/job (1cr) — params: id*, dry_run — One LinkedIn job posting with its description, seniority, function, industries and applicant count.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/linkedin/job.md
  - id (required): Job id from a search result Example: "4344456572"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/linkedin/organizations (1cr) — params: query*, dry_run — Organisation ids for a name, to filter LinkedIn job searches by employer.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/linkedin/organizations.md
  - query (required): Organisation or school name Example: "google"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/linkedin/search (3cr) — params: query, location, organization_ids, date_posted, employment_types, experience_levels, workplace_types, cursor, dry_run — Search LinkedIn job postings by keywords, location, organisation, date, employment type, experience level and workplace type.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/linkedin/search.md
  - query (optional): Keywords, title, company or position Example: "data engineer"
  - location (optional): Country or city; worldwide when empty Example: "London"
  - organization_ids (optional): Organisation ids from jobs/linkedin/organizations, semicolon-separated Example: "1441"
  - date_posted (optional): month, week or day Example: "week"
  - employment_types (optional): contractor, fulltime, parttime, intern or temporary Example: "fulltime;parttime"
  - experience_levels (optional): intern, entry, associate, midSenior or director Example: "midSenior"
  - workplace_types (optional): remote, hybrid or onSite Example: "remote"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/salary/range (1cr) — params: query*, country_code, dry_run — Yearly, monthly, weekly, daily and hourly salary bands (min, max, mean, median) for a job title in a country.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/salary/range.md
  - query (required): A job title from jobs/salary/titles Example: "developer"
  - country_code (optional): Two-letter country code (default us) Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/salary/titles (1cr) — params: query*, country_code, dry_run — Canonical job titles matching a query, to feed the salary range route.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/salary/titles.md
  - query (required): Free text to match job titles Example: "programming"
  - country_code (optional): Two-letter country code (default us) Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/xing/job (1cr) — params: id*, dry_run — One Xing job posting with its salary band, benefits, skills and responsibilities.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/xing/job.md
  - id (required): Job id from a search result Example: "YmVybGluLXNlbmlvci1zb2x1dGlvbi1lbmdpbmVlci0xNTY3NTI5MTA="
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/jobs/xing/search (3cr) — params: query*, location, date_posted, employment_types, career_levels, remote_options, minimum_salary, cursor, dry_run — Search Xing job postings (the German-speaking market) by keywords, location, level, remote options and salary.
  Reference: https://www.monocrawl.com/docs/endpoints/jobs/xing/search.md
  - query (required): Keywords, title, company or position Example: "Java"
  - location (optional): Location, written in German Example: "Schweiz"
  - date_posted (optional): week, day or month Example: "week"
  - employment_types (optional): contractor, fulltime, intern, parttime, seasonal, temporary or voluntary Example: "fulltime"
  - career_levels (optional): student, entry, professional, manager, executive or seniorExecutive Example: "professional"
  - remote_options (optional): remote, hybrid or onSite Example: "remote"
  - minimum_salary (optional): Minimum annual salary Example: "60000"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## kick
- GET /v1/kick/clip (2cr) — params: url*, dry_run — One clip: title, video and thumbnail URLs, duration, views, likes, times, category, creator and channel.
  Reference: https://www.monocrawl.com/docs/endpoints/kick/clip.md
  - url (required): Clip URL Example: "https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## klarna
- GET /v1/klarna/categories (1cr) — params: region, dry_run — The top-level category tree with each department's children.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/categories.md
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/categories-children (1cr) — params: id*, region, dry_run — The children of one category, with their images and their own children.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/categories-children.md
  - id (required): Category id, e.g. t1 Example: "t1"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/category (3cr) — params: id*, sort, price_range, limit, cursor, region, dry_run — Products in a category, sorted and filtered, with the sub-categories and brands the page offers.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/category.md
  - id (required): Category id, e.g. cl94 Example: "cl94"
  - sort (optional): popularity, price_asc, price_desc, trend, name, rating or price_drop Example: "popularity"
  - price_range (optional): Price band such as 50-500 Example: ""
  - limit (optional): Products per page, at most 48 Example: "48"
  - cursor (optional): Offset from the previous page Example: ""
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/category-filters (1cr) — params: id*, region, dry_run — The filters a category page offers, grouped, with their types and units.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/category-filters.md
  - id (required): Category id Example: "cl94"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/category-guide (1cr) — params: id*, region, dry_run — The buying guide of a category: frequently asked questions and shopping tips.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/category-guide.md
  - id (required): Category id Example: "cl94"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/category-keywords (1cr) — params: id*, region, dry_run — The popular search keywords of a category.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/category-keywords.md
  - id (required): Category id Example: "t1"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/compare (3cr) — params: id*, id2*, region, dry_run — Two products side by side: prices, ratings and the category's attribute groups.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/compare.md
  - id (required): First product id Example: "3331931645"
  - id2 (required): Second product id Example: "3216399795"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/price-history (3cr) — params: id*, interval, region, dry_run — The price of a product over time, per retailer offer, with the lowest and highest seen.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/price-history.md
  - id (required): Product id Example: "3216399795"
  - interval (optional): one_month, three_months or all Example: "three_months"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/product (3cr) — params: id*, category*, region, dry_run — One product page: description and article, brand, category and breadcrumbs, rating, rank in its category, retailer count, cheapest instalment and the full specification table.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/product.md
  - id (required): Product id, as returned by search Example: "3216399795"
  - category (required): The product's category id, as returned by search Example: "cl94"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/product-offers (3cr) — params: id*, region, dry_run — Every retailer's offer for one product: price, stock, shipping, instalment terms and the retailer's outbound link, plus the product's images.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/product-offers.md
  - id (required): Product id Example: "3216399795"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/reviews (3cr) — params: id*, limit, cursor, region, dry_run — Shopper reviews of a product gathered from retailers' sites: rating, text, source, author, date, pros and cons.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/reviews.md
  - id (required): Product id Example: "3207919327"
  - limit (optional): Reviews per page, at most 50 Example: "10"
  - cursor (optional): Cursor from the previous page Example: ""
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/reviews-overview (2cr) — params: id*, limit, region, dry_run — The rating summary of a product: overall score, counts, score distributions for shoppers and experts, and the first reviews of each kind.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/reviews-overview.md
  - id (required): Product id Example: "3207919327"
  - limit (optional): Shopper reviews to include, at most 50 Example: "10"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/reviews-pro (3cr) — params: id*, limit, cursor, region, dry_run — Expert reviews of a product from the press: rating, verdict, source, date, pros and cons.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/reviews-pro.md
  - id (required): Product id Example: "3207919327"
  - limit (optional): Reviews per page, at most 50 Example: "10"
  - cursor (optional): Cursor from the previous page Example: ""
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/search (3cr) — params: query*, region, limit, cursor, dry_run — Products matching a keyword across every retailer in the catalogue: lowest price, rating, rank, category, cheapest offer and instalment terms.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/search.md
  - query (required): Search keyword Example: "headphone"
  - region (optional): Catalogue region: usa, uk, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium Example: "usa"
  - limit (optional): Products per page, at most 48 Example: "48"
  - cursor (optional): Offset from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/search-suggestions (1cr) — params: query*, region, dry_run — Suggested categories and brands for a partial keyword, with the first matching products.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/search-suggestions.md
  - query (required): Partial keyword Example: "headphone"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/store-filters (1cr) — params: id*, region, dry_run — The filters a store page offers: price range, categories, brands and retailers with counts.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/store-filters.md
  - id (required): Store id, from klarna/stores Example: "09f4d635-0452-4f63-9455-c45420d95669"
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/store-products (3cr) — params: id*, sort, limit, cursor, region, dry_run — Products sold by one partner store, sorted and paged.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/store-products.md
  - id (required): Store id, from klarna/stores Example: "09f4d635-0452-4f63-9455-c45420d95669"
  - sort (optional): popularity, price_asc, price_desc, trend, name, rating or price_drop Example: "popularity"
  - limit (optional): Products per page, at most 25 Example: "25"
  - cursor (optional): Offset from the previous page Example: ""
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/klarna/stores (1cr) — params: category, cashback, limit, cursor, region, dry_run — The partner-store directory: name, category, delivery time and cost, payment options and logos.
  Reference: https://www.monocrawl.com/docs/endpoints/klarna/stores.md
  - category (optional): Store category filter, e.g. travel Example: ""
  - cashback (optional): true to keep stores with cashback Example: ""
  - limit (optional): Stores per page, at most 24 Example: "24"
  - cursor (optional): Offset from the previous page Example: ""
  - region (optional): Catalogue region Example: "usa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## kohls
- GET /v1/kohls/categories (1cr) — params: dry_run — The category tree of the store.
  Reference: https://www.monocrawl.com/docs/endpoints/kohls/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kohls/questions (2cr) — params: id*, page, limit, dry_run — Customer questions on a product with their answer counts.
  Reference: https://www.monocrawl.com/docs/endpoints/kohls/questions.md
  - id (required): Product id Example: "3910467"
  - page (optional): Page number Example: "1"
  - limit (optional): Questions per page, at most 50 Example: "10"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kohls/reviews (3cr) — params: id*, page, limit, dry_run — Shopper reviews of a product: rating, title, text, author, location, verified purchase, recommendation and secondary ratings such as fit and comfort.
  Reference: https://www.monocrawl.com/docs/endpoints/kohls/reviews.md
  - id (required): Product id, the number after prd- in the product URL Example: "3910467"
  - page (optional): Page number Example: "1"
  - limit (optional): Reviews per page, at most 50 Example: "8"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kohls/search (3cr) — params: query*, page, limit, sort, dry_run — Products matching a keyword: price band, rating, colours, shipping and pickup availability.
  Reference: https://www.monocrawl.com/docs/endpoints/kohls/search.md
  - query (required): Search keyword Example: "tshirt"
  - page (optional): Page number Example: "1"
  - limit (optional): Requested results per page, 1–120 (default 120); the source may return fewer. Example: "120"
  - sort (optional): Sort id from a previous answer's sorts list Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kohls/stores (1cr) — params: latitude*, longitude*, radius, dry_run — Stores near a point: name, address, coordinates, page and specialties.
  Reference: https://www.monocrawl.com/docs/endpoints/kohls/stores.md
  - latitude (required): Latitude Example: "40.941111"
  - longitude (required): Longitude Example: "-73.982308"
  - radius (optional): Search radius in miles Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## komi
- GET /v1/komi/page (1cr) — params: url*, dry_run — Creator identity and every outbound link on a public Komi page.
  Reference: https://www.monocrawl.com/docs/endpoints/komi/page.md
  - url (required): Full Komi URL or the bare handle Example: "https://komi.io/example"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## kwai
- GET /v1/kwai/post (2cr) — params: url*, dry_run — One post with its counts, author and music.
  Reference: https://www.monocrawl.com/docs/endpoints/kwai/post.md
  - url (required): Post URL Example: "https://www.kwai.com/@KwaiBrasilOficial/photo/5222073878527655516"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kwai/posts (2cr) — params: handle*, url, cursor, dry_run — A user's posts, one page at a time: caption, time, video and cover URLs, and view, like, comment and share counts.
  Reference: https://www.monocrawl.com/docs/endpoints/kwai/posts.md
  - handle (required): Kwai handle (or pass url) Example: "KwaiBrasilOficial"
  - url (optional): Profile URL, instead of handle Example: "https://www.kwai.com/@KwaiBrasilOficial"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/kwai/profile (2cr) — params: handle*, url, dry_run — A public Kwai profile: handle, name, bio, verification, follower, following, like and post counts.
  Reference: https://www.monocrawl.com/docs/endpoints/kwai/profile.md
  - handle (required): Kwai handle (or pass url) Example: "KwaiBrasilOficial"
  - url (optional): Profile URL, instead of handle Example: "https://www.kwai.com/@KwaiBrasilOficial"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## linkbio
- GET /v1/linkbio/page (1cr) — params: url*, dry_run — Creator identity and every outbound link on a public Linkbio page.
  Reference: https://www.monocrawl.com/docs/endpoints/linkbio/page.md
  - url (required): Full Linkbio URL (linkbio.co) or the bare handle Example: "https://linkbio.co/linkbio"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## linkedin
- GET /v1/linkedin/comment-replies (31cr) — params: post_id*, comment_id*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The replies to a LinkedIn comment, with text, likes and author. Replies are found for comments among the first thirty the reply source lists for the post; a comment beyond them answers 404.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/comment-replies.md
  - post_id (required): The post's activity id or URL Example: "7356711184831574036"
  - comment_id (required): The comment id from linkedin/post-comments Example: "7356889832989626368"
  - cursor (optional): Page token from the previous answer Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/company (5cr) — params: url, dry_run, domain — A company's public LinkedIn page: industry, size, headquarters, follower and employee counts.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company.md
  - url (optional): Company LinkedIn URL. Supply either this or domain; do not combine them. Example: "https://www.linkedin.com/company/nasa/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - domain (optional): Alternative to a company URL: discover a bounded set of indexed LinkedIn company pages, then verify an exact returned website hostname. Existing price and limits apply. Ambiguous, missing or unverified matches abstain; this is not exhaustive company search or proof of domain ownership. Example: "microsoft.com"
- GET /v1/linkedin/company-affiliated-pages (3cr) — params: company_id*, dry_run — A company's affiliated and showcase pages: id, name, handle, URL, type, speciality, follower count and logo. Not paged upstream.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-affiliated-pages.md
  - company_id (required): The numeric LinkedIn company id (as linkedin/company answers it) or a company URL carrying it Example: "1441"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/company-job-count (3cr) — params: company_id*, dry_run — The number of open jobs a company lists.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-job-count.md
  - company_id (required): The numeric LinkedIn company id (as linkedin/company answers it) or a company URL carrying it Example: "783611"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/company-jobs (3cr) — params: organization_id*, query, location, cursor, dry_run — Open roles at a company, one page at a time: title, location, posting time, employment type, seniority, remote flag, salary where stated and applicant count.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-jobs.md
  - organization_id (required): LinkedIn organisation id (from jobs/linkedin/organizations) Example: "1441"
  - query (optional): Keywords to narrow the roles Example: "engineer"
  - location (optional): Country or city Example: "London"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/company-people (8cr) — params: handle, organization_id, cursor, dry_run — People who list the company as their employer, twelve a page with the total: name, headline and profile.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-people.md
  - handle (optional): The company's LinkedIn handle or page URL (or pass organization_id) Example: "microsoft"
  - organization_id (optional): Numeric LinkedIn company id — alternative to handle Example: "1035"
  - cursor (optional): Page number from the previous page Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/company-posts (4cr) — params: url*, page, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts from a company's LinkedIn page, one numbered page at a time.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-posts.md
  - url (required): LinkedIn company URL. Example: "https://www.linkedin.com/company/nasa/"
  - page (optional): Page number, 1 to 7 (the supplier documents up to seven pages); omitted = the first page Example: "1"
  - cursor (optional): Continuation: the cursor from the previous answer (the next page number). Use it instead of page. Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/company-profile (5cr) — params: handle, url, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The enriched record for one company: industry, description, type, size band, headcount and its change over a month, quarter and year, followers, founding year, headquarters, revenue and funding where known, and open-role count. Distinct from linkedin/company, which answers what the public page shows.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/company-profile.md
  - handle (optional): Company handle (the URL slug) Example: "google"
  - url (optional): Full company URL, instead of the handle Example: "https://www.linkedin.com/company/google"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/group (3cr) — params: group_id*, dry_run — A LinkedIn group: name, members, description, rules, owners, industries and images.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/group.md
  - group_id (required): A LinkedIn group id or URL Example: "62438"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/group-posts (3cr) — params: group_id*, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Posts in a LinkedIn group with text, media, engagement and author, paged.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/group-posts.md
  - group_id (required): A LinkedIn group id or URL Example: "62438"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/job (1cr) — params: id*, dry_run — One job posting in full: title, company, location, description, posting and last-seen times, employment type, seniority, remote flag, salary where stated, applicant count and the external apply link.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/job.md
  - id (required): Job id from a search result Example: "4344456572"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/person (5cr) — params: handle, url, dry_run — The enriched record for one person: headline, summary, location, connections and followers, current role, full work history, education, skills, languages and links. Distinct from linkedin/profile, which answers what the public page shows. Email addresses are never returned.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/person.md
  - handle (optional): Public profile handle (the URL slug) Example: "williamhgates"
  - url (optional): Full profile URL, instead of the handle Example: "https://www.linkedin.com/in/williamhgates"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/post (5cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One LinkedIn post: text, author, like and comment counts, with a short comment preview.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/post.md
  - url (required): Full LinkedIn post URL. Example: "https://www.linkedin.com/feed/update/urn:li:activity:7500971887234097153"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/post-comments (4cr) — params: url, comments_urn, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A post's comments, ten a page with the total: text, time, likes, reply count, pinned and edited flags, the commenter's name, headline and profile.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/post-comments.md
  - url (optional): Post URL (or pass comments_urn from a profile-posts card, which saves a request) Example: "https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672"
  - comments_urn (optional): urns.comments from a profile-posts card Example: ""
  - cursor (optional): Page number from the previous page Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/post-reactions (8cr) — params: url, reactions_urn, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Who reacted to a post and how, ten a page with the total: reaction type, name, headline and profile.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/post-reactions.md
  - url (optional): Post URL (or pass reactions_urn from a profile-posts card) Example: "https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672"
  - reactions_urn (optional): urns.reactions from a profile-posts card Example: ""
  - cursor (optional): Page number from the previous page Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/post-reposts (4cr) — params: url, reposts_urn, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Who reposted a post, ten a page with the total: the repost's own URL and commentary, the reposter's name and profile.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/post-reposts.md
  - url (optional): Post URL (or pass reposts_urn from a profile-posts card) Example: "https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672"
  - reposts_urn (optional): urns.reposts from a profile-posts card Example: ""
  - cursor (optional): Page number from the previous page Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/post-transcript (5cr) — params: url*, dry_run — The spoken words of a video in a LinkedIn post as text. transcript is null when the video has no speech or captions — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/post-transcript.md
  - url (required): LinkedIn post URL containing a video under ~2 minutes. Example: "https://www.linkedin.com/feed/update/urn:li:activity:7500971887234097153"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/profile (5cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A person's public LinkedIn profile: headline, member id, about, location, followers and connections, experience, education, skills, languages and certifications. Recent posts are listed by linkedin/profile-posts.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile.md
  - url (required): LinkedIn profile URL. Example: "https://www.linkedin.com/in/satyanadella/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-certifications (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's licences and certifications, one page at a time: title, issuing authority, issue date and credential link.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-certifications.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAARpiwIBp_SzoeHPlUfOvmtibe08Ea1iCh4"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-comments (4cr) — params: handle, url, cursor, pagination_token, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The posts a person recently commented on, twenty a page, each with the person's comment.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-comments.md
  - handle (optional): Public profile handle (the URL slug), or pass url Example: "satyanadella"
  - url (optional): Full profile URL Example: "https://www.linkedin.com/in/satyanadella"
  - cursor (optional): Page number from the previous page Example: ""
  - pagination_token (optional): pagination_token from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-contact (3cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's public contact card: websites and social handles. E-mail addresses, phone numbers and postal addresses are personal data and are withheld; the answer lists what was withheld.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-contact.md
  - url (required): Profile URL or handle Example: "https://www.linkedin.com/in/satyanadella/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-educations (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's education history, one page at a time: school, degree and dates.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-educations.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAARpiwIBp_SzoeHPlUfOvmtibe08Ea1iCh4"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-experiences (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's work experiences, one page at a time: title, employment type, location, dates, description, skills and the company (id, name, URL, logo).
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-experiences.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAAjpjWIBMh1iBR4OgSPK5GXetlQ6dYUT-qo"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-freshness (16cr) — params: urn, url, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The account-freshness panel of a member (not the About text): the month the account joined and how recently the contact details and profile photo changed.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-freshness.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-honors (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's honours and awards, one page at a time: title, issuer, date and the associated organisation.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-honors.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAC41xVEBx77koDz3k1eJ5E9t8UZ7g0IVGj4"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-images (16cr) — params: urn, url, page, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's posts that carry images, twenty per page with a continuation token: post id, URL, the images at every size and the relative posting time.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-images.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAABCtiL8B26nfi3Nbpo_AM8ngg4LeClT1Wh8"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - cursor (optional): The token from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-interests-companies (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The companies a member follows, one page at a time: id, name, URL, follower count and logo.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-interests-companies.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAEDH77YBEVIYXAaEwTicp5CcB_hR7DfFL9o"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-interests-groups (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The groups a member belongs to, one page at a time: id, name, URL, member count and logo.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-interests-groups.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAAjpjWIBMh1iBR4OgSPK5GXetlQ6dYUT-qo"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-posts (4cr) — params: handle, url, media, cursor, pagination_token, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A person's posts, newest first, twenty a page: text, media, links, like/comment/share counts with the reaction breakdown, and the engagement tokens the post-comments, post-reactions and post-reposts routes accept.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-posts.md
  - handle (optional): Public profile handle (the URL slug), or pass url Example: "satyanadella"
  - url (optional): Full profile URL Example: "https://www.linkedin.com/in/satyanadella"
  - media (optional): image or video: only posts carrying that media Example: ""
  - cursor (optional): Page number from the previous page Example: ""
  - pagination_token (optional): pagination_token from the previous page, passed alongside the cursor Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-publications (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's publications, one page at a time: title, publisher, description, date and link.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-publications.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAB8rG_UB7cstjC__gk5318uYsZOIVkyysi4"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-reactions (4cr) — params: handle, url, cursor, pagination_token, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The posts a person recently reacted to, twenty a page, in the profile-posts shape.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-reactions.md
  - handle (optional): Public profile handle (the URL slug), or pass url Example: "satyanadella"
  - url (optional): Full profile URL Example: "https://www.linkedin.com/in/satyanadella"
  - cursor (optional): Page number from the previous page Example: ""
  - pagination_token (optional): pagination_token from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-recommendations (16cr) — params: urn, url, type, page, pagination_token, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The recommendations a member received or gave, one page at a time: text, date, relationship and the recommender.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-recommendations.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAC3iNKcB3qbWJrP7K5Z3i89AF5c1snr8bhc"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - type (optional): received (default) or given Example: "received"
  - page (optional): Page number Example: "1"
  - pagination_token (optional): The supplier's pagination token, forwarded as given Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-skills (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's skills, twenty per page: name, endorsement count and whether the skill assessment was passed.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-skills.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAACkphDcBDruPBdXiAnqyc834jkTkd_4kRnU"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-stats (3cr) — params: url*, dry_run — A member's follower and connection counts.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-stats.md
  - url (required): Profile URL or handle Example: "https://www.linkedin.com/in/satyanadella/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/profile-videos (16cr) — params: urn, url, page, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's video posts, paged with a continuation token: post id, URL, duration, thumbnail, like and comment counts and the reaction breakdown.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-videos.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAABCtiL8B26nfi3Nbpo_AM8ngg4LeClT1Wh8"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - cursor (optional): The token from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile-volunteers (16cr) — params: urn, url, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A member's volunteer experiences, one page at a time: organisation, role, cause, duration, description and dates.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile-volunteers.md
  - urn (optional): The member URN (ACoAA…). Send this or url. Example: "ACoAAAWowRcBd8L3PJrg7-jrzLZGZeGBLz9kmSw"
  - url (optional): Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup) Example: "https://www.linkedin.com/in/satyanadella/"
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/profile/full (15cr) — params: url*, posts, cursor, include, pagination_token, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields are transparent page arithmetic, not SocialCrawl metric-schema equivalence.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/profile/full.md
  - url (required): Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. Example: "https://www.linkedin.com/company/microsoft"
  - posts (optional): Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. Example: "25"
  - cursor (optional): Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
  - include (optional): CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. Example: "posts,computed"
  - pagination_token (optional): Pass with the cursor when the personal-profile posts page supplied it. Company continuation is rejected until its registered component supports it.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/search-industries (4cr) — params: query*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — LinkedIn industries matching a typed name, each with the id the people-search industry filter takes.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-industries.md
  - query (required): The start of an industry name Example: "Software"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/search-jobs (3cr) — params: query, location, organization_ids, date_posted, employment_types, experience_levels, workplace_types, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search job postings by free text, location, country or company, one page at a time, in the same posting shape as a company's jobs.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-jobs.md
  - query (optional): Keywords, title, company or position (title accepted as an alias) Example: "data engineer"
  - location (optional): Country or city; worldwide when empty Example: "London"
  - organization_ids (optional): Organisation ids from jobs/linkedin/organizations Example: "1441"
  - date_posted (optional): month, week or day Example: "week"
  - employment_types (optional): contractor, fulltime, parttime, intern or temporary Example: "fulltime"
  - experience_levels (optional): intern, entry, associate, midSenior or director Example: "midSenior"
  - workplace_types (optional): remote, hybrid or onSite Example: "remote"
  - cursor (optional): Cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/search-locations (4cr) — params: query*, dry_run — LinkedIn locations matching a typed name, each with the id the people-search location filter takes.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-locations.md
  - query (required): The start of a place name Example: "London"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin/search-people (8cr) — params: query*, title, location, current_company, past_company, school, industry, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens, geocode_location — People matching a name with optional title, location, company, school and industry filters: handle, headline, location, followers and badges.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-people.md
  - query (required): A person's name Example: "Bill Gates"
  - title (optional): Job title filter Example: ""
  - location (optional): A location id from linkedin/search-locations Example: ""
  - current_company (optional): Current company filter Example: ""
  - past_company (optional): Past company filter Example: ""
  - school (optional): A school id from linkedin/search-schools Example: ""
  - industry (optional): An industry id from linkedin/search-industries Example: ""
  - page (optional): Page number Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
  - geocode_location (optional): Compatibility alias for location. The canonical parameter takes precedence if both are supplied. Example: ""
- GET /v1/linkedin/search-posts (4cr) — params: query*, cursor, date_posted, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search public LinkedIn posts by keyword: post text, author and URL. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-posts.md
  - query (required): Search term. Example: "artificial intelligence"
  - cursor (optional): Page number cursor from the previous page.
  - date_posted (optional): Restrict by post date, e.g. past-week.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/linkedin/search-schools (4cr) — params: query*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — LinkedIn schools matching a typed name, each with the id the people-search school filter takes.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin/search-schools.md
  - query (required): The start of a school name Example: "Stanford"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## linkedin_ads
- GET /v1/linkedin_ads/ad (4cr) — params: url*, dry_run — One LinkedIn ad by its ad-library URL: creative, advertiser, targeting disclosures and impression data.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin_ads/ad.md
  - url (required): LinkedIn ad-library detail URL from a search result. Example: "https://www.linkedin.com/ad-library/detail/1507751473"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/linkedin_ads/search (4cr) — params: query*, company, companyId, countries, start_date, end_date, cursor, dry_run — Search the LinkedIn Ad Library: headline, body, ad type, advertiser, impression bands and per-country impressions. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/linkedin_ads/search.md
  - query (required): Keyword (or pass company / companyId for advertiser-specific results). Example: "cloud"
  - company (optional): Company name. Example: "microsoft"
  - companyId (optional): LinkedIn company id.
  - countries (optional): Comma list of two-letter codes. Example: "US,CA"
  - start_date (optional): YYYY-MM-DD.
  - end_date (optional): YYYY-MM-DD.
  - cursor (optional): paginationToken from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## linkme
- GET /v1/linkme/page (1cr) — params: url*, dry_run — Creator identity and every outbound link on a public Linkme profile.
  Reference: https://www.monocrawl.com/docs/endpoints/linkme/page.md
  - url (required): Full Linkme URL or the bare handle Example: "https://linkme.bio/example"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## linktree
- GET /v1/linktree/page (1cr) — params: url*, dry_run — Creator identity and every outbound link on a public Linktree page.
  Reference: https://www.monocrawl.com/docs/endpoints/linktree/page.md
  - url (required): Full Linktree URL or the bare handle Example: "https://linktr.ee/linktree"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## meta_ads
- GET /v1/meta_ads/ad (4cr) — params: id*, dry_run — One Meta ad by archive id: full creative snapshot, platforms, run dates, and spend/reach where the Ad Library discloses them.
  Reference: https://www.monocrawl.com/docs/endpoints/meta_ads/ad.md
  - id (required): Ad archive id from a search or company-ads result. Example: "1702938977100376"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/meta_ads/ad-transcript (5cr) — params: id*, dry_run — The spoken words of a Meta video ad as text. transcript is null when the video has no speech — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/meta_ads/ad-transcript.md
  - id (required): Ad archive id of a VIDEO ad. Example: "4439810673014351"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/meta_ads/company-ads (4cr) — params: pageId*, companyName, country, status, media_type, sort_by, start_date, end_date, cursor, dry_run — Ads currently or previously running for one advertiser: creative body, title, CTA, link, images/videos, platforms and active state. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/meta_ads/company-ads.md
  - pageId (required): Facebook page id from meta_ads/search-companies (or pass companyName instead). Example: "15087023444"
  - companyName (optional): Company name — alternative to pageId.
  - country (optional): Two-letter country code or ALL. Example: "ALL"
  - status (optional): ACTIVE, INACTIVE or ALL.
  - media_type (optional): ALL, IMAGE or VIDEO.
  - sort_by (optional): e.g. total_impressions.
  - start_date (optional): YYYY-MM-DD.
  - end_date (optional): YYYY-MM-DD.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/meta_ads/search (4cr) — params: query*, country, status, media_type, ad_type, language, sort_by, start_date, end_date, cursor, dry_run — Keyword search across the Meta Ad Library: matching ads with advertiser page, creative snapshot and platforms. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/meta_ads/search.md
  - query (required): Keyword to search ad creatives for. Example: "running shoes"
  - country (optional): Two-letter country code or ALL.
  - status (optional): ACTIVE, INACTIVE or ALL.
  - media_type (optional): ALL, IMAGE or VIDEO.
  - ad_type (optional): e.g. all.
  - language (optional): Two-letter language code. Example: "EN"
  - sort_by (optional): e.g. total_impressions.
  - start_date (optional): YYYY-MM-DD.
  - end_date (optional): YYYY-MM-DD.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/meta_ads/search-companies (4cr) — params: query*, dry_run — Search Meta Ad Library advertisers: page id, name, category, likes, verification and Instagram handle. The page id feeds meta_ads/company-ads.
  Reference: https://www.monocrawl.com/docs/endpoints/meta_ads/search-companies.md
  - query (required): Company or brand name. Example: "nike"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## monitors
- GET /v1/monitors/analytics (0cr) — params: days, dry_run — Your monitoring at a glance: monitors by state, runs, findings, suppressed duplicates, alert delivery, credits, upstream cost and cache savings, and time to first finding.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/analytics.md
  - days (optional): Window, up to 90 days Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/create (1cr) — params: kind, query, entity, entity_type, purpose, sources, exclude, relationships, filters, aliases, max_metered, lookback_days, feed_platform, feed_endpoint, feed_params_json, schedule_minutes, monthly_cap_credits, delivery_in_app, delivery_webhook, name, url, platform, endpoint, params_json, output, destinations, feeds_json, expected_run_credits, result_mode, dry_run, relevance_enabled, relevance_prompt, exclusions — Save a monitor and its schedule. A subject monitor follows a resolved name across platforms and records only what is new; a feed monitor records new items from one review or listing endpoint; a change monitor snapshots a page or endpoint. Creating costs the listed credits; each run of a subject or feed monitor is charged separately, up to its monthly cap.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/create.md
  - kind (optional): What kind of monitor: subject (a name, handle, product or topic followed across platforms), feed (new items from one review or listing endpoint) or change (a page or endpoint snapshot, the original monitor). Defaults to subject when query is given, change otherwise. Example: "subject"
  - query (optional): What to watch: a name, product, handle, domain or keyword for a subject monitor; for a feed template, its identifier — a subreddit, a video link, an app id, or for Google Maps reviews a pasted Maps link or a Place id (a link is resolved through one places search, charged once). Example: "Monzo"
  - entity (optional): subject: the sense id chosen from a preview or a clarification (bare for the plain name, sense:… for a qualified one) Example: "bare"
  - entity_type (optional): subject: creator_media, developer, brand, company, event or community — guides source routing Example: "brand"
  - purpose (optional): A preset id (brand_mentions, complaints, competitor_activity, switching_intent, purchase_intent, questions, developments, app_reviews, local_reviews, custom) or a short free-text purpose Example: "complaints"
  - sources (optional): subject: platforms to search, comma-separated; defaults to the preset's recommendation Example: "reddit,x,hackernews"
  - exclude (optional): subject: platforms to leave out Example: "tiktok"
  - relationships (optional): subject: which classes of material count as findings (official_owned, employee_team, collaborator_partner, editorial_news, fan_clip, independent_audience). Default: everything except unrelated material. Example: "independent_audience,editorial_news"
  - filters (optional): subject: deterministic purpose filters applied to findings: complaints, switching, buying, questions Example: "complaints"
  - aliases (optional): subject: other names the subject is known by, comma-separated Example: "@monzo,Monzo Bank"
  - max_metered (optional): subject: how many metered platforms each run may spend on, 0-2 (default 1) Example: "1"
  - lookback_days (optional): subject: how far back the first run looks (default 7); later runs continue from the last successful run Example: "7"
  - feed_platform (optional): feed: platform of the review or listing endpoint Example: "app_store"
  - feed_endpoint (optional): feed: endpoint id, e.g. app-reviews Example: "app-reviews"
  - feed_params_json (optional): feed: JSON object of parameters for the endpoint Example: "{\"app_id\":\"310633997\"}"
  - schedule_minutes (optional): Minutes between runs. The console offers 60, 360, 1440 and 10080; the API accepts any value from 15 to 43200. Example: "1440"
  - monthly_cap_credits (optional): subject/feed: the most credits this monitor may spend in a calendar month (default 300, maximum 5000). Runs are skipped, never charged, once the cap is reached. Example: "300"
  - delivery_in_app (optional): Create an in-app notification when a run finds something new (default true) Example: "true"
  - delivery_webhook (optional): Emit monitor.findings to your signed webhook endpoints (default false) Example: "true"
  - name (optional): Human label; suggested from the purpose and subject when omitted Example: "Monzo complaints"
  - url (optional): change: page to watch. Give this OR platform+endpoint. Example: "https://example.com/pricing"
  - platform (optional): change: platform of an API endpoint to watch, e.g. github. Give with endpoint. Example: "github"
  - endpoint (optional): change: endpoint id to watch, e.g. repo Example: "repo"
  - params_json (optional): change: JSON object of parameters passed to the watched endpoint on every run Example: "{\"owner\":\"vercel\",\"repo\":\"next.js\"}"
  - output (optional): subject and feed: report (each run leads with what changed and why it matters, every line with its receipts; the default for the intelligence templates) or everything (every new post, comment or review, listed; the default for feeds and follow templates) Example: "report"
  - destinations (optional): JSON array of where alerts go and how often. kind: email (the account address), endpoint (one of your Slack channels, Discord channels or webhooks by endpoint_id; omit endpoint_id for every active endpoint), push (the devices that turned push on). cadence: immediate, daily or weekly. min_severity for immediate: info (every new finding), notable or critical. The monitor page is always included unless delivery_in_app=false. Replaces delivery_email, delivery_webhook and delivery_mode when given. Example: "[{\"kind\":\"endpoint\",\"endpoint_id\":\"whk_…\",\"cadence\":\"immediate\",\"min_severity\":\"notable\"},{\"kind\":\"email\",\"cadence\":\"daily\"}]"
  - feeds_json (optional): Several feeds at once, as a JSON array of {platform, endpoint, params}. Follow an account reads timelines: x/tweets (handle, metered), bluesky/user/posts (handle), youtube/channel/videos (handle or url). Every feed must be live-proven on this deployment; the review says so per feed. Example: "[{\"platform\":\"bluesky\",\"endpoint\":\"user/posts\",\"params\":{\"handle\":\"name.bsky.social\"}},{\"platform\":\"youtube\",\"endpoint\":\"channel/videos\",\"params\":{\"handle\":\"name\"}}]"
  - expected_run_credits (optional): Optional quote guard: refuse creation when the resolved per-run price differs. Obtain a quote from monitors/test first. Example: "2"
  - result_mode (optional): Change/endpoint monitors: snapshot saves each bounded response without AI; changes applies existing comparison rules (default). One request per check, no automatic pagination. Responses above 200 KB are not retained. Example: "snapshot"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - relevance_enabled (optional): Optional on every monitor. Enable or disable relevance filtering. Enabling requires a nonempty relevance_prompt. Example: "true"
  - relevance_prompt (optional): Up to 600 characters describing what should trigger an alert. A nonempty value enables filtering unless explicitly disabled. Empty clears it. Example: "Only genuine requests for recommendations; exclude promotions."
  - exclusions (optional): Comma-separated phrases skipped before AI; empty clears. Returned by monitor read tools. Example: "sponsored,job opening"
- DELETE /v1/monitors/delete (0cr) — params: id*, dry_run, confirm* — Permanently delete one of your monitors and its recorded run history, and cancel any check already queued for it. A Monocrawl extra: the reference catalogue catalogue has no monitor delete call, which makes its per-account monitor limit unrecoverable. This cannot be undone.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/delete.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - confirm (required): Set to true to permanently delete this monitor. Send an HTTP DELETE request; GET never deletes. Example: "true"
- GET /v1/monitors/drafts (0cr) — params: draft_id, proposal_json, activate, discard, dry_run — The proposals waiting for review. A draft is saved, edited, tested and finally activated into a monitor or discarded; nothing runs or is charged while it is a draft.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/drafts.md
  - draft_id (optional): One draft; without it, every open draft Example: "drf_…"
  - proposal_json (optional): With draft_id: replace the proposal (edited in the review) Example: "{…}"
  - activate (optional): With draft_id: create the monitor from the proposal and close the draft Example: "true"
  - discard (optional): With draft_id: close the draft without creating anything Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/export (0cr) — params: id*, format, days, feedback, scope, run_id, dry_run — Every finding in the window with its receipts — source, quote, link, author, posted time, severity, matches, story, topic, your verdict and the raw evidence row it was made from — as CSV or JSON.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/export.md
  - id (required): Monitor id Example: "mon_…"
  - format (optional): csv (default) or json Example: "csv"
  - days (optional): Window, up to 365 days Example: "30"
  - feedback (optional): Only findings with this verdict Example: "useful"
  - scope (optional): findings (default): the retained findings of the window. collected: every item one run collected, retained or not, with the decision and the reason; needs run_id, or takes the latest run. Runs before 5 September 2026 did not keep their collected items and say so. Example: "collected"
  - run_id (optional): With scope=collected: the run to export. Defaults to the latest run. Example: "1396"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/feedback (0cr) — params: id*, ids*, verdict*, scope, dry_run — Records your verdict on findings and remembers it: what you mark known, resolved or irrelevant is not surfaced again by later runs (the same conversation, link, wording, topic or, for irrelevant, author), and what you mark useful is kept as a positive example for the relevance filter.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/feedback.md
  - id (required): Monitor id Example: "mon_…"
  - ids (required): Finding ids, comma-separated Example: "fnd_…,fnd_…"
  - verdict (required): known, resolved, irrelevant or useful Example: "irrelevant"
  - scope (optional): finding (default) or story: apply to the whole story the findings belong to Example: "story"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/findings (0cr) — params: id*, unseen, run_id, limit, cursor, mark_seen, dry_run — The findings a subject or feed monitor has recorded, newest first: each with its platform, author, link, posted time, relationship to the subject and the purpose filters it matched. A finding is recorded once per monitor, however many runs see it.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/findings.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - unseen (optional): Only findings not yet marked as seen Example: "true"
  - run_id (optional): Only findings first recorded by this run Example: "42"
  - limit (optional): Page size, 1-200 (default 50) Example: "50"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - mark_seen (optional): Mark the returned findings as seen Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/get (0cr) — params: id*, dry_run — One monitor with its target, schedule and the summary of its most recent run.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/get.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/health (0cr) — params: id*, dry_run — A monitor's health and coverage: consecutive failures, missed checks, stale sources, provider failures, which configured sources are live, and what its checks cost and avoided.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/health.md
  - id (required): Monitor id Example: "mon_…"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/index (0cr) — params: status, cursor, limit, dry_run — Your monitors, newest first, with each one's schedule and next due time.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/index.md
  - status (optional): Filter by monitor status: active or paused Example: "active"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - limit (optional): Page size, 1-100 (default 25) Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/preview (0cr) — params: query*, entity, entity_type, purpose, sources, schedule_minutes, monthly_cap_credits, dry_run, relevance_enabled, relevance_prompt, exclusions — What a subject monitor would do, before it exists: the resolved subject or the senses to choose from, the recommended platforms with reasons, the schedule, the credit estimate from the price list, and a few pieces of no-cost evidence. Runs the free first pass only — no metered platform and no paid fallback is touched.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/preview.md
  - query (required): The name, handle, URL, domain, product or keyword to follow Example: "Monzo"
  - entity (optional): A sense id from an earlier preview, when the name was ambiguous Example: "bare"
  - entity_type (optional): Optional type hint Example: "brand"
  - purpose (optional): Preset id or free text; sets the recommended sources and filters Example: "complaints"
  - sources (optional): Override the recommended platforms Example: "reddit,x"
  - schedule_minutes (optional): Interval used for the monthly estimate Example: "1440"
  - monthly_cap_credits (optional): Cap used for the monthly estimate Example: "300"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - relevance_enabled (optional): Optional on every monitor. Enable or disable relevance filtering. Enabling requires a nonempty relevance_prompt. Example: "true"
  - relevance_prompt (optional): Up to 600 characters describing what should trigger an alert. A nonempty value enables filtering unless explicitly disabled. Empty clears it. Example: "Only genuine requests for recommendations; exclude promotions."
  - exclusions (optional): Comma-separated phrases skipped before AI; empty clears. Returned by monitor read tools. Example: "sponsored,job opening"
- GET /v1/monitors/propose (0cr) — params: text*, template, dry_run — Turns a plain-English request into a complete, editable monitor proposal: what it watches, the identifiers it found, the platforms, the matching rules and exclusions, the frequency, the delivery and the estimated cost, with the reason for each choice. Nothing is created.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/propose.md
  - text (required): What you want to keep an eye on, in a sentence Example: "Tell me when people complain about Monzo on Reddit or Hacker News"
  - template (optional): Start from a template id instead of, or as well as, the sentence Example: "complaints"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/report (0cr) — params: id*, story_id, days, dry_run — Turns a monitor's findings (or one story) into a saved research report with citations, verified facts kept apart from generated interpretation, ready to share or export as Markdown or JSON.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/report.md
  - id (required): Monitor id Example: "mon_…"
  - story_id (optional): Only this story's findings Example: "sty_…"
  - days (optional): Findings from the last N days (default 7) Example: "7"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/run (0cr) — params: id*, confirm, expected_run_credits, dry_run — Queue one run of a subject or feed monitor outside its schedule. The estimate is returned first; the run is charged at that estimate when you confirm, refunded down to what was actually retrieved, and skipped without a charge if the monthly cap would be exceeded.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/run.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - confirm (optional): Without confirm=true the call only returns what a run would cost. With it, the run is charged and queued. Example: "true"
  - expected_run_credits (optional): Refuse a confirmed manual check if its quote changed, including under the reservation lock. Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/runs (0cr) — params: id*, status, from, to, include, cursor, limit, dry_run — The check history for a monitor, newest first, with what changed on each run.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/runs.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - status (optional): Filter by run status: ok or error Example: "ok"
  - from (optional): Only runs at or after this ISO-8601 time Example: "2026-01-01T00:00:00Z"
  - to (optional): Only runs at or before this ISO-8601 time Example: "2026-02-01T00:00:00Z"
  - include (optional): Add the heavy fields: snapshot and/or diff (omitted by default) Example: "snapshot,diff"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - limit (optional): Page size, 1-100 (default 25) Example: "25"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/settings (0cr) — params: monthly_budget_credits, digest_frequency, digest_hour, digest_email, digest_webhook, digest_report, dry_run — Read or change the account-wide monitor budget and the digest schedule. Reads with no parameters; writes with any of them.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/settings.md
  - monthly_budget_credits (optional): Account-wide monthly budget for monitor runs; empty for none Example: "1000"
  - digest_frequency (optional): off, daily or weekly Example: "daily"
  - digest_hour (optional): UTC hour the digest is assembled Example: "8"
  - digest_email (optional): Send the digest by email Example: "true"
  - digest_webhook (optional): Send the digest to subscribed webhooks Example: "false"
  - digest_report (optional): Also save each digest as a research report Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/stories (0cr) — params: id*, limit, dry_run — The developing stories a monitor's related findings have been grouped into, with counts, severity and when each was last seen.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/stories.md
  - id (required): Monitor id Example: "mon_…"
  - limit (optional): Stories, newest first Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/test (0cr) — params: query, entity, purpose, sources, filters, confirm, endpoint, expected_run_credits, kind, monthly_cap_credits, params_json, platform, result_mode, schedule_minutes, url, dry_run, relevance_enabled, relevance_prompt, exclusions — Run one real check for a monitor that does not exist yet and see what you would have been told about. Charged like one run and refunded down to what was retrieved; nothing is recorded and nothing is sent.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/test.md
  - query (optional): The name, handle, URL, domain, product or keyword the monitor would follow Example: "Monzo"
  - entity (optional): A sense id from a preview when the name was ambiguous Example: "bare"
  - purpose (optional): Template id or free text Example: "complaints"
  - sources (optional): Platforms to search Example: "reddit,x"
  - filters (optional): Purpose filters Example: "complaints"
  - confirm (optional): Without confirm=true the call only returns what the test would cost. With it, the test is charged like one run. Example: "true"
  - endpoint (optional): Endpoint identifier within the platform. Example: "profile"
  - expected_run_credits (optional): Refuse a confirmed preview if the per-run price changed after quoting. Example: "2"
  - kind (optional): change for a URL or endpoint request; subject/feed for existing analysis workflows. Example: "change"
  - monthly_cap_credits (optional): Proposed monthly monitor cap. Example: "300"
  - params_json (optional): JSON object of endpoint parameters. Validated against the current registry; no credentials. Example: "{\"handle\":\"torvalds\"}"
  - platform (optional): Platform for an endpoint request. Example: "github"
  - result_mode (optional): snapshot or changes. Neither enables AI on an endpoint request. Example: "snapshot"
  - schedule_minutes (optional): Fixed interval in minutes for the proposed monitor. Example: "1440"
  - url (optional): A page URL instead of platform/endpoint. Example: "https://example.com"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - relevance_enabled (optional): Optional on every monitor. Enable or disable relevance filtering. Enabling requires a nonempty relevance_prompt. Example: "true"
  - relevance_prompt (optional): Up to 600 characters describing what should trigger an alert. A nonempty value enables filtering unless explicitly disabled. Empty clears it. Example: "Only genuine requests for recommendations; exclude promotions."
  - exclusions (optional): Comma-separated phrases skipped before AI; empty clears. Returned by monitor read tools. Example: "sponsored,job opening"
- GET /v1/monitors/test-delivery (0cr) — params: destinations*, name, id, dry_run — Sends one clearly-marked sample alert (a short report with receipts) to the destinations given, right now, and reports what each one answered. Nothing is recorded, nothing is charged, and no real finding is involved: it proves the channel works before a monitor is switched on.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/test-delivery.md
  - destinations (required): The destinations to send the sample to, as for monitors/create Example: "[{\"kind\":\"endpoint\",\"endpoint_id\":\"whk_…\"}]"
  - name (optional): The monitor name to show on the sample Example: "Monzo complaints"
  - id (optional): The monitor the sample is sent from, when it already exists: the sample then links to that monitor’s page and takes its name. Without it, the sample links to the monitors list. Example: "mon_…"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/timeseries (0cr) — params: id*, metric*, from, to, dry_run — One numeric metric from a monitor's runs as a chartable time series.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/timeseries.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - metric (required): Metric key to chart; a 422 lists the metrics this monitor has recorded Example: "content_length"
  - from (optional): Only points at or after this ISO-8601 time Example: "2026-01-01T00:00:00Z"
  - to (optional): Only points at or before this ISO-8601 time Example: "2026-02-01T00:00:00Z"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/trends (0cr) — params: id*, metric, days, dry_run — A metric over time with the previous period and the baseline beside it, so a change can be judged against what is normal for this monitor.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/trends.md
  - id (required): Monitor id Example: "mon_…"
  - metric (optional): findings, or any numeric metric the runs record Example: "findings"
  - days (optional): Window, up to 90 days Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/monitors/update (0cr) — params: id*, status, name, schedule_minutes, monthly_cap_credits, delivery_in_app, delivery_webhook, sources, relationships, filters, max_metered, output, destinations, feeds_json, dry_run, relevance_enabled, relevance_prompt, exclusions — Pause, resume, rename, reschedule or re-scope one of your monitors. Give at least one field besides id.
  Reference: https://www.monocrawl.com/docs/endpoints/monitors/update.md
  - id (required): Monitor id Example: "mon_0f2c8b1d4e6a7c9b0d1e2f3a"
  - status (optional): active to resume runs, paused to stop them. Pausing clears the next run time; resuming schedules the next run one interval from now. Example: "paused"
  - name (optional): New label; pass an empty string to clear it Example: "Monzo complaints"
  - schedule_minutes (optional): New interval between runs; minimum 15, maximum 43200. Rescheduling re-times the next run from now. Example: "1440"
  - monthly_cap_credits (optional): subject/feed: new monthly cap, 0-5000 Example: "500"
  - delivery_in_app (optional): subject/feed: in-app notifications on or off Example: "true"
  - delivery_webhook (optional): subject/feed: signed webhook deliveries on or off Example: "false"
  - sources (optional): subject: replace the platforms searched Example: "reddit,hackernews"
  - relationships (optional): subject: replace which classes of material count Example: "independent_audience"
  - filters (optional): subject: replace the purpose filters Example: "complaints"
  - max_metered (optional): subject: metered platforms per run, 0-2 Example: "1"
  - output (optional): subject and feed: report (each run leads with what changed and why it matters, every line with its receipts; the default for the intelligence templates) or everything (every new post, comment or review, listed; the default for feeds and follow templates) Example: "report"
  - destinations (optional): JSON array of where alerts go and how often. kind: email (the account address), endpoint (one of your Slack channels, Discord channels or webhooks by endpoint_id; omit endpoint_id for every active endpoint), push (the devices that turned push on). cadence: immediate, daily or weekly. min_severity for immediate: info (every new finding), notable or critical. The monitor page is always included unless delivery_in_app=false. Replaces delivery_email, delivery_webhook and delivery_mode when given. Example: "[{\"kind\":\"endpoint\",\"endpoint_id\":\"whk_…\",\"cadence\":\"immediate\",\"min_severity\":\"notable\"},{\"kind\":\"email\",\"cadence\":\"daily\"}]"
  - feeds_json (optional): Several feeds at once, as a JSON array of {platform, endpoint, params}. Follow an account reads timelines: x/tweets (handle, metered), bluesky/user/posts (handle), youtube/channel/videos (handle or url). Every feed must be live-proven on this deployment; the review says so per feed. Example: "[{\"platform\":\"bluesky\",\"endpoint\":\"user/posts\",\"params\":{\"handle\":\"name.bsky.social\"}},{\"platform\":\"youtube\",\"endpoint\":\"channel/videos\",\"params\":{\"handle\":\"name\"}}]"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - relevance_enabled (optional): Optional on every monitor. Enable or disable relevance filtering. Enabling requires a nonempty relevance_prompt. Example: "true"
  - relevance_prompt (optional): Up to 600 characters describing what should trigger an alert. A nonempty value enables filtering unless explicitly disabled. Empty clears it. Example: "Only genuine requests for recommendations; exclude promotions."
  - exclusions (optional): Comma-separated phrases skipped before AI; empty clears. Returned by monitor read tools. Example: "sponsored,job opening"
## on_page
- GET /v1/on_page/page (3cr) — params: url*, timeout, dry_run — On-page SEO audit of one URL: title and meta description checks, heading structure, image alt coverage, internal/external links, canonical, robots meta, social tags, HTTPS, word count, and a severity-ranked findings list.
  Reference: https://www.monocrawl.com/docs/endpoints/on_page/page.md
  - url (required): Page URL to audit (http/https, public hosts only) Example: "https://example.com"
  - timeout (optional): Fetch budget in milliseconds, clamped to 1000-15000 Example: "10000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## panorama
- GET /v1/panorama/ai-visibility (30cr) — params: brand*, prompts, topic, competitors, engines, preset, runs, brand_domains, dry_run — How often each answer engine names the brand and its competitors across repeated runs of the prompts, per engine, with the domains the engines cited ranked. Costs are the engines' metered model prices.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/ai-visibility.md
  - brand (required): Literal brand name, 1–200 characters. Example: "My Brand"
  - prompts (optional): JSON array of strings or |-separated prompts, each at most 2,000 characters. Required unless topic is supplied. Example: "[\"Which project tools are useful?\"]"
  - topic (optional): Build one default prompt if prompts is absent. Example: "project collaboration"
  - competitors (optional): Up to five distinct comma-separated names, each at most 200 characters. Example: "Other Brand"
  - engines (optional): Explicit engine subset; default both. Availability depends on configured eligible supply. Example: "perplexity,grok"
  - preset (optional): quick: 2 runs/3 prompts; standard: 4/8; deep: 8/20. Default quick. Preset still caps prompts when runs is explicit. Example: "quick"
  - runs (optional): Integer 1–20. Explicit value overrides preset repetitions. Total planned probes must fit the deployment cap (default 40). Example: "1"
  - brand_domains (optional): Comma-separated domains to label yours in cited_domains. Example: "example.com"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/answers (10cr) — params: query*, engines, dry_run — The same question asked of Perplexity and xAI in parallel: each engine's answer verbatim with its citations, a merged citation list saying which engines cited each source, an agreement matrix and each engine's dollar cost.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/answers.md
  - query (required): The question, sent verbatim to every engine Example: "Which UK banks offer the best savings rates this month?"
  - engines (optional): Comma-separated engines: perplexity, grok (default both) Example: "perplexity,grok"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/audience-overlap (10cr) — params: handle_a*, handle_b*, platform, videos_per_creator, depth, dry_run — How much two creators' commenter audiences overlap: shared commenters, Jaccard index, a-only and b-only counts and a confidence from the sample sizes, computed deterministically from sampled posts and comments.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/audience-overlap.md
  - handle_a (required): First creator handle Example: "mkbhd"
  - handle_b (required): Second creator handle Example: "mrwhosetheboss"
  - platform (optional): tiktok (default), instagram or x Example: "tiktok"
  - videos_per_creator (optional): Recent posts sampled per creator, 1 to 10 Example: "5"
  - depth (optional): Comments read per post, 10 to 100 Example: "50"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/brand-mentions (5cr) — params: brand*, platforms, date_mode, per_source_limit, lookback_days, context, relevance, include_history, enrich, dry_run — Collect a bounded native social search sample for one brand, with original evidence, engagement, dates and per-source coverage. Defaults to Reddit, Hacker News, X, TikTok, Instagram and YouTube, plus configured Bluesky; platforms selects supported alternatives. Strict dates exclude unknown or out-of-window records. Optional indexed history is a separate measurement; source eligibility and workflow limits apply.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/brand-mentions.md
  - brand (required): The brand or product to find mentions of Example: "minoapi"
  - platforms (optional): CSV of supported sources: reddit,hackernews,bluesky,github,x,tiktok,instagram,youtube,linkedin,threads,pinterest. Default the six example sources. Each remains subject to eligibility, funding, deadlines and limits. Example: "reddit,hackernews,x,tiktok,instagram,youtube"
  - date_mode (optional): ranked (default) retains date-labelled matches; strict excludes unknown and out-of-window dates. Example: "strict"
  - per_source_limit (optional): Integer 1–50, default25. Bounded sample per source; no full-platform count. Example: "25"
  - lookback_days (optional): Integer1–366, default30. Example: "30"
  - context (optional): Optional subject context, at most1000 characters. Adds a bounded hint from the caller’s positive context to native search and prioritises returned candidates; inspect query_plan and source queries. Also guides optional Jev classification where supported. No inferred aliases or identity guarantee. Example: "Mercury, the business banking service; not the planet."
  - relevance (optional): none (default) or jev. Optional funded classification on at most20 candidates per brand, balanced across sources within relevance tiers. All original evidence and sampled arithmetic remain available. Inspect selection and classified counts; capacity and funding can leave records unclassified. Example: "none"
  - include_history (optional): Optional indexed web summary, trends and example citations. Defaultfalse. Reported separately from social sample metrics and subject to the same workflow supply budget. Example: "true"
  - enrich (optional): none (default), comments or transcripts. Add context to at most3 supported posts, capped at10 comments or8000 transcript characters each. Enrichment is not counted as another mention. Example: "comments"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/campaign (30cr) — params: hashtag*, phrase, window_start, window_end, pre_days, post_days, platforms, dry_run — Volume before, during and after a campaign window across TikTok, Instagram, X and YouTube for a hashtag or phrase: daily rates, lift, whether the floor held afterwards, per-platform engagement and the amplifiers with the most engagement during the window.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/campaign.md
  - hashtag (required): Campaign hashtag (or pass phrase) Example: "justdoit"
  - phrase (optional): A phrase instead of a hashtag Example: ""
  - window_start (optional): ISO start of the campaign window (default 7 days before window_end) Example: "2026-08-28"
  - window_end (optional): ISO end (default now) Example: "2026-09-04"
  - pre_days (optional): Baseline days before the window Example: "7"
  - post_days (optional): Days after the window Example: "7"
  - platforms (optional): Platforms to read Example: "tiktok,instagram,x,youtube"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/comment-lookup (3cr) — params: comments*, dry_run — Re-check up to 25 known comments in one call — current author, text, score and timestamp per item. References that share a parent post share a single upstream call. Supports hackernews items, reddit comments and github issue comments; a comment that has been deleted, or that sits behind an unexpanded Reddit "more" stub, is reported in failed[] rather than guessed.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/comment-lookup.md
  - comments (required): Up to 25 comment references, comma or newline separated (a JSON array also works). Accepted forms: a Hacker News item link or hackernews:{id}; a Reddit COMMENT permalink or reddit:{postId}/{commentId}; a GitHub comment permalink (…/issues/12#issuecomment-123). Example: "hackernews:8917,https://www.reddit.com/r/rust/comments/1abcdef/slug/lm3n4op/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/comments (5cr) — params: url*, max, replies, sort, cursor, dry_run — Every comment on one post, replies nested in children[], paged to completion server-side, with total, truncated and depth_max. Reddit, Hacker News and GitHub issues/PRs; capped at 500 nodes under a 20s budget, and a thread the upstream cannot fully expand says so in truncated and _warnings instead of looking complete.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/comments.md
  - url (required): The post whose comments you want. Supported: Hacker News item links, Reddit post permalinks, GitHub issue or pull-request URLs. Example: "https://news.ycombinator.com/item?id=8863"
  - max (optional): Maximum comment nodes to return, 1-500 (default 500). The tree is cut depth-first and truncated=true says so. Example: "500"
  - replies (optional): Set false to return only top-level comments (each with an empty children array). Example: "true"
  - sort (optional): Accepted for compatibility and ignored — each upstream returns its own comment order and re-sorting a nested tree would misrepresent it. Example: ""
  - cursor (optional): Accepted for compatibility and ignored — this endpoint pages to completion server-side and returns one whole tree. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/creator-vetting (8cr) — params: handle*, platform*, posts_limit, comment_posts, comments_per_post, content_review, dry_run — Research one creator on TikTok, Instagram, YouTube, X or Threads: public profile, a bounded recent-post sample, observed interaction metrics and posting cadence. Supported comment lookups sample multiple selected posts with explicit caps and original evidence. Optional content_review=1 adds advisory text-only flags with exact evidence for human review; it does not inspect images or videos. Missing counters stay unknown; no audience authenticity grade is inferred.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/creator-vetting.md
  - handle (required): Creator username without the @. Example: "nasa"
  - platform (required): tiktok, instagram, youtube, x or threads. Example: "tiktok"
  - posts_limit (optional): Integer1–20, default20; returned source can contain fewer posts. Missing YouTube counters are hydrated in one bounded batch for at most10 retained videos, subject to the same workflow budget. Example: "20"
  - comment_posts (optional): Integer0–10, default3; maximum posts to sample comments from. Example: "3"
  - comments_per_post (optional): Integer1–50, default20; maximum comments requested for each sampled post. Example: "20"
  - content_review (optional): Optional review of text from already-returned creator posts (default off). At most eight posts receive bounded advisory flags with exact source sentences for human review. Does not inspect images/video, verify allegations, infer identity or personal traits, determine authenticity, or score the creator. No extra source calls or credit surcharge; unavailable or uncertain analysis remains explicit within the existing request budget. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/crisis-postmortem (30cr) — params: brand*, window_start, window_end, crisis_terms, dry_run — A who-said-what-first timeline for a brand across the news index, Reddit, Hacker News and web search inside a window: the first credible origin, the peak day, volume by day, first appearance per platform and the ordered items.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/crisis-postmortem.md
  - brand (required): Brand or company Example: "Monzo"
  - window_start (optional): ISO start of the crisis window (default 14 days before window_end) Example: "2026-08-20"
  - window_end (optional): ISO end of the window (default now) Example: "2026-09-03"
  - crisis_terms (optional): Comma-separated terms; the first narrows the search Example: "outage"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/demand-signals (30cr) — params: keyword*, signals, app_store_id, google_play_id, amazon_query, country, depth, dry_run — A consumer-demand nowcast from published inputs: app-review velocity in both stores, news volume, Reddit velocity and the Amazon review-count level, each with its anchor, and a plain-mean index with disclosed weights; never an opaque score.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/demand-signals.md
  - keyword (required): Product, app or brand Example: "Monzo"
  - signals (optional): Inputs to read Example: "app_reviews,news,reddit,amazon"
  - app_store_id (optional): Skips the App Store lookup Example: ""
  - google_play_id (optional): Skips the Play lookup Example: ""
  - amazon_query (optional): Search terms for the Amazon input; defaults to the keyword Example: ""
  - country (optional): Storefront for the app stores Example: "gb"
  - depth (optional): Newest items per input, 10 to 100 Example: "50"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/devtool-brief (5cr) — params: query*, threads, dry_run — A developer tool in one call: its GitHub repo dossier (repo, README, releases, contributors, top issues) plus the Hacker News reaction and a 7-day commit count — fans out across up to 9 upstream calls, and reports every source that failed inline rather than guessing.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/devtool-brief.md
  - query (required): The tool: an owner/repo, a github.com URL, or a plain name (resolved by GitHub repository search) Example: "BurntSushi/ripgrep"
  - threads (optional): Hacker News threads to return, ranked by points (1-25, default 10) Example: "10"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/earned-media (5cr) — params: brand*, handles, platforms, date_mode, per_source_limit, lookback_days, context, dry_run — Split a bounded social mention sample into owned and earned using caller-declared account handles. Preserve original evidence, source coverage and unknown interaction counters. Shares are fractions over the returned sample; missing authors or undeclared accounts count as earned with a warning.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/earned-media.md
  - brand (required): Brand, product or campaign phrase to attribute mentions for. Example: "minoapi"
  - handles (optional): Comma list of the brand's OWN accounts, source-scoped or bare: reddit:acme,bluesky:acme.bsky.social,acme. Without it everything counts as earned. Example: "reddit:acme"
  - platforms (optional): CSV of supported sources: reddit,hackernews,bluesky,github,x,tiktok,instagram,youtube,linkedin,threads,pinterest. Default the six example sources. Each remains subject to eligibility, funding, deadlines and limits. Example: "reddit,hackernews,x,tiktok,instagram,youtube"
  - date_mode (optional): ranked (default) retains date-labelled matches; strict excludes unknown and out-of-window dates. Example: "strict"
  - per_source_limit (optional): Integer 1–50, default25. Bounded sample per source; no full-platform count. Example: "25"
  - lookback_days (optional): Integer1–366, default30. Example: "30"
  - context (optional): Optional subject context, at most1000 characters. Adds a bounded hint from the caller’s positive context to native search and prioritises returned candidates; inspect query_plan and source queries. Also guides optional Jev classification where supported. No inferred aliases or identity guarantee. Example: "Mercury, the business banking service; not the planet."
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/employer-brand (30cr) — params: company*, linkedin_url, surfaces, phrases, include, dry_run — What people say about working at a company: the company's own LinkedIn voice beside Reddit, the news index and YouTube, with volumes, engagement and samples per surface and, on request, themed praise and complaints.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/employer-brand.md
  - company (required): Company name Example: "Monzo"
  - linkedin_url (optional): The company page, for its own voice Example: "https://www.linkedin.com/company/monzo-bank/"
  - surfaces (optional): Surfaces to read Example: "linkedin,reddit,news,youtube"
  - phrases (optional): Comma-separated phrases appended to the company for the outside search Example: "culture,interview"
  - include (optional): themes: a model pass naming praise and complaints from the outside chatter Example: "themes"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/handle-audit (5cr) — params: handle, handles, dry_run — Look up account presence using one handle on the default sources or an explicit handles mapping on supported social platforms. Each source reports taken, free after a clean not-found response, or unknown after a failure. Caller-declared identities are not verified common ownership; source eligibility and request limits apply.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/handle-audit.md
  - handle (optional): Handle checked on the default GitHub, Bluesky, Reddit and Hacker News sources. Required unless handles is supplied. Example: "mybrand"
  - handles (optional): JSON object mapping 1–9 explicit platforms to handles of at most200 characters. Supported: github,bluesky,reddit,hackernews,x,tiktok,instagram,youtube,threads. Overrides the default handle lookup. Account ownership across platforms is not verified. Example: "{\"instagram\":\"mybrand\",\"tiktok\":\"mybrand\"}"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/launch-brief (5cr) — params: query*, threads, comments, dry_run — How a launch landed on Hacker News: the top threads by points with their root comments, plus thread/point/comment totals and the first and last time it was discussed — 1 + N upstream calls; the platforms Monocrawl cannot reach are named in _warnings rather than silently omitted.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/launch-brief.md
  - query (required): The launch, product or announcement to trace Example: "ripgrep"
  - threads (optional): Top threads by points to expand (1-10, default 5) Example: "5"
  - comments (optional): Root comments to pull per thread (0-20, default 5) Example: "5"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/leads (30cr) — params: freshness_days, mode, competitor, query, product_category, platforms, context, limit, lookback_days, subreddit, dry_run — Find public buying-intent discussions. Default mode=threads preserves the thread workflow. Optional mode=comments qualifies authored purchase intent and fit to your supplied product_category in bounded social comment samples; exact evidence, uncertain candidates and source coverage remain available. A label is not a verified sales opportunity.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/leads.md
  - freshness_days (optional): Keep conversations from the last N days, 1 to 365 Example: "90"
  - mode (optional): threads (default): existing alternative/comparison phrase search. comments: qualify authored purchase intent plus concrete offered-category fit from social comments. Example: "comments"
  - competitor (optional): Subject name or topic; query is an alternative. In comments mode use1–500 characters. Supply one of these inputs. Example: "My Brand"
  - query (optional): Alternative to competitor; the named field takes precedence. Example: "My Brand"
  - product_category (optional): Required for mode=comments,1–500 characters describing what you offer. A comment must support both purchase intent and concrete category fit; generic desire is insufficient. Example: "collaborative design software"
  - platforms (optional): Semantic/comments modes only. CSV subset reddit,x,tiktok,instagram,youtube; semantic questions additionally supports hackernews posts. Comments defaults TikTok,Instagram,YouTube; semantic defaults Reddit,Hacker News plus those three. No guarantee every selected source answers. Example: "youtube,tiktok,instagram"
  - context (optional): Optional intended-subject description, at most600 characters in semantic/comments modes. Helps bounded search and interpretation; untrusted data, not instructions. Example: "team interface design software"
  - limit (optional): Integer1–100, default25. Semantic/comments modes limit qualified text groups; all candidates remain in candidate_items. Example: "25"
  - lookback_days (optional): Semantic/comments modes: integer1–365, default90; freshness_days/freshness are aliases. Source date labels remain explicit; older or undated comments are retained, not falsely dated. Example: "90"
  - subreddit (optional): Optional Reddit community for semantic/comments modes; requires reddit in platforms. Questions threads mode also supports subreddit. Example: "design"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/lookup (1cr) — params: url*, dry_run — Universal URL dispatcher: paste any social, app-store, link-in-bio or web URL and it is parsed and routed to the matching Monocrawl detail endpoint, returning that endpoint's payload verbatim; a URL belonging to a platform we do not serve live is refused by name (it is never quietly scraped instead).
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/lookup.md
  - url (required): Any public URL: GitHub repo/issue/user, Hacker News item or user, Reddit post/subreddit/user, Bluesky post or profile, App Store app, Apple Music artist/album/song, a Linktree/Linkbio/Linkme/Komi/Pillar page, or any other http(s) page Example: "https://github.com/vercel/next.js"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/mention-surge (5cr) — params: brand*, window_days, baseline_days, history_mode, dry_run — Compare sampled social mention rates or request history_mode=indexed for closed historical reporting periods. Indexed results distinguish arithmetic observed ratios from confirmed comparisons; missing days or undeclared stable source coverage prevent a confirmed surge. Native social samples and indexed web citations have different coverage and denominators.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/mention-surge.md
  - brand (required): The brand or product to watch Example: "minoapi"
  - window_days (optional): Current window (default 7) Example: "7"
  - baseline_days (optional): Baseline window (default 28; must exceed window_days) Example: "28"
  - history_mode (optional): sampled (default) or indexed. Indexed compares complete, non-overlapping historical windows, excludes today and leaves missing days unknown. Example: "indexed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/org-brief (5cr) — params: org*, limit, dry_run — A GitHub organisation's footprint: its identity, its public repositories, and the top N by stars each expanded into a compact dossier (latest release + README excerpt) — fans out across 2 + 2xN upstream calls with a hard cap of 10 repos.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/org-brief.md
  - org (required): GitHub organisation or user login Example: "vercel"
  - limit (optional): How many top repos to expand into a compact dossier (1-10, default 5) — this parameter sets the fan-out width Example: "5"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/post-stats (5cr) — params: urls*, dry_run — Up to 100 mixed-platform post URLs in one call, each answered with current engagement (likes, comments, shares, views, score) and the time it was read. Fans out over hackernews, reddit, bluesky and github, 5 upstreams at a time. Fields a platform does not publish are null, never guessed; unreadable URLs are listed in failed[] with the reason.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/post-stats.md
  - urls (required): Up to 100 post URLs, comma or newline separated (a JSON array of URL strings also works). Recognised: Hacker News item links, Reddit permalinks and redd.it links, Bluesky post links and at:// URIs, and GitHub issue or pull-request URLs. Example: "https://news.ycombinator.com/item?id=8863,https://bsky.app/profile/bsky.app/post/3kabc"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/product-reviews (30cr) — params: query, asin, brand, trustpilot_domain, sources, depth, include, dry_run — A product's reviews across Amazon, Google Shopping offers and the brand's Trustpilot page, folded into per-source ratings (listed aggregates preferred over sample means), a retailer price matrix, one merged review sample and, on request, a themed topic pass.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/product-reviews.md
  - query (optional): Product name; or pass asin Example: "Sony WH-1000XM5"
  - asin (optional): Amazon ASIN or product URL (skips the search) Example: "B09Y2MYL5C"
  - brand (optional): Brand for the Trustpilot leg; defaults to the Amazon listing's brand Example: "Sony"
  - trustpilot_domain (optional): The brand's Trustpilot page domain (skips the Trustpilot search) Example: "sony.co.uk"
  - sources (optional): Sources to include Example: "amazon,google_shopping,trustpilot"
  - depth (optional): Reviews per source in the sample, 1 to 50 Example: "20"
  - include (optional): topics: a model pass that groups the sampled reviews by theme (rating impact is recomputed in code) Example: "topics"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/profiles (5cr) — params: pairs*, dry_run — Resolve up to50 explicit platform/handle pairs into canonical author records, including supported major social profiles. YouTube accepts handles or exact case-sensitive UC channel IDs. Each row uses its eligible route within the shared workflow limits; failures are reported per item. Summed followers are not unique reach, and matching names do not verify common ownership.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/profiles.md
  - pairs (required): Up to50 explicit platform/handle pairs. YouTube accepts a handle or an exact24-character UC channel ID; identifiers preserve case. Accounts and summed followers are not verified unique identities or reach. Example: "[{\"platform\":\"instagram\",\"handle\":\"mybrand\"},{\"platform\":\"youtube\",\"handle\":\"UC_x5XG1OV2P6uZZ5FSM9Ttw\"}]"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/questions (5cr) — params: timeframe, mode, topic, query, platforms, context, limit, lookback_days, subreddit, dry_run — Find audience questions. Default mode=threads preserves the thread workflow. Optional mode=semantic or mode=comments detects multilingual and indirect questions from bounded social evidence, with original text, supporting sentences, uncertain candidates and collection limits.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/questions.md
  - timeframe (optional): Reddit timeframe: hour, day, week, month, year or all Example: "year"
  - mode (optional): threads (default): existing title heuristic over Hacker News and Reddit. semantic: multilingual question classification over posts plus sampled comments. comments: classify only sampled comments. Example: "semantic"
  - topic (optional): Subject name or topic; query is an alternative. In semantic/comments mode use1–500 characters. Supply one of these inputs. Example: "My Brand"
  - query (optional): Alternative to topic; the named field takes precedence. Example: "My Brand"
  - platforms (optional): Semantic/comments modes only. CSV subset reddit,x,tiktok,instagram,youtube; semantic questions additionally supports hackernews posts. Comments defaults TikTok,Instagram,YouTube; semantic defaults Reddit,Hacker News plus those three. No guarantee every selected source answers. Example: "reddit,hackernews,youtube,tiktok,instagram"
  - context (optional): Optional intended-subject description, at most600 characters in semantic/comments modes. Helps bounded search and interpretation; untrusted data, not instructions. Example: "team interface design software"
  - limit (optional): Integer1–100, default25. Semantic/comments modes limit qualified text groups; all candidates remain in candidate_items. Example: "25"
  - lookback_days (optional): Semantic/comments modes: integer1–365, default90; freshness_days/freshness are aliases. Source date labels remain explicit; older or undated comments are retained, not falsely dated. Example: "90"
  - subreddit (optional): Optional Reddit community for semantic/comments modes; requires reddit in platforms. Questions threads mode also supports subreddit. Example: "design"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/reputation (30cr) — params: brand*, trustpilot_domain, sources, country, depth, app_store_id, google_play_id, place, include, dry_run — A brand's reputation across Trustpilot, both app stores, its Google Business listing, TripAdvisor when a place is given and the news echo, blended into a published-weight composite score with company and product axes, per-source ratings and samples, and, on request, themed praise and complaints.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/reputation.md
  - brand (required): Brand or company name Example: "Monzo"
  - trustpilot_domain (optional): The brand's Trustpilot page domain (skips the Trustpilot search) Example: "monzo.com"
  - sources (optional): Sources to include (tripadvisor when place is set) Example: "trustpilot,app_store,google_play,google_business,news"
  - country (optional): Storefront country for the app stores Example: "gb"
  - depth (optional): Reviews per source in the sample, 1 to 50 Example: "20"
  - app_store_id (optional): App Store id (skips the app search) Example: "1052238659"
  - google_play_id (optional): Play package (skips the app search) Example: "co.uk.getmondo"
  - place (optional): A TripAdvisor page URL to add as a source Example: ""
  - include (optional): themes: a model pass that names recurring praise and complaints with verbatim quotes Example: "themes"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/review-integrity (5cr) — params: country, app_id, review_sources, review_limit, date_from, date_to, dry_run — Inspect rating distributions, duplicates and timing in bounded review samples. Use an App Store id or explicitly mapped review sources. Cross-source comparisons require matching entity types, markets and variants; insufficient or mismatched evidence abstains. Statistical differences do not establish fake reviews or authenticity.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/review-integrity.md
  - country (optional): 2-letter storefront country (default us) Example: "us"
  - app_id (optional): Legacy App Store id. Required when review_sources is absent. Example: "123456789"
  - review_sources (optional): JSON array of 1–4 explicit source identities: platform app_store|google_play|amazon|trustpilot, id, common entity_key, optional country and variant. Product/app/company kinds cannot be mixed for comparison. Example: "[{\"platform\":\"app_store\",\"id\":\"123456789\",\"entity_key\":\"my-app\",\"country\":\"US\"}]"
  - review_limit (optional): Integer 1–100 per source, default50. Example: "50"
  - date_from (optional): Optional inclusive review_date start, YYYY-MM-DD. Publication time is used when supplied, otherwise the explicitly labelled update time. Requests with a date bound exclude undated evidence from statistics and return it separately. Example: "2026-09-01"
  - date_to (optional): Optional inclusive review_date end, YYYY-MM-DD. The same publication/update precedence applies; inspect each record’s date_basis. Example: "2026-09-19"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/share-of-voice (5cr) — params: brands*, platforms, date_mode, per_source_limit, lookback_days, context, relevance, dry_run — Compare 2–5 brands over bounded native social search samples. Mention shares use sources that answered for every brand; engagement shares also require observed counters on common sources. Fractions, evidence, source coverage and null denominators are explicit. Select supported sources with platforms; this is not total market share.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/share-of-voice.md
  - brands (required): 2–5 comma-separated brand or product names to compare Example: "deno,bun"
  - platforms (optional): CSV of supported sources: reddit,hackernews,bluesky,github,x,tiktok,instagram,youtube,linkedin,threads,pinterest. Default the six example sources. Each remains subject to eligibility, funding, deadlines and limits. Example: "reddit,hackernews,x,tiktok,instagram,youtube"
  - date_mode (optional): ranked (default) retains date-labelled matches; strict excludes unknown and out-of-window dates. Example: "strict"
  - per_source_limit (optional): Integer 1–50, default25. Bounded sample per source; no full-platform count. Example: "25"
  - lookback_days (optional): Integer1–366, default30. Example: "30"
  - context (optional): Optional subject context, at most1000 characters. Adds a bounded hint from the caller’s positive context to native search and prioritises returned candidates; inspect query_plan and source queries. Also guides optional Jev classification where supported. No inferred aliases or identity guarantee. Example: "Mercury, the business banking service; not the planet."
  - relevance (optional): none (default) or jev. Optional funded classification on at most20 candidates per brand, balanced across sources within relevance tiers. All original evidence and sampled arithmetic remain available. Inspect selection and classified counts; capacity and funding can leave records unclassified. Example: "none"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/truthsocial-pulse (10cr) — params: handle*, news_query, include, dry_run — A Truth Social handle's pulse: profile, activity and engagement from the newest posts, the top posts, and the news echo for the name.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/truthsocial-pulse.md
  - handle (required): Truth Social username Example: "realDonaldTrump"
  - news_query (optional): Search terms for the news echo; defaults to the display name Example: ""
  - include (optional): news (default), tone: a model reading of the sample Example: "news"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/video-intel (8cr) — params: url*, dry_run — One video, every angle: the post with its stats, the transcript, the top comments and the author profile — one composite, one call. engagement_rate = interactions ÷ plays, formula disclosed; legs a platform cannot serve are skipped with the reason. Failed legs prorate the price.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/video-intel.md
  - url (required): A video/post URL on tiktok, youtube, instagram, x or facebook. Example: "https://www.tiktok.com/@nasa/video/7665075736742530317"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/panorama/voice (5cr) — params: handle*, platforms, limit, include, dry_run — One person's recent public posts across X, Threads, Bluesky and Truth Social, time-merged into a single feed with platform presence, per-platform cadence and engagement, and the cross-posting rate; absence is part of the answer.
  Reference: https://www.monocrawl.com/docs/endpoints/panorama/voice.md
  - handle (required): Username shared across the microblogs (Bluesky handles without a dot get .bsky.social) Example: "nasa"
  - platforms (optional): Microblogs to read Example: "x,threads,bluesky,truthsocial"
  - limit (optional): Posts per platform, up to 50 Example: "20"
  - include (optional): tone: a model pass that labels each platform's tone from the sample Example: "tone"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## pillar
- GET /v1/pillar/page (1cr) — params: url*, dry_run — Creator identity and every outbound link on a public Pillar page.
  Reference: https://www.monocrawl.com/docs/endpoints/pillar/page.md
  - url (required): Full Pillar URL or the bare handle Example: "https://pillar.io/example"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## pinterest
- GET /v1/pinterest/board (2cr) — params: url*, cursor, dry_run — The pins on a board, one page at a time, in the same pin shape as the search route.
  Reference: https://www.monocrawl.com/docs/endpoints/pinterest/board.md
  - url (required): Board URL Example: "https://www.pinterest.com/lizmrodgers/moms-night/"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/pinterest/boards (2cr) — params: handle*, dry_run — A user's boards: name, URL, description, follower and pin counts, cover and created time.
  Reference: https://www.monocrawl.com/docs/endpoints/pinterest/boards.md
  - handle (required): Pinterest username Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/pinterest/pin (2cr) — params: url*, dry_run — One pin: description, alt text, image, created time, save, share and reaction counts, pinner and original pinner.
  Reference: https://www.monocrawl.com/docs/endpoints/pinterest/pin.md
  - url (required): Pin URL Example: "https://www.pinterest.com/pin/1234567890123456789/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/pinterest/search (2cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search Pinterest pins by keyword: title, description, image and author. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/pinterest/search.md
  - query (required): Search term. Example: "living room decor"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## polymarket
- GET /v1/polymarket/research (5cr) — params: query*, limit, dry_run — Search Polymarket for active prediction markets on a topic: question, outcomes with live prices, volume, liquidity, and end date, ranked by volume.
  Reference: https://www.monocrawl.com/docs/endpoints/polymarket/research.md
  - query (required): Topic to research Example: "bitcoin"
  - limit (optional): Max markets, 1-25 (default 10) Example: "10"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## quora
- GET /v1/quora/answers (2cr) — params: url*, dry_run — The answers on a Quora question page as a list (author, credentials, body, upvotes), with the question's title and total answer count. Quora loads further answers on scroll and offers no page cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/answers.md
  - url (required): Question page URL on quora.com Example: "https://www.quora.com/What-is-the-best-way-to-learn-Python"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/profile (3cr) — params: handle*, dry_run — A Quora profile (rendered page): name, credential line, description, follower and following counts, answer/question/post counts and the profile picture.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/profile.md
  - handle (required): Profile handle (the part after quora.com/profile/) or profile URL Example: "Barry-Rountree"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/question (2cr) — params: url*, dry_run — A Quora question: title, details, tags, answer/follower/view counts, the answers on the page (author, credentials, body, upvotes) and related questions.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/question.md
  - url (required): Question page URL on quora.com Example: "https://www.quora.com/What-is-the-best-way-to-learn-Python"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/search (3cr) — params: query*, page, dry_run — Quora pages matching a query, found through a web search of quora.com: questions, answers, space posts, spaces, profiles and topics, each with the title and the search snippet. Quora's own results page needs a signed-in session, so ranking and filters are the search engine's; pass the cursor as page for the next page.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/search.md
  - query (required): Search words Example: "learn python"
  - page (optional): Results page, 1 by default (the previous answer's cursor) Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/space (3cr) — params: handle*, dry_run — A Quora space (rendered page): name, description, follower count, contributors and the first posts.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/space.md
  - handle (required): Space handle (the part after quora.com/q/) or space URL Example: "clcoding"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/topic (3cr) — params: handle*, dry_run — A Quora topic (rendered page): name, description, follower count and the first questions.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/topic.md
  - handle (required): Topic handle (the part after quora.com/topic/) or topic URL Example: "Python-programming-language-1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/quora/user-posts (3cr) — params: handle*, dry_run — The first page of a Quora user's answers feed (rendered page): question, answer text, upvotes, date and URL.
  Reference: https://www.monocrawl.com/docs/endpoints/quora/user-posts.md
  - handle (required): Profile handle or profile URL Example: "Barry-Rountree"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## reddit
- GET /v1/reddit/omni-search (5cr) — params: query*, subreddit, threads, comments_per_thread, include, sort, timeframe, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One keyword swept across Reddit: the matching threads, the top-level comments on each, and the communities they sit in with subscriber and activity figures.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/omni-search.md
  - query (required): Keyword or phrase to sweep across Reddit Example: "notion alternatives"
  - subreddit (optional): Limit the sweep to one subreddit Example: ""
  - threads (optional): Threads to return, 1 to 10 Example: "5"
  - comments_per_thread (optional): Top-level comments per thread, 0 to 15 Example: "5"
  - include (optional): comments, subreddits, or none Example: "comments,subreddits"
  - sort (optional): relevance, hot, top, new or comments Example: "relevance"
  - timeframe (optional): hour, day, week, month, year or all Example: "year"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/post (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Title, author, score, flags and body for a single Reddit post by URL.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/post.md
  - url (required): Full Reddit post URL (permalink, redd.it or gallery link) Example: "https://www.reddit.com/r/Python/comments/1w6latb/it_seems_like_there_was_a_change_for_how_hex/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/post-transcript (5cr) — params: url*, language, dry_run — The spoken words of a Reddit-hosted video as text. transcript is null when the video has no speech — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/post-transcript.md
  - url (required): Reddit post URL containing a video. Example: "https://www.reddit.com/r/youseeingthisshit/comments/1oiu9xm/football_nostalgiasaints_punter_head_coach_cant/"
  - language (optional): Transcript language. Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/reddit/post/comments (5cr) — params: url*, cursor, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Retrieve a bounded, flattened comment tree for a Reddit post. Preserve parent_id and depth, and inspect truncated and unexpanded_replies. This operation has no supported next-page cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/post/comments.md
  - url (required): Full Reddit post URL (permalink, redd.it or gallery link) Example: "https://www.reddit.com/r/Python/comments/1w6latb/it_seems_like_there_was_a_change_for_how_hex/"
  - cursor (optional): Reserved compatibility parameter. This bounded comment-tree response has no supported continuation; inspect truncated and unexpanded_replies instead. Example: ""
  - trim (optional): true to truncate comment bodies to 500 characters Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/search (1cr) — params: query*, sort, timeframe, after, cursor, limit, include_body, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search posts across all of Reddit by keyword, with sort and time filters.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/search.md
  - query (required): Keyword or phrase to search for Example: "customer feedback"
  - sort (optional): relevance, hot, top, new or comments (default relevance) Example: "relevance"
  - timeframe (optional): hour, day, week, month, year or all Example: "month"
  - after (optional): Reddit fullname to continue after (alias of cursor) Example: "t3_1abcd2"
  - cursor (optional): Opaque cursor from the previous page Example: "t3_1abcd2"
  - limit (optional): Results per page, 1-100 (default 25) Example: "25"
  - include_body (optional): Include supplied selftext and HTML bodies (default true). Set false to omit them; trim=true also omits bodies. No additional supplier call. Example: "true"
  - trim (optional): true to force selftext bodies off Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/search-comments (1cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Global comment search. Returns comment text, author, signed score, timestamp, subreddit and source link. One page; follow cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/search-comments.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/search-subreddits (1cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Native subreddit discovery by search phrase, with public community metadata and pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/search-subreddits.md
  - query (required): Search phrase; ranked platform search, not a strict local substring match. Example: "NASA"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/subreddit (2cr) — params: subreddit*, sort, timeframe, after, cursor, limit, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Hot, new, top or rising posts from a subreddit, with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/subreddit.md
  - subreddit (required): Subreddit name, with or without the r/ prefix Example: "programming"
  - sort (optional): Listing order: hot, new, top or rising (default hot) Example: "hot"
  - timeframe (optional): Window for sort=top: hour, day, week, month, year or all Example: "week"
  - after (optional): Reddit fullname to continue after (alias of cursor) Example: "t3_1abcd2"
  - cursor (optional): Opaque cursor from the previous page Example: "t3_1abcd2"
  - limit (optional): Posts per page, 1-100 (default 25) Example: "25"
  - trim (optional): true to omit post selftext bodies Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/subreddit/details (1cr) — params: subreddit, url, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Subscribers, active users, description and metadata for a subreddit.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/subreddit/details.md
  - subreddit (optional): Subreddit name, with or without the r/ prefix Example: "programming"
  - url (optional): Any reddit.com subreddit URL (alternative to subreddit) Example: "https://www.reddit.com/r/programming/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/subreddit/search (1cr) — params: subreddit*, query*, sort, timeframe, cursor, include_body, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search posts within a single subreddit by keyword.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/subreddit/search.md
  - subreddit (required): Subreddit to search within (without r/) Example: "programming"
  - query (required): Search text within this subreddit. Required; use reddit/subreddit for recent posts without a query. Example: "javascript"
  - sort (optional): relevance, hot, top, new or comments Example: "relevance"
  - timeframe (optional): hour, day, week, month, year or all Example: "month"
  - cursor (optional): Continue a previous page (after also accepted) Example: ""
  - include_body (optional): Include post selftext bodies Example: "true"
  - trim (optional): Trim bodies out of the response Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/user (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Karma split, cake day and profile flags for a redditor.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/user.md
  - handle (required): See endpoint reference. Example: "spez"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/user-comments (1cr) — params: handle*, sort, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One source page of a public Reddit user history. Follow cursor to continue; no claim of complete or real-time history.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/user-comments.md
  - handle (required): Public Reddit username. Example: "GovSchwarzenegger"
  - sort (optional): Only new ordering is supported. Example: "new"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/reddit/user-posts (1cr) — params: handle*, sort, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One source page of a public Reddit user history. Follow cursor to continue; no claim of complete or real-time history.
  Reference: https://www.monocrawl.com/docs/endpoints/reddit/user-posts.md
  - handle (required): Public Reddit username. Example: "GovSchwarzenegger"
  - sort (optional): Only new ordering is supported. Example: "new"
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## rightmove
- GET /v1/rightmove/agents (2cr) — params: location, identifier, page, radius, name, branch_type, dry_run — The estate-agent branches in an area: brand, branch, summary, whether they sell or let, logo and telephone numbers.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/agents.md
  - location (optional): A postcode, town or area name; resolved once and remembered (or pass identifier) Example: "Birmingham"
  - identifier (optional): An area identifier from rightmove/locations Example: "REGION^1036"
  - page (optional): Page number Example: "1"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: ""
  - name (optional): Only branches whose name contains this Example: ""
  - branch_type (optional): The portal's branch type filter Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/locations (1cr) — params: query*, dry_run — The areas the portal knows for a name, each with the identifier the searches and the agents route take (REGION^…, OUTCODE^…, STATION^…).
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/locations.md
  - query (required): A postcode, town or area name Example: "SW3"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/property (3cr) — params: id*, url, dry_run — One listing's page: title, address, price and qualifier, tenure and charges, council tax, description and key features, the utilities and risks the agent declared, nearest stations, photos, floorplans, EPC, brochures and the agent branch.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/property.md
  - id (required): The listing number (or pass url, the listing's page) Example: "90874980"
  - url (optional): The listing's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/search-rent (3cr) — params: location, identifier, page, limit, radius, min_price, max_price, min_bedrooms, max_bedrooms, property_type, sort, keywords, must_have, dont_show, furnished, let_type, include_let_agreed, added, dry_run — Homes to rent in an area: address, type, bedrooms, monthly rent and its labels, agent, photos, position and when it was listed; the portal's featured homes beside them.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/search-rent.md
  - location (optional): A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier) Example: "Manchester"
  - identifier (optional): An area identifier from rightmove/locations Example: "REGION^87490"
  - page (optional): Page number Example: "1"
  - limit (optional): Results per page, 1 to 100 Example: "25"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: "1"
  - min_price (optional): Minimum monthly rent in pounds Example: ""
  - max_price (optional): Maximum monthly rent in pounds Example: ""
  - min_bedrooms (optional): Minimum bedrooms Example: ""
  - max_bedrooms (optional): Maximum bedrooms Example: ""
  - property_type (optional): detached, semi-detached, terraced, flat, bungalow; several separated by commas Example: "flat"
  - sort (optional): newest, oldest, highest_price or lowest_price Example: "newest"
  - keywords (optional): Words to prioritise, separated by commas Example: ""
  - must_have (optional): garden, parking, houseShare, retirement, student; separated by commas Example: ""
  - dont_show (optional): houseShare, retirement, student; separated by commas Example: ""
  - furnished (optional): furnished, partFurnished, unfurnished; separated by commas Example: ""
  - let_type (optional): longTerm or shortTerm Example: ""
  - include_let_agreed (optional): Include homes already let agreed Example: "false"
  - added (optional): Only homes added in the last 1, 3, 7 or 14 days Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/search-sale (3cr) — params: location, identifier, page, limit, radius, min_price, max_price, min_bedrooms, max_bedrooms, property_type, sort, keywords, must_have, dont_show, include_sold, added, dry_run — Homes for sale in an area: address, type, bedrooms, price and its label, agent, photos, position and when it was listed; the portal's featured homes beside them.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/search-sale.md
  - location (optional): A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier) Example: "SW3"
  - identifier (optional): An area identifier from rightmove/locations Example: "REGION^87490"
  - page (optional): Page number Example: "1"
  - limit (optional): Results per page, 1 to 100 Example: "25"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: "1"
  - min_price (optional): Minimum asking price in pounds Example: ""
  - max_price (optional): Maximum asking price in pounds Example: ""
  - min_bedrooms (optional): Minimum bedrooms Example: ""
  - max_bedrooms (optional): Maximum bedrooms Example: ""
  - property_type (optional): detached, semi-detached, terraced, flat, bungalow, land, park-home; several separated by commas Example: "flat,terraced"
  - sort (optional): newest, oldest, highest_price or lowest_price Example: "newest"
  - keywords (optional): Words to prioritise, separated by commas Example: "garden"
  - must_have (optional): garden, parking, newHome, retirement, sharedOwnership, auction; separated by commas Example: ""
  - dont_show (optional): newHome, retirement, sharedOwnership, auction; separated by commas Example: ""
  - include_sold (optional): Include homes sold subject to contract Example: "false"
  - added (optional): Only homes added in the last 1, 3, 7 or 14 days Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/similar (2cr) — params: id*, url, dry_run — The homes the portal shows as similar to one listing: address, price, bedrooms, type and photos.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/similar.md
  - id (required): The listing number (or pass url, the listing's page) Example: "90874980"
  - url (optional): The listing's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/sold-locations (1cr) — params: query*, dry_run — The areas the sold-prices index knows for a name, each with the identifier and type rightmove/sold-prices takes.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/sold-locations.md
  - query (required): A postcode, town or area name Example: "London"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/sold-prices (3cr) — params: location, identifier, type, page, radius, property_type, sort, years, dry_run — Land Registry sales in an area as the portal indexes them: address, type, bedrooms, every recorded sale with its date, price and tenure, and the last sale first.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/sold-prices.md
  - location (optional): A postcode, town or area name; resolved once and remembered (or pass identifier and type) Example: "Beeston, Nottingham"
  - identifier (optional): An area identifier from rightmove/sold-locations Example: "3205"
  - type (optional): The identifier's type from rightmove/sold-locations Example: "REGION"
  - page (optional): Page number (25 a page) Example: "1"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: ""
  - property_type (optional): detached, semi_detached, terraced or flat Example: ""
  - sort (optional): last_sold, lowest_price, highest_price or address Example: "last_sold"
  - years (optional): Only sales in the last 1, 2, 3, 5, 10, 15, 20 or 30 years Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rightmove/sold-property (2cr) — params: id*, url, dry_run — One sold property's history: every Land Registry sale with the change between them, the data's dates, and the listing the portal keeps beside it with its photos and floorplans.
  Reference: https://www.monocrawl.com/docs/endpoints/rightmove/sold-property.md
  - id (required): The sold property's id from a rightmove/sold-prices row (or pass url, its page) Example: "c152e439-e184-4300-8e6d-c4736523f835"
  - url (optional): The sold property's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## rumble
- GET /v1/rumble/channel-videos (2cr) — params: url*, handle, cursor, dry_run — A channel's videos, newest first, one page at a time, with the channel's name, URL and handle.
  Reference: https://www.monocrawl.com/docs/endpoints/rumble/channel-videos.md
  - url (required): Channel URL (or pass handle) Example: "https://rumble.com/c/nasa"
  - handle (optional): Channel handle, instead of url Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rumble/search (2cr) — params: query*, cursor, dry_run — Videos and shorts matching a query on Rumble, with views, duration, publish time and channel.
  Reference: https://www.monocrawl.com/docs/endpoints/rumble/search.md
  - query (required): Search query Example: "rocket launch"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rumble/video (2cr) — params: url*, dry_run — One video: title, description, duration, publish time, views, likes and dislikes, channel, embed URL and caption languages.
  Reference: https://www.monocrawl.com/docs/endpoints/rumble/video.md
  - url (required): Video URL Example: "https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rumble/video-comments (2cr) — params: url*, dry_run — Comments on a video: text, time, likes, dislikes, reply count and author.
  Reference: https://www.monocrawl.com/docs/endpoints/rumble/video-comments.md
  - url (required): Video URL Example: "https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/rumble/video-transcript (5cr) — params: url*, dry_run — The transcript of a video, with its language; has_transcript is false when there are no captions.
  Reference: https://www.monocrawl.com/docs/endpoints/rumble/video-transcript.md
  - url (required): Video URL Example: "https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## search
- GET /v1/search/all (10cr) — params: query*, estimate, sources, exclude, comments, lookback_days, timeframe, from_date, to_date, stream, dry_run, subject_match, subject_context, cursor — Cross-platform search as a pipeline: query intent detection, per-source entity resolution (handles are verified before account legs run), fan-out to live sources only, cross-source deduplication, relevance scoring with a floor, and per-source receipts (latency, cost, kept/dropped). A search with nothing relevant returns NO_USEFUL_SIGNAL and charges 0; partial source failures prorate the price. Set estimate=true for a free plan + max-cost preview.
  Reference: https://www.monocrawl.com/docs/endpoints/search/all.md
  - query (required): What to search. Plain topics, "quoted phrases", @handles, owner/repo, domains and URLs are each understood. Example: "model context protocol"
  - estimate (optional): true returns the execution plan and maximum cost without running anything. Free. Example: "true"
  - sources (optional): Comma list restricting the fan-out. Default sources (github, hackernews, reddit, bluesky, youtube) run unless excluded; metered sources (tiktok, instagram, linkedin, threads, pinterest, x) run ONLY when named here; free niche lanes (polymarket, google_news) also run only when named. A leg that cannot serve the query kind is skipped with the reason in the receipts. Unknown names are ignored with a warning; 'twitter' is accepted for x. Example: "github,reddit,tiktok"
  - exclude (optional): Comma list of sources to leave out. Example: "bluesky"
  - comments (optional): true fetches the top comments for the top results, cited per item under top_comments — only from sources with a live comment endpoint (reddit, hackernews, youtube; tiktok/instagram when opted in via sources=). Enrichment receipts land in the enrichment section; failures degrade per item. Example: "true"
  - lookback_days (optional): Only results from the last N days, where the source supports it. Example: "7"
  - timeframe (optional): hour | day | week | month | year | all — coarse alternative to lookback_days. Example: "week"
  - from_date (optional): ISO date lower bound, where the source supports it. Example: "2026-01-01"
  - to_date (optional): ISO date upper bound, where the source supports it. Example: "2026-03-01"
  - stream (optional): 1 answers text/event-stream: plan, source-started, source-completed, cost and enrichment progress events as legs actually run, then one final result event carrying the exact envelope a plain call returns — same billing, same receipts. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - subject_match (optional): Set context for Panorama Search discovery across explicitly selected sources. Example: "context"
  - subject_context (optional): Optional subject meaning, up to 240 characters. Requires subject_match=context. Example: "authentication software"
  - cursor (optional): Opaque continuation from a context search. Keep the original query, sources, context and date settings. Example: ""
- GET /v1/search/creators (10cr) — params: query*, sources, estimate, stream, dry_run — Cross-platform creator discovery over TikTok, Instagram and Threads: unified creator cards with reach, verification and per-card evidence (Threads creators are derived from matching posts and cite them). Every leg is metered, so the flagship fair-use ceiling applies; no creators found charges 0 and failed legs prorate.
  Reference: https://www.monocrawl.com/docs/endpoints/search/creators.md
  - query (required): Who to look for — a niche, a name, a topic. Example: "barefoot running"
  - sources (optional): Comma list restricting the fan-out: tiktok, instagram, threads (default all three). Example: "tiktok,instagram"
  - estimate (optional): true returns the plan and maximum cost without running anything. Free. Example: "true"
  - stream (optional): 1 answers text/event-stream: plan, source-started, source-completed, cost and enrichment progress events as legs actually run, then one final result event carrying the exact envelope a plain call returns — same billing, same receipts. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/search/forums (10cr) — params: query*, sources, exclude, comments, timeframe, lookback_days, dry_run — Fused forum search across Reddit and Hacker News, merged into one tagged result list. Naver is listed in sources_unavailable pending a keyed official API.
  Reference: https://www.monocrawl.com/docs/endpoints/search/forums.md
  - query (required): Search phrase Example: "rust async runtime"
  - sources (optional): Comma list restricting which forums are searched Example: "reddit,hackernews"
  - exclude (optional): Comma list of forums to skip Example: "hackernews"
  - comments (optional): Reserved — inline comments are not supported yet Example: "top"
  - timeframe (optional): hour | day | week | month | year | all Example: "week"
  - lookback_days (optional): Only results from the last N days, where the source supports it Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## sephora
- GET /v1/sephora/availability (3cr) — params: sku_id*, latitude*, longitude*, radius, dry_run — Which stores near a point stock one sku, with distance and in-store availability.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/availability.md
  - sku_id (required): Sku id from sephora/product Example: "2495505"
  - latitude (required): Latitude Example: "41.7887"
  - longitude (required): Longitude Example: "-87.7665"
  - radius (optional): Miles Example: "50"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/brand-products (3cr) — params: brand*, page, sort, dry_run — Products of one brand, sixty per page.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/brand-products.md
  - brand (required): Brand name from sephora/brands Example: "gucci"
  - page (optional): Page number (60 per page) Example: "1"
  - sort (optional): best_selling, top_rated, price_low_to_high, price_high_to_low or new Example: "best_selling"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/brands (1cr) — params: dry_run — Every brand the storefront lists, with ids and URLs.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/brands.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/categories (1cr) — params: dry_run — The storefront's top-level categories with ids for sephora/category.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/category (3cr) — params: id*, page, sort, min_price, max_price, dry_run — Products in a category, sixty per page.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/category.md
  - id (required): Category id from sephora/categories Example: "cat130054"
  - page (optional): Page number (60 per page) Example: "1"
  - sort (optional): best_selling, top_rated, price_low_to_high, price_high_to_low or new Example: "best_selling"
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/category-tree (1cr) — params: id*, dry_run — The child categories of one category.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/category-tree.md
  - id (required): Category id Example: "cat160006"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/product (3cr) — params: id*, sku_id, language, dry_run — One product: brand, price, rating and review count, loves, description, usage, images and its shade or size variants.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/product.md
  - id (required): Product id (P-number), or the product URL Example: "P427414"
  - sku_id (optional): A shade or size sku id Example: "2025633"
  - language (optional): en-US, en-CA or fr-CA Example: "en-US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/reviews (3cr) — params: id*, limit, offset, sort, rating, dry_run — Reviews of a product with author, rating, recommendation, verified-purchase badge, photos and helpfulness votes.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/reviews.md
  - id (required): Product id (P-number) Example: "P458747"
  - limit (optional): Reviews per page, up to 30 Example: "6"
  - offset (optional): Offset for the next page Example: "0"
  - sort (optional): most_helpful, highest_rating, lowest_rating, oldest or newest Example: "most_helpful"
  - rating (optional): Only this star rating, 1-5 Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/search (3cr) — params: query*, page, sort, category_id, min_price, max_price, min_rating, dry_run — Products matching a keyword, sixty per page, with brand, price, rating and badges.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/search.md
  - query (required): Search keyword Example: "eyeshadow"
  - page (optional): Page number (60 per page) Example: "1"
  - sort (optional): best_selling, top_rated, price_low_to_high, price_high_to_low or new Example: "best_selling"
  - category_id (optional): Category id from sephora/categories Example: ""
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - min_rating (optional): Minimum rating, 1-5 Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/similar (3cr) — params: id*, limit, dry_run — Products the storefront recommends alongside one product.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/similar.md
  - id (required): Product id (P-number) Example: "P510799"
  - limit (optional): How many Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/stores (1cr) — params: latitude*, longitude*, radius, dry_run — Stores near a point with address, phone, hours, pickup and curbside flags.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/stores.md
  - latitude (required): Latitude Example: "37.4419"
  - longitude (required): Longitude Example: "-122.1430"
  - radius (optional): Miles Example: "50"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/sephora/suggestions (1cr) — params: query*, language, dry_run — Search suggestions for a partial query, with the product each one leads to and the trending categories.
  Reference: https://www.monocrawl.com/docs/endpoints/sephora/suggestions.md
  - query (required): Partial search text Example: "eyeshadow"
  - language (optional): en-US, en-CA or fr-CA Example: "en-US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## snapchat
- GET /v1/snapchat/profile (2cr) — params: handle*, dry_run — A public Snapchat profile: name, bio, avatar, subscriber count, category, website and how many highlights and Spotlights it has.
  Reference: https://www.monocrawl.com/docs/endpoints/snapchat/profile.md
  - handle (required): Snapchat public profile username Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/snapchat/spotlight (4cr) — params: url*, dry_run — One Spotlight: description, content and thumbnail URLs, duration, upload time, creator and view, share, comment, boost and recommend counts.
  Reference: https://www.monocrawl.com/docs/endpoints/snapchat/spotlight.md
  - url (required): Spotlight URL Example: "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaHNzY2NxbWZ0AZTYE3AmAZTYE2UcAAAAAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/snapchat/spotlight-comments (2cr) — params: url*, cursor, dry_run — Comments on a Spotlight, one page at a time, with author names, times, reply counts and reactions.
  Reference: https://www.monocrawl.com/docs/endpoints/snapchat/spotlight-comments.md
  - url (required): Spotlight URL Example: "https://www.snapchat.com/@lilah4823/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## soundcloud
- GET /v1/soundcloud/artist (4cr) — params: handle*, url, dry_run — A SoundCloud profile: name, city and country, description, follower, following, track, playlist and like counts, verification.
  Reference: https://www.monocrawl.com/docs/endpoints/soundcloud/artist.md
  - handle (required): Profile permalink (or pass url) Example: "nasa"
  - url (optional): Profile URL, instead of handle Example: "https://soundcloud.com/nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/soundcloud/artist-tracks (4cr) — params: handle*, url, cursor, dry_run — A profile's tracks, one page at a time, with plays, likes, comments, reposts, genre, duration and licence.
  Reference: https://www.monocrawl.com/docs/endpoints/soundcloud/artist-tracks.md
  - handle (required): Profile permalink (or pass url) Example: "nasa"
  - url (optional): Profile URL, instead of handle Example: "https://soundcloud.com/nasa"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/soundcloud/track (4cr) — params: url*, dry_run — One track: title, artwork, genre, duration, dates, play and engagement counts, licence, label, artist and ISRC.
  Reference: https://www.monocrawl.com/docs/endpoints/soundcloud/track.md
  - url (required): Track URL Example: "https://soundcloud.com/nasa/example-track"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## spotify
- GET /v1/spotify/album (1cr) — params: id, url, market, dry_run — Look up one Spotify album by id or open.spotify.com URL, including label, copyrights, UPC, and the first page of its track listing.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/album.md
  - id (optional): Spotify album id (this or url) Example: "4aawyAB9vmqN3uQ7FjRGTy"
  - url (optional): open.spotify.com album URL or spotify:album: URI (this or id) Example: "https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy"
  - market (optional): ISO 3166-1 alpha-2 country to scope availability (optional) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/artist (2cr) — params: id*, dry_run — One Spotify artist: followers, monthly listeners, world rank, top cities, biography and top tracks with play counts.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/artist.md
  - id (required): Spotify artist id, from spotify/search. Example: "0cGUm45nv7Z6M6qdXYQGTX"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/playlist (4cr) — params: id*, url, cursor, dry_run — A public playlist with its owner, follower count and a page of tracks with play counts.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/playlist.md
  - id (required): Playlist id (or pass url) Example: "37i9dQZF1DXcBWIGoYBM5M"
  - url (optional): Playlist URL, instead of id Example: "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M"
  - cursor (optional): Opaque cursor from the previous page of tracks Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/podcast (1cr) — params: id, url, market, dry_run — Look up one Spotify podcast (show) by id or open.spotify.com URL: publisher, description, languages, and total episode count.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/podcast.md
  - id (optional): Spotify show id (this or url) Example: "38bS44xjbVVZ3No3ByF1dJ"
  - url (optional): open.spotify.com show URL or spotify:show: URI (this or id) Example: "https://open.spotify.com/show/38bS44xjbVVZ3No3ByF1dJ"
  - market (optional): ISO 3166-1 alpha-2 country; show availability is market-scoped (default US) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/podcast/episodes (1cr) — params: id, url, cursor, limit, market, dry_run — List a Spotify podcast's episodes newest-first, paginated: title, description, duration, release date, and audio preview.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/podcast/episodes.md
  - id (optional): Spotify show id (this or url) Example: "38bS44xjbVVZ3No3ByF1dJ"
  - url (optional): open.spotify.com show URL or spotify:show: URI (this or id) Example: "https://open.spotify.com/show/38bS44xjbVVZ3No3ByF1dJ"
  - cursor (optional): Offset for the next page (opaque, from a prior response) Example: "25"
  - limit (optional): Episodes per page, 1-50 (default 25) Example: "25"
  - market (optional): ISO 3166-1 alpha-2 country; episode availability is market-scoped (default US) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/search (2cr) — params: query*, dry_run — Search the Spotify catalog: matching artists, tracks, albums and playlists with ids and links.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/search.md
  - query (required): Artist, track, album or playlist name. Example: "daft punk"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/spotify/track (1cr) — params: id, url, market, dry_run — Look up one Spotify track by id or open.spotify.com URL, with ISRC, duration, artists, and album context.
  Reference: https://www.monocrawl.com/docs/endpoints/spotify/track.md
  - id (optional): Spotify track id (this or url) Example: "11dFghVXANMlKmJXsNCbNl"
  - url (optional): open.spotify.com track URL or spotify:track: URI (this or id) Example: "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
  - market (optional): ISO 3166-1 alpha-2 country to scope availability (optional) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## status
- GET /v1/status/index (0cr) — params: dry_run — Per-provider health over the last 15 minutes: request counts, error rate, p50/p95 latency and an up/degraded/unknown state per upstream provider.
  Reference: https://www.monocrawl.com/docs/endpoints/status/index.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## target
- GET /v1/target/categories (10cr) — params: dry_run — Target's top-level category tree with node ids for target/category.
  Reference: https://www.monocrawl.com/docs/endpoints/target/categories.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/target/category (2cr) — params: id*, store_id, page, dry_run — Products in a Target category at one store, 24 per page.
  Reference: https://www.monocrawl.com/docs/endpoints/target/category.md
  - id (required): Category node id from target/categories Example: "5xtg6"
  - store_id (optional): Target store id for price and stock Example: "1771"
  - page (optional): Page number (24 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/target/product (2cr) — params: id*, store_id, dry_run — One Target product: title, brand, price, rating and review statistics, description and bullets, images and videos, category breadcrumbs, variations and return policy.
  Reference: https://www.monocrawl.com/docs/endpoints/target/product.md
  - id (required): Target product id (the number after /A- in its URL), or the URL Example: "90848105"
  - store_id (optional): Target store id for price and stock Example: "1771"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/target/reviews (2cr) — params: id*, page, dry_run — Reviews of a Target product, ten per page, with the rating distribution, recommendation rate and photo counts.
  Reference: https://www.monocrawl.com/docs/endpoints/target/reviews.md
  - id (required): Target product id Example: "93747936"
  - page (optional): Page number, from 0 (10 per page) Example: "0"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/target/search (10cr) — params: query*, store_id, page, dry_run — Products matching a keyword at one Target store, 24 per page, with price, rating, images and variations.
  Reference: https://www.monocrawl.com/docs/endpoints/target/search.md
  - query (required): Search keyword Example: "pant"
  - store_id (optional): Target store id (prices and stock are per store; find one with target/stores) Example: "1771"
  - page (optional): Page number (24 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/target/stores (10cr) — params: place*, dry_run — Target stores near a place with store ids, distance, phone, address and today's hours.
  Reference: https://www.monocrawl.com/docs/endpoints/target/stores.md
  - place (required): City, state, ZIP or address Example: "52404"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## telegram
- GET /v1/telegram/channel (2cr) — params: handle*, dry_run — A public channel: name, description, avatar, verification, subscriber and member counts, and photo, video and link counts.
  Reference: https://www.monocrawl.com/docs/endpoints/telegram/channel.md
  - handle (required): Public channel handle without the @ Example: "telegram"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/telegram/channel-posts (2cr) — params: handle*, cursor, dry_run — A channel's posts, one page at a time, with text, time, views, reactions and forwards, plus the channel summary.
  Reference: https://www.monocrawl.com/docs/endpoints/telegram/channel-posts.md
  - handle (required): Public channel handle without the @ Example: "telegram"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/telegram/post (2cr) — params: url*, dry_run — One channel post: text, time, views, reactions, forward origin and media count.
  Reference: https://www.monocrawl.com/docs/endpoints/telegram/post.md
  - url (required): Post URL Example: "https://t.me/telegram/100"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## threads
- GET /v1/threads/post (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One Threads post: text, author, like and reply counts, with a short reply preview.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/post.md
  - url (required): Full Threads post URL. Example: "https://www.threads.net/@zuck/post/C2QBoRaRmR1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/threads/post-comments (7cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The replies bundled with a Threads post: text, like count, reply count and author, paged.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/post-comments.md
  - url (required): Full Threads post URL Example: "https://www.threads.com/@zuck/post/DZpPDXbCeTt"
  - cursor (optional): Page cursor from the previous answer Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/threads/profile (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A Threads account's public profile: bio, follower count and verification.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/profile.md
  - handle (required): Threads username without the @. Example: "zuck"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/threads/search (1cr) — params: query*, start_date, end_date, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search Threads posts by keyword: text, author, like and reply counts.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/search.md
  - query (required): Search term. Example: "coffee"
  - start_date (optional): Earliest post date, YYYY-MM-DD.
  - end_date (optional): Latest post date, YYYY-MM-DD.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/threads/search-users (1cr) — params: query*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Accounts matching a query on Threads: handle, name, verification and avatar.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/search-users.md
  - query (required): Name or handle to search for Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/threads/user-posts (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts from a Threads account: text, like, reply and repost counts.
  Reference: https://www.monocrawl.com/docs/endpoints/threads/user-posts.md
  - handle (required): Threads username without the @. Example: "zuck"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## tiktok
- GET /v1/tiktok/ads-top (1cr) — params: country, period, page, limit, dry_run — Creative Center popular ad selection. Includes public creative assets and source metrics. Cost bucket is not currency or spend; CTR is returned as supplied.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/ads-top.md
  - country (optional): Two-letter uppercase country. Example: "US"
  - period (optional): Source window: 7, 30 or 180 days. Example: "7"
  - page (optional): Page number, 1-100. Example: "1"
  - limit (optional): Requested page size, 1–20 (default 20); the source may return fewer. Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/collection-videos (1cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The videos saved to a public collection, one page at a time, with the same video shape as the rest of the TikTok routes.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/collection-videos.md
  - url (required): Collection URL Example: "https://www.tiktok.com/@tiktok/collection/favorites-7442134949027351314"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/comment (25cr) — params: url*, comment_id*, parent_id, cursor, max_pages, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Bounded comment lookup within a specified post or parent thread. Returns found, comment, comments_scanned, search_complete and next_params. A completed paid scan may return found=false; this does not establish deletion. Each successful fresh scanned page costs at least 5 credits (or the underlying price if higher); failed pages are free and cache hits use their normal lower charge.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/comment.md
  - url (required): Public post or video URL. Example: "https://www.tiktok.com/@mrbeast/video/7654638524729216287"
  - comment_id (required): Exact target comment ID as a string. Example: "7654640784985211670"
  - parent_id (optional): For a reply lookup, the parent comment ID. Otherwise scans top-level comments.
  - cursor (optional): Opaque continuation from the previous response. Preserve query or identity.
  - max_pages (optional): Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/comment-replies (1cr) — params: comment_id*, url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The reply thread under one TikTok comment. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/comment-replies.md
  - comment_id (required): Comment id from tiktok/post-comments. Example: "7623828115408274207"
  - url (required): Full TikTok video URL. Example: "https://www.tiktok.com/@stoolpresidente/video/7623818255903329566"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/effect-videos (1cr) — params: effect_id*, cursor, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public videos made with a TikTok effect, with engagement counts and the author on every row.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/effect-videos.md
  - effect_id (required): The effect id Example: "321535"
  - cursor (optional): Page cursor from the previous answer Example: ""
  - limit (optional): Videos per page, up to 30 Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/effects (1cr) — params: ids*, dry_run — TikTok effects (the camera filters creators apply) by id: name, designer, videos made with it, views and icon.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/effects.md
  - ids (required): One or more effect ids, comma separated, up to ten Example: "321535"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/hashtag (1cr) — params: hashtag*, dry_run — Public hashtag description and counts resolved by exact name on the first search page. A missing exact match does not establish that the tag does not exist. ID-only lookup is not supported.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/hashtag.md
  - hashtag (required): Exact hashtag name, optionally prefixed with #. Example: "fitness"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/hashtags-popular (1cr) — params: country, period, industry, dry_run, countryCode — Anonymous public top-three board by country, window and optional industry. Ranked tags, source posts/views and relative popularity curves. Not the full ranking or live activity; no pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/hashtags-popular.md
  - country (optional): Country: US, FR, DE, IT, ES, GB, AR, AU, BR, CA, CO, EG, ID, IL, JP, KR, MY, MX, PH, SA, SG, ZA, TW, TH, TR, AE or VN. Example: "US"
  - period (optional): 7, 30 or 90 days; default 7. Example: "7"
  - industry (optional): Optional Creative Center industry ID: 10000000000 education; 11000000000 vehicles; 12000000000 baby/kids; 14000000000 beauty; 15000000000 tech; 17000000000 travel; 18000000000 household; 19000000000 pets; 21000000000 home improvement; 22000000000 apparel; 23000000000 news/entertainment; 25000000000 games; 27000000000 food; 28000000000 sports; 29000000000 health. Example: "14000000000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - countryCode (optional): Compatibility alias for country. The canonical parameter takes precedence if both are supplied. Example: "US"
- GET /v1/tiktok/location (1cr) — params: id*, dry_run — One place: name, address, city, country, category and coordinates.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/location.md
  - id (required): Place id from a video's location tag or place URL Example: "22535865202704586"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/location-videos (1cr) — params: id*, cursor, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Videos tagged at a place, with captions, counts, authors and sounds; paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/location-videos.md
  - id (required): Place id from a video's location tag or place URL Example: "22535865202704586"
  - cursor (optional): Cursor from the previous page Example: ""
  - limit (optional): Videos per page, at most 30 Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/playlist-videos (7cr) — params: playlist_id*, limit, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The videos in a TikTok playlist: description, cover, duration, play URL, counts and author, in playlist order.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/playlist-videos.md
  - playlist_id (required): Playlist id from tiktok/user-playlists, or the playlist URL Example: "7681171537575824159"
  - limit (optional): Videos per page, up to 30 Example: "10"
  - cursor (optional): Cursor from a previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/post (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One TikTok video: caption, author, duration and current engagement counts.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/post.md
  - url (required): Full TikTok video URL. Example: "https://www.tiktok.com/@nasa/video/7665075736742530317"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/post-comments (1cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Comments on a TikTok video with like and reply counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/post-comments.md
  - url (required): Full TikTok video URL. Example: "https://www.tiktok.com/@nasa/video/7665075736742530317"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/post-transcript (5cr) — params: url*, dry_run — The spoken words of a TikTok video as text. transcript is null when the video has no captions — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/post-transcript.md
  - url (required): Full TikTok video URL. Example: "https://www.tiktok.com/@nasa/video/7665075736742530317"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/profile (1cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public TikTok profile: identity, bio, follower/like/video counts.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/profile.md
  - handle (required): TikTok username, with or without the leading @. Example: "charlidamelio"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/profile-region (2cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The region an account posts from, resolved from the account itself rather than guessed from its content.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/profile-region.md
  - handle (required): TikTok username without the @ Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/profile-videos (1cr) — params: handle*, cursor, user_id, sort_by, region, max_cursor, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent videos for a TikTok account, newest first, with per-video stats. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/profile-videos.md
  - handle (required): TikTok username without the @. Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - user_id (optional): Numeric TikTok user id, kept as a string. Optional alongside the required handle; can speed up the primary source. This is not a sec_uid. Example: "6659752019493208069"
  - sort_by (optional): latest (newest first, the default) or popular. latest is served by every source; popular is served by the source that can rank by popularity, so a continuation stays on that source. Example: "latest"
  - region (optional): Two-letter country code for the source request location. It can affect availability and ranking; it does not filter creators by residence or audience country. Keep it unchanged when continuing. Example: "GB"
  - max_cursor (optional): Primary-source alias for cursor. Use the previous response cursor unchanged. The canonical cursor parameter takes precedence when both are supplied. Example: "1734562353000"
  - trim (optional): Boolean: true asks the primary source for its trimmed payload; false asks for the full source payload. The public response remains normalized; this is not an instruction to truncate captions. Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/profile/full (2cr) — params: handle*, posts, cursor, include, user_id, sort_by, region, trim, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields are transparent page arithmetic, not SocialCrawl metric-schema equivalence.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/profile/full.md
  - handle (required): Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. Example: "mrbeast"
  - posts (optional): Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. Example: "25"
  - cursor (optional): Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
  - include (optional): CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. Example: "posts,computed"
  - user_id (optional): Exact numeric string, optional alongside handle; numeric ID-only profile lookup is not supported.
  - sort_by (optional): latest or popular, forwarded to the videos component. Example: "latest"
  - region (optional): Two-letter source region, forwarded unchanged. Example: "GB"
  - trim (optional): Source trimming preference; does not permit the bundle to truncate returned records. Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/search (4cr) — params: query*, cursor, region, sort_by, date_posted, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens, limit — Search TikTok videos by keyword, newest-relevant first, with per-video engagement counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/search.md
  - query (required): Search term. Example: "coffee brewing"
  - cursor (optional): Opaque cursor from the previous page.
  - region (optional): Two-letter country code for the source request location. It can affect availability and ranking; it does not filter creators by residence or audience country. Keep it unchanged when continuing. Example: "US"
  - sort_by (optional): relevance (default) or most-liked.
  - date_posted (optional): Restrict by post date, e.g. past-week.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
  - limit (optional): Optional requested distinct results, 1–120. Collection stops at the existing request spending and time limits, so fewer may be returned. Inspect partial, window_stop_reason and pages_fetched. Keep query, region, sort, dates and limit unchanged with the opaque cursor. Omit for one native page. Example: "120"
- GET /v1/tiktok/search-hashtag (1cr) — params: hashtag*, cursor, region, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Videos posted under a TikTok hashtag with engagement counts. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/search-hashtag.md
  - hashtag (required): Hashtag without the #. Example: "coffee"
  - cursor (optional): Opaque cursor from the previous page.
  - region (optional): Two-letter country code for the source request location. It can affect availability and ranking; it does not filter creators by residence or audience country. Keep it unchanged when continuing. Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/search-music (1cr) — params: query*, limit, cursor, region, dry_run — TikTok sounds matching a keyword: title, artist, duration, cover, a preview URL and how many videos use each.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/search-music.md
  - query (required): Search words Example: "espresso"
  - limit (optional): Sounds per page, up to 20 Example: "20"
  - cursor (optional): Page cursor from the previous answer Example: ""
  - region (optional): Two-letter region Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/search-top (1cr) — params: query*, publish_time, sort_by, region, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The top tab of a TikTok search: the videos TikTok ranks first for a query, as the standard video shape.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/search-top.md
  - query (required): Search query Example: "james webb telescope"
  - publish_time (optional): Restrict to a publish window when supported Example: ""
  - sort_by (optional): Sort order when supported Example: ""
  - region (optional): Two-letter region Example: "US"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/search-users (2cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search TikTok accounts by keyword. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/search-users.md
  - query (required): Search term. Example: "space"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/song (1cr) — params: id*, dry_run — One TikTok sound: title, artists, duration and how many videos use it — the id feeds tiktok/song-videos.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/song.md
  - id (required): TikTok sound/clip id. Example: "7439295283975702544"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/song-videos (1cr) — params: id*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Videos that use a specific TikTok sound — sound-trend intelligence. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/song-videos.md
  - id (required): TikTok sound/clip id. Example: "7439295283975702544"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/suggestions (2cr) — params: query*, region, dry_run — What TikTok suggests as you type a query, in order, with the language and score of each suggestion.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/suggestions.md
  - query (required): Partial query to complete Example: "space"
  - region (optional): Two-letter region for the suggestions Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/trending (4cr) — params: region*, dry_run — TikTok's trending feed for a region — what is going viral right now, with per-video stats.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/trending.md
  - region (required): Two-letter region code. Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/user-audience (91cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Where an account's audience is: the countries its viewers come from, with counts and percentages.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-audience.md
  - handle (required): TikTok username without the @ Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/user-followers (1cr) — params: handle*, user_id, cursor, dry_run — An account's followers with per-user follower counts. Paged by min_time cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-followers.md
  - handle (required): TikTok username without the @ (or pass user_id). Example: "stoolpresidente"
  - user_id (optional): Numeric user id — alternative to handle.
  - cursor (optional): min_time value from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/user-following (1cr) — params: handle*, cursor, dry_run — The accounts a TikTok user follows. Paged by min_time cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-following.md
  - handle (required): TikTok username without the @. Example: "stoolpresidente"
  - cursor (optional): min_time value from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok/user-liked-videos (1cr) — params: handle, sec_uid, cursor, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Videos an account has liked, when it shows its likes publicly; empty otherwise. Same video shape as the profile-videos route.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-liked-videos.md
  - handle (optional): TikTok username without the @ (or pass sec_uid) Example: "tiktok"
  - sec_uid (optional): The account's secUid — alternative to handle Example: ""
  - cursor (optional): Cursor from the previous page Example: ""
  - limit (optional): Videos per page, at most 35 Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/user-live (2cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Whether an account is live right now and, when it is, the room: title, cover, start time and viewer counts.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-live.md
  - handle (required): TikTok username without the @ Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/user-playlists (1cr) — params: handle, sec_uid, cursor, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The playlists a creator has published: name, video count, cover and URL; paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-playlists.md
  - handle (optional): TikTok username without the @ (or pass sec_uid) Example: "tiktok"
  - sec_uid (optional): The account's secUid — alternative to handle Example: ""
  - cursor (optional): Cursor from the previous page Example: ""
  - limit (optional): Playlists per page, at most 35 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/user-reposts (1cr) — params: handle, sec_uid, cursor, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Videos an account has reposted, newest first; paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/user-reposts.md
  - handle (optional): TikTok username without the @ (or pass sec_uid) Example: "tiktok"
  - sec_uid (optional): The account's secUid — alternative to handle Example: ""
  - cursor (optional): Cursor from the previous page Example: ""
  - limit (optional): Videos per page, at most 35 Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tiktok/videos-popular (1cr) — params: country, period, sort, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens, countryCode — Anonymous public top-four recent-video board. Source-period and lifetime views, organic views, engagement and six-second view rate, with creators. May include sponsored content. Not the full ranking; no likes/comments/shares are supplied.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok/videos-popular.md
  - country (optional): US, JP, VN, TH or ID. Example: "US"
  - period (optional): 7 or 30 days; recent-creation board. Source period end is returned. Example: "7"
  - sort (optional): views, engagement or six_second_views. Example: "views"
  - limit (optional): 1–4, default 4. Public anonymous sample only; no pagination. Example: "4"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
  - countryCode (optional): Compatibility alias for country. The canonical parameter takes precedence if both are supplied. Example: "US"
## tiktok_ads
- GET /v1/tiktok_ads/ad (4cr) — params: id*, dry_run — One TikTok ad from the creative center: title, advertiser account, objective, landing page, engagement metrics and video where disclosed.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok_ads/ad.md
  - id (required): Ad id from tiktok_ads/search. Example: "1874784102494897"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktok_ads/search (4cr) — params: query*, advertiser, cursor, dry_run — Search TikTok's public Ads Library by keyword or advertiser: ad id, advertiser, run dates, audience and spend bands, creative media. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktok_ads/search.md
  - query (required): Keyword (or pass advertiser for advertiser-specific results). Example: "gymshark"
  - advertiser (optional): Advertiser name — resolved through TikTok typeahead first. Example: "Gymshark"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## tiktokshop
- GET /v1/tiktokshop/creator-showcase (2cr) — params: handle*, region, cursor, dry_run — The products a TikTok creator promotes in their public showcase — creator-commerce intelligence. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktokshop/creator-showcase.md
  - handle (required): TikTok username without the @. Example: "mrtiktokreviews"
  - region (optional): Two-letter region code.
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktokshop/product (2cr) — params: url*, region, dry_run — One TikTok Shop product: title, price, images, sold count, rating and review count, categories, seller and SKUs.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktokshop/product.md
  - url (required): Product URL Example: "https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799"
  - region (optional): Storefront region (US is the reliable one today) Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktokshop/product-reviews (2cr) — params: url*, product_id, region, cursor, dry_run — Reviews for a TikTok Shop product: rating, text, reviewer, SKU, verified-purchase and incentivized flags, with the product's rating summary.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktokshop/product-reviews.md
  - url (required): Product page URL (or pass product_id). Example: "https://www.tiktok.com/shop/pdp/1732195276672373419"
  - product_id (optional): Product id — alternative to url.
  - region (optional): Two-letter region code.
  - cursor (optional): Page number, starting at 1.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktokshop/search (2cr) — params: query*, cursor, region, dry_run — Search TikTok Shop products: title, image, price, units sold, rating and shop. Paged by page-number cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktokshop/search.md
  - query (required): What to search for. Example: "shoes"
  - cursor (optional): Page number, starting at 1.
  - region (optional): Two-letter region code. Example: "US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tiktokshop/shop-products (2cr) — params: url*, sort_by, region, cursor, dry_run — Every product a TikTok Shop store lists, with prices, sales counts and ratings. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/tiktokshop/shop-products.md
  - url (required): TikTok Shop store URL Example: "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"
  - sort_by (optional): top or new_releases (default top) Example: "top"
  - region (optional): Two-letter region code (default US) Example: "US"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## tripadvisor
- GET /v1/tripadvisor/attraction (3cr) — params: id*, dry_run — An attraction page in full: rating and review count, ranking in its destination, opening hours, description, address and coordinates, website and phone, photos, nearby places, the rating histogram and the latest reviews.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/attraction.md
  - id (required): Attraction id (the -d number in its URL) or the page URL Example: "1451754"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/attraction/reviews (2cr) — params: url*, limit, sort, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a attraction. Queued extraction; retrying the same inputs resumes the saved task. Up to twenty reviews, no cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/attraction/reviews.md
  - url (required): The full attraction review-page URL Example: "https://www.tripadvisor.com/Attraction_Review-g60763-d105127-Reviews-Central_Park-New_York_City_New_York.html"
  - limit (optional): 1 to 20 reviews; default 10. First page only. Example: "10"
  - sort (optional): most_recent or detailed_reviews Example: "most_recent"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tripadvisor/attractions (1cr) — params: geo_id, query, start_date, end_date, sort, page, adults, currency, language, dry_run — Attractions in a place, thirty per page, with rating, review count, category, ticket price, badges and photo.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/attractions.md
  - geo_id (optional): Place geo id from tripadvisor/autocomplete Example: "1954828"
  - query (optional): Place name, resolved to a geo id when geo_id is absent Example: "Walt Disney World"
  - start_date (optional): Visit start (YYYY-MM-DD); defaults to a week ahead Example: "2026-10-01"
  - end_date (optional): Visit end Example: "2026-10-03"
  - sort (optional): Sort name from a previous response Example: "TRAVELER_FAVORITE_V2"
  - page (optional): Page of 30 Example: "1"
  - adults (optional): Adults Example: "1"
  - currency (optional): Currency code Example: "USD"
  - language (optional): Language code Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/autocomplete (1cr) — params: query*, language, dry_run — Places and properties matching a name, with the geo id the hotel, restaurant and attraction searches take.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/autocomplete.md
  - query (required): A place or property name Example: "London"
  - language (optional): Language code Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/cruise (2cr) — params: url, ship_id, ship_name, dry_run — A cruise ship page: name, image, average rating and review count with the rating histogram, passengers, crew, passenger-to-crew and passenger-to-space ratios, launch year, cabin types and sizes, photo categories, whether itineraries are listed, and the newest reviews on the page. Re-wired 6 Sep 2026 on the platform's own reader (migration 191).
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/cruise.md
  - url (optional): The ship page URL (Cruise_Review-d<id>-Reviews-<name>). Send this, or ship_id with ship_name. Example: "https://www.tripadvisor.com/Cruise_Review-d15691709-Reviews-Pearl_Mist"
  - ship_id (optional): Ship id (the number after d in the page URL, as tripadvisor/cruises gives it) Example: "15691709"
  - ship_name (optional): The ship name as it appears in the page URL Example: "Pearl Mist"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/cruise-reviews (2cr) — params: url, ship_id, ship_name, page, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a cruise ship, five a page, newest first (id, link, title, text, bubble rating, month written, author with location, contributions and helpful votes, photo count), with the ship's total review count, page count, rating histogram and a cursor to the next page. Re-wired 6 Sep 2026 on the platform's own reader (migrations 191 and 194).
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/cruise-reviews.md
  - url (optional): The ship page URL. Send this, or ship_id with ship_name. Example: "https://www.tripadvisor.com/Cruise_Review-d15691709-Reviews-Pearl_Mist"
  - ship_id (optional): Ship id (the number after d in the page URL) Example: "15691709"
  - ship_name (optional): The ship name as it appears in the page URL Example: "Pearl Mist"
  - page (optional): Page number, five reviews a page (default 1); the previous answer's cursor is the next page number Example: "2"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tripadvisor/cruises (1cr) — params: destination_id, destination, sort, month, page, currency, dry_run — Cruises sailing a region, twenty per page, with ship, line, ports, itinerary, sailings and the ship's rating; without a destination, the list of regions.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/cruises.md
  - destination_id (optional): Cruise region id (147237 is the Caribbean); the region directory upstream is unreliable, so prefer the id Example: "147237"
  - destination (optional): Region name, matched against the directory when it answers Example: ""
  - sort (optional): popularity, departure_date, price, length or ship Example: "popularity"
  - month (optional): Departure month, YYYY-MM Example: ""
  - page (optional): Page number (20 per page) Example: "1"
  - currency (optional): Currency code Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/experience-types (3cr) — params: query*, geo_id, dry_run — The experience types a destination offers (Spas & Wellness, Boat Tours & Water Sports, …) with how many attractions fall under each, plus the good-for, duration, traveler-rating and award facets.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/experience-types.md
  - query (required): Destination name Example: "Nha Trang"
  - geo_id (optional): Destination geo id; skips the name lookup Example: "293928"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/hotel (1cr) — params: id*, check_in, check_out, adults, rooms, currency, language, dry_run — One hotel's page: rating, review count, city ranking, description, languages, amenities, address, coordinates, neighbourhood, transport and photos.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/hotel.md
  - id (required): Hotel id from tripadvisor/hotels, or its page URL Example: "23448880"
  - check_in (optional): Check-in date; defaults to a week ahead Example: "2026-10-01"
  - check_out (optional): Check-out date Example: "2026-10-03"
  - adults (optional): Adults per room Example: "2"
  - rooms (optional): Rooms Example: "1"
  - currency (optional): Currency code Example: "USD"
  - language (optional): Language code Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/hotels (2cr) — params: query, country, location, location_code, limit, dry_run — Discover up to thirty hotels in a city, with ratings and review counts. Hotel directory only: no stay availability, nightly prices, images, price filters or pagination. Queued searches reuse the saved task when retried.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/hotels.md
  - query (optional): City name, optionally followed by region and country. Required unless location or location_code is supplied. q is an alias. Paris, London and New York default to France, UK and US respectively; country overrides this. Example: "Paris"
  - country (optional): Two-letter country code to disambiguate a city. Example: "FR"
  - location (optional): Explicit city and country; must agree with query if both are supplied. Example: "Paris,France"
  - location_code (optional): Search location code, not a Tripadvisor geo_id. Prefer a city name. Example: "1006094"
  - limit (optional): 1 to 30 hotels; default 30. First page only. Example: "30"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/location (5cr) — params: query*, location, dry_run — The best TripAdvisor match for a place name, with its page path for the reviews route. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/location.md
  - query (required): Place name Example: "The Balmoral Edinburgh"
  - location (optional): Location name Example: "Edinburgh,Scotland,United Kingdom"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/place (1cr) — params: url*, language, currency, dry_run — Any TripAdvisor hotel, restaurant or attraction page resolved to its record: the same fields as tripadvisor/hotel, tripadvisor/restaurant or tripadvisor/attraction, with kind saying which.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/place.md
  - url (required): A TripAdvisor hotel, restaurant or attraction page URL Example: "https://www.tripadvisor.com/Restaurant_Review-g1954828-d27717696"
  - language (optional): Interface language Example: "en_US"
  - currency (optional): Currency code Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/restaurant (1cr) — params: id*, language, currency, dry_run — One restaurant's page: rating, review count, city ranking, cuisines, price range, opening hours, description, address, coordinates, neighbourhood, transport, contact links and photos.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/restaurant.md
  - id (required): Restaurant id from tripadvisor/restaurants, or its page URL Example: "28627898"
  - language (optional): Interface language Example: "en_US"
  - currency (optional): Currency code Example: "USD"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/restaurant/reviews (2cr) — params: url*, limit, sort, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a restaurant. Queued extraction; retrying the same inputs resumes the saved task. Up to twenty reviews, no cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/restaurant/reviews.md
  - url (required): The full restaurant review-page URL Example: "https://www.tripadvisor.com/Restaurant_Review-g187147-d14039269-Reviews-Can_Alegria_Paris-Paris_Ile_de_France.html"
  - limit (optional): 1 to 20 reviews; default 10. First page only. Example: "10"
  - sort (optional): most_recent or detailed_reviews Example: "most_recent"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tripadvisor/restaurants (1cr) — params: geo_id, query, sort, filters, page, cursor, currency, language, dry_run — Restaurants in a place, thirty per page, with rating, review count, price range, cuisines, opening status, photo and ordering link.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/restaurants.md
  - geo_id (optional): Place geo id from tripadvisor/autocomplete Example: "1954828"
  - query (optional): Place name, resolved to a geo id when geo_id is absent Example: "Walt Disney World"
  - sort (optional): POPULARITY, RELEVANCE or FEATURED Example: "POPULARITY"
  - filters (optional): Filter expression from a previous response Example: ""
  - page (optional): Page of 30 Example: "1"
  - cursor (optional): Cursor from the previous page Example: ""
  - currency (optional): Currency code Example: "USD"
  - language (optional): Language code Example: "en_US"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/tripadvisor/reviews (5cr) — params: url*, sort, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a TripAdvisor place with rating, title, text, date and any reply. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/reviews.md
  - url (required): The TripAdvisor page URL or path Example: "https://www.tripadvisor.com/Hotel_Review-g186525-d190819-Reviews-The_Balmoral_Hotel-Edinburgh_Scotland.html"
  - sort (optional): newest or relevance Example: "newest"
  - limit (optional): Reviews, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/tripadvisor/search (5cr) — params: query*, location, limit, dry_run — Hotels, restaurants and attractions on TripAdvisor matching a query, with rating and review count. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/tripadvisor/search.md
  - query (required): Search terms Example: "hotel Edinburgh"
  - location (optional): Location name Example: "Edinburgh,Scotland,United Kingdom"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## trustpilot
- GET /v1/trustpilot/categories (3cr) — params: query*, locale, dry_run — Trustpilot categories matching a keyword, with the ids the category routes take.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/categories.md
  - query (required): Category name or keyword Example: "bank"
  - locale (optional): Site locale Example: "en-GB"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/trustpilot/category (3cr) — params: id*, locale, dry_run — One Trustpilot category with its company count, parent, subcategories and siblings.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/category.md
  - id (required): Category id from trustpilot/categories Example: "bank"
  - locale (optional): Site locale Example: "en-GB"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/trustpilot/category-companies (3cr) — params: id*, sort, min_rating, country, city, page, locale, dry_run — The companies in a Trustpilot category — ranked, recently reviewed or newest — with rating, review count and location.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/category-companies.md
  - id (required): Category id from trustpilot/categories Example: "bank"
  - sort (optional): default (ranked), recent (recently reviewed) or newest Example: "recent"
  - min_rating (optional): any, 3, 4 or 4.5 Example: "4"
  - country (optional): Two-letter country code Example: "GB"
  - city (optional): City or postcode Example: "London"
  - page (optional): Page of 20 (ranked list only) Example: "1"
  - locale (optional): Site locale Example: "en-GB"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/trustpilot/company (7cr) — params: domain*, dry_run — A company's Trustpilot profile by domain: rating, review count, categories and claimed status. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/company.md
  - domain (required): The company's domain Example: "monzo.com"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/trustpilot/consumer (3cr) — params: id*, locale, dry_run — A Trustpilot reviewer's public profile: country, verification, review, like and read counts.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/consumer.md
  - id (required): Reviewer id from a review Example: "57320f590000ff000a1ee003"
  - locale (optional): Site locale Example: "en-GB"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/trustpilot/consumer-reviews (3cr) — params: id*, page, locale, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Every review one Trustpilot reviewer has written, with the company each one is about.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/consumer-reviews.md
  - id (required): Reviewer id from a review Example: "57320f590000ff000a1ee003"
  - page (optional): Page of 20 Example: "1"
  - locale (optional): Site locale Example: "en-GB"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/trustpilot/reviews (5cr) — params: domain*, sort, limit, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Reviews of a company on Trustpilot with rating, title, text, date, reviewer location and any company reply. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/reviews.md
  - domain (required): The company's domain Example: "monzo.com"
  - sort (optional): recency or relevance Example: "recency"
  - limit (optional): Reviews, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/trustpilot/search (5cr) — params: query*, limit, dry_run — Businesses on Trustpilot matching a query with domain, rating, review count and categories. Queued task.
  Reference: https://www.monocrawl.com/docs/endpoints/trustpilot/search.md
  - query (required): Business name or keywords Example: "monzo"
  - limit (optional): Results, up to 100 Example: "20"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## truthsocial
- GET /v1/truthsocial/post (2cr) — params: url*, dry_run — One post with its counts and its author's profile.
  Reference: https://www.monocrawl.com/docs/endpoints/truthsocial/post.md
  - url (required): Post URL Example: "https://truthsocial.com/@realDonaldTrump/posts/110000000000000000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/truthsocial/posts (2cr) — params: handle*, user_id, cursor, dry_run — A user's posts, newest first, one page at a time, with reply, reblog, favourite, upvote and downvote counts.
  Reference: https://www.monocrawl.com/docs/endpoints/truthsocial/posts.md
  - handle (required): Username (or pass user_id) Example: "realDonaldTrump"
  - user_id (optional): Account id, instead of handle Example: "107780257626128497"
  - cursor (optional): Opaque cursor from the previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/truthsocial/profile (2cr) — params: handle*, dry_run — A Truth Social account's public profile: followers, post count, verification and bio.
  Reference: https://www.monocrawl.com/docs/endpoints/truthsocial/profile.md
  - handle (required): Truth Social username without the @. Example: "realDonaldTrump"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## twitch
- GET /v1/twitch/clip (2cr) — params: url*, dry_run — Fetch a single Twitch clip from its URL: title, broadcaster, creator, game, duration, view count and thumbnail.
  Reference: https://www.monocrawl.com/docs/endpoints/twitch/clip.md
  - url (required): Twitch clip URL (clips.twitch.tv/<slug>, twitch.tv/<channel>/clip/<slug>) or a bare clip slug Example: "https://clips.twitch.tv/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/twitch/profile (2cr) — params: handle*, dry_run — A Twitch channel: followers, partner status, live state and current viewers.
  Reference: https://www.monocrawl.com/docs/endpoints/twitch/profile.md
  - handle (required): Twitch login name. Example: "ishowspeed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/twitch/user/schedule (2cr) — params: handle*, dry_run — A channel schedule snapshot with dated stream segments and any vacation window. Recurrence may be unavailable.
  Reference: https://www.monocrawl.com/docs/endpoints/twitch/user/schedule.md
  - handle (required): Twitch login name (the channel username) Example: "emongg"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/twitch/user/videos (2cr) — params: handle*, filter_by, sort_by, limit, cursor, dry_run — A channel video snapshot with view counts and durations. The returned cursor continues within available source results; it does not promise an unlimited archive.
  Reference: https://www.monocrawl.com/docs/endpoints/twitch/user/videos.md
  - handle (required): Twitch login name (the channel username) Example: "ishowspeed"
  - filter_by (optional): Video type: all (default), upload, archive, highlight Example: "archive"
  - sort_by (optional): Sort order: time (default) or views Example: "time"
  - limit (optional): Videos per page, 1-100 (default 25) Example: "25"
  - cursor (optional): Opaque pagination cursor from a previous page Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## utility
- GET /v1/utility/endpoint (0cr) — params: id, url, method, dry_run — Full documentation for one endpoint — parameters, credit cost, auth header, and a ready-to-paste curl example.
  Reference: https://www.monocrawl.com/docs/endpoints/utility/endpoint.md
  - id (optional): Endpoint id as platform/endpoint (or a /v1 path) Example: "github/user"
  - url (optional): Full endpoint URL as an alternative to id Example: "https://www.monocrawl.com/v1/github/user"
  - method (optional): Ignored — all Monocrawl endpoints are GET Example: "GET"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/utility/endpoints (0cr) — params: platform, search, method, dry_run — The live endpoint catalogue: every callable endpoint with its credit cost, parameters and description. Filter by platform, free-text search, or method.
  Reference: https://www.monocrawl.com/docs/endpoints/utility/endpoints.md
  - platform (optional): Only endpoints for this platform Example: "reddit"
  - search (optional): Case-insensitive text match on id, name and description Example: "comments"
  - method (optional): HTTP method filter (all Monocrawl endpoints are GET) Example: "GET"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/utility/llms (0cr) — params: platform, format, dry_run — Agent-ready context payload: base URL, auth header, envelope and error model, plus the compact endpoint catalogue grouped by platform.
  Reference: https://www.monocrawl.com/docs/endpoints/utility/llms.md
  - platform (optional): Limit the catalogue to one platform Example: "reddit"
  - format (optional): markdown (default) or json Example: "markdown"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/utility/quickstart (0cr) — params: platform, dry_run — Get started in one call: the cheapest live endpoint for a platform, a copy-paste curl, and a sketch of the response envelope you will get back.
  Reference: https://www.monocrawl.com/docs/endpoints/utility/quickstart.md
  - platform (optional): Platform to start with; omit for the cheapest live endpoint overall Example: "reddit"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## vinted
- GET /v1/vinted/item (1cr) — params: id*, market, dry_run — One item with its description, photos, asking price, fees where supplied, brand, size, condition and seller identifier. Missing optional values remain unknown.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/item.md
  - id (required): Numeric identifier from a parent result. Example: "10062088255"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/price-suggestions (1cr) — params: category_id*, brand_id*, condition_id*, market, dry_run — Suggested asking-price range for a category, brand and condition in France. Guidance, not a guaranteed selling price.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/price-suggestions.md
  - category_id (required): Category identifier from an item. Example: "1824"
  - brand_id (required): Brand identifier from an item. Example: "10"
  - condition_id (required): Condition identifier from an item. Example: "1"
  - market (optional): Currently fr only; default fr. Example: "fr"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/search (1cr) — params: query*, market, min_price, max_price, limit, cursor, dry_run — Search second-hand items with prices, currencies, photos, brand, size, condition and seller identifiers. Uses cursor pagination; prices are asking prices.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/search.md
  - query (required): Search text. Example: "Levis 501"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - min_price (optional): Minimum item asking price. Example: "10"
  - max_price (optional): Maximum item asking price. Example: "50"
  - limit (optional): Results per page, 1 to 50. Keep unchanged between pages. Example: "10"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/search-by-image (1cr) — params: image_url*, market, limit, cursor, dry_run — Find visually related items from a Vinted item image. Similarity confidence scores are not supplied.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/search-by-image.md
  - image_url (required): HTTPS images*.vinted.net image URL from an item result. Example: ""
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - limit (optional): Results per page, 1 to 50. Keep unchanged between pages. Example: "10"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/seller (1cr) — params: id*, market, dry_run — Public seller profile, location, feedback counts and reputation, listing counts and follower counts where available.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/seller.md
  - id (required): Numeric identifier from a parent result. Example: "3154597880"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/seller-feedback (1cr) — params: id*, market, limit, cursor, dry_run — Public seller feedback with text, ratings, dates and item identifiers.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/seller-feedback.md
  - id (required): Numeric identifier from a parent result. Example: "3154597880"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - limit (optional): Results per page, 1 to 50. Keep unchanged between pages. Example: "10"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/seller-items (1cr) — params: id*, market, limit, cursor, dry_run — Items listed by a public seller, with prices, images and continuation.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/seller-items.md
  - id (required): Numeric identifier from a parent result. Example: "3154597880"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - limit (optional): Results per page, 1 to 50. Keep unchanged between pages. Example: "10"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/vinted/sold-comparables (1cr) — params: category_id*, brand_id*, condition_id*, market, dry_run — Comparable items reported as sold, with displayed prices and images. These amounts are not verified final negotiated transaction values.
  Reference: https://www.monocrawl.com/docs/endpoints/vinted/sold-comparables.md
  - category_id (required): Category identifier from an item. Example: "1824"
  - brand_id (required): Brand identifier from an item. Example: "10"
  - condition_id (required): Condition identifier from an item. Example: "1"
  - market (optional): Market: gb or fr. Default gb. Example: "gb"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## walmart
- GET /v1/walmart/category (3cr) — params: category_id*, page, sort_by, min_price, max_price, zip_code, store_id, country, dry_run — Products listed in a Walmart category with price, rating, review count, image, availability and seller, paged.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/category.md
  - category_id (required): A Walmart category id Example: "3944"
  - page (optional): Page number Example: "1"
  - sort_by (optional): best_match, price_low, price_high, best_seller or top_rated Example: "best_match"
  - min_price (optional): Minimum price Example: ""
  - max_price (optional): Maximum price Example: ""
  - zip_code (optional): ZIP code for local availability Example: ""
  - store_id (optional): Store id Example: ""
  - country (optional): us or ca Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/offers (2cr) — params: product_id*, country, dry_run — Every seller offering a Walmart item: seller, price, stock, condition, shipping and pickup, return policy.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/offers.md
  - product_id (required): A Walmart item id or product URL Example: "609040889"
  - country (optional): us or ca Example: "us"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/product (3cr) — params: id*, dry_run — One Walmart product: title, brand, price and savings, rating and review counts, seller, category path, description, highlights, specifications and images.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/product.md
  - id (required): Walmart item id (the number after /ip/ in its URL), or the URL Example: "6138924168"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/reviews (3cr) — params: id*, page, dry_run — Reviews of a Walmart product, ten per page, with the rating distribution.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/reviews.md
  - id (required): Walmart item id Example: "265952442"
  - page (optional): Page number (10 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/rollbacks (10cr) — params: page, dry_run — Products currently on rollback (marked-down) at Walmart, with the old and new prices.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/rollbacks.md
  - page (optional): Page number (about 40 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/search (3cr) — params: query*, page, sort, dry_run — Products matching a keyword, forty per page, with price, rating, seller and availability.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/search.md
  - query (required): Search keyword Example: "mobile"
  - page (optional): Page number (40 per page) Example: "1"
  - sort (optional): best_match, price_low, price_high or best_seller Example: "best_match"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/seller (10cr) — params: id*, dry_run — One Walmart marketplace seller: contact details, address, rating summary and distribution.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/seller.md
  - id (required): Catalog seller id from a product Example: "8026"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/walmart/seller-reviews (10cr) — params: id*, page, dry_run — Reviews of a Walmart marketplace seller, ten per page, each naming the product bought.
  Reference: https://www.monocrawl.com/docs/endpoints/walmart/seller-reviews.md
  - id (required): Catalog seller id from a product Example: "8026"
  - page (optional): Page number (10 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## wayfair
- GET /v1/wayfair/reviews (3cr) — params: id*, page, sort, star, domain, dry_run — Shopper reviews of a product: rating, text, date, verified buyer and photos.
  Reference: https://www.monocrawl.com/docs/endpoints/wayfair/reviews.md
  - id (required): Wayfair SKU, or the product URL Example: "W003078383"
  - page (optional): Page number Example: "1"
  - sort (optional): relevance, date or rating Example: "relevance"
  - star (optional): Keep one star rating only Example: ""
  - domain (optional): Storefront: com, ca, co.uk or de Example: "com"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## web
- GET /v1/web/agent (10cr) — params: url*, prompt*, max_steps, dry_run — Start an asynchronous browser agent: a hosted browser opens the page and the platform's model chooses navigate, click, type or done for up to eight steps. Returns a job; poll /v1/web/jobs/{job_id} for the final page, the extracted answer and every step taken.
  Reference: https://www.monocrawl.com/docs/endpoints/web/agent.md
  - url (required): Page to start from (http/https) Example: "https://www.gov.uk/bank-holidays"
  - prompt (required): What the agent should do or find (up to 2,000 characters) Example: "Find the date of the next bank holiday in England and Wales"
  - max_steps (optional): Most actions to take, 1 to 8 (default 8) Example: "6"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/batch-scrape (3cr) — params: urls*, formats, only_main_content, dry_run — Scrape up to 25 URLs in one background job and get a job id back immediately; individual URL failures are reported per item and never fail the batch.
  Reference: https://www.monocrawl.com/docs/endpoints/web/batch-scrape.md
  - urls (required): Comma-separated list or JSON array of URLs to scrape (max 25 per job) Example: "https://example.com,https://www.iana.org"
  - formats (optional): Comma-separated subset of markdown,text,links (default markdown) Example: "markdown"
  - only_main_content (optional): Render only the main content region of each page (default true) Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/crawl (5cr) — params: url*, limit, max_depth, include_paths, exclude_paths, formats, only_main_content, dry_run — Start a breadth-first same-site crawl and get a job id back immediately; poll /v1/web/jobs/{job_id} for the collected pages (url, title, markdown excerpt, status).
  Reference: https://www.monocrawl.com/docs/endpoints/web/crawl.md
  - url (required): Seed URL to crawl (http/https, public hosts only) Example: "https://example.com"
  - limit (optional): Maximum pages to fetch (default 10, cap 50) Example: "10"
  - max_depth (optional): Link hops from the seed page (default 2, cap 3) Example: "2"
  - include_paths (optional): Comma-separated glob patterns; a discovered path must match at least one. * matches any characters, ^ and $ anchor, everything else is literal Example: "^/blog/.*"
  - exclude_paths (optional): Comma-separated glob patterns; a discovered path matching any of them is skipped Example: "/tag/*,/author/*"
  - formats (optional): Comma-separated subset of markdown,text,links (default markdown) Example: "markdown"
  - only_main_content (optional): Render only the main content region of each page (default true) Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/extract (2cr) — params: url*, timeout, fetch_mode, dry_run — Deterministic structured extraction from a public page: meta/Open Graph/Twitter tags, parsed JSON-LD blocks, canonical URL, feeds, and heading outline — no AI involved. Fetch modes: direct by default; browser, enhanced and rendered are deployment-gated and off by default. Requested output shapes are unchanged. An unavailable non-direct mode returns 424 rather than silently ignoring the requested mode.
  Reference: https://www.monocrawl.com/docs/endpoints/web/extract.md
  - url (required): Page URL to extract from (http/https, public hosts only) Example: "https://example.com"
  - timeout (optional): Fetch budget in milliseconds, clamped to 1000-15000 Example: "10000"
  - fetch_mode (optional): Fetch mode: direct (default) reads static HTML; browser explicitly runs JavaScript in an owned, isolated browser. Enhanced and rendered try direct first and permit configured fallbacks. Non-direct modes require deployment enablement, an approved target and applicable resource or spending limits; otherwise the request is refused. Output formats are unchanged. Example: "direct"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/jobs (0cr) — params: limit, cursor, status, dry_run — List your asynchronous jobs, newest first, with keyset pagination. Free.
  Reference: https://www.monocrawl.com/docs/endpoints/web/jobs.md
  - limit (optional): Jobs per page (default 25, cap 100) Example: "25"
  - cursor (optional): Opaque cursor from the previous page; omit for the first page Example: ""
  - status (optional): Filter by status: queued, running, completed, failed, cancelled (comma-separated for several) Example: "completed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/jobs/cancel (0cr) — params: job_id*, dry_run — Cancel one of your queued or running jobs. A queued job is refunded in full; a running job stops but its charge stands, because upstream work had already begun.
  Reference: https://www.monocrawl.com/docs/endpoints/web/jobs/cancel.md
  - job_id (required): Job id returned by /v1/web/crawl or /v1/web/batch-scrape Example: "job_0123456789abcdef01234567"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/jobs/get (0cr) — params: job_id*, dry_run — Fetch one of your jobs by id: status, progress, the result payload once it completes, and the error if it failed. Free.
  Reference: https://www.monocrawl.com/docs/endpoints/web/jobs/get.md
  - job_id (required): Job id returned by /v1/web/crawl or /v1/web/batch-scrape Example: "job_0123456789abcdef01234567"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/map (3cr) — params: url*, search, limit, sitemap, include_subdomains, ignore_query_parameters, dry_run — Discover a site's URLs from its sitemap.xml (one level of sitemap indexes) with same-origin page links as fallback.
  Reference: https://www.monocrawl.com/docs/endpoints/web/map.md
  - url (required): Site URL to map (http/https, public hosts only) Example: "https://example.com"
  - search (optional): Only return URLs containing this text (case-insensitive) Example: "blog"
  - limit (optional): Maximum URLs to return (default 100, cap 500) Example: "100"
  - sitemap (optional): Sitemap use: include (default: sitemap first, page links as fallback), only, or skip Example: "include"
  - include_subdomains (optional): Also include URLs on subdomains of the site Example: "false"
  - ignore_query_parameters (optional): Strip query strings before deduplicating URLs Example: "false"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/parse (2cr) — params: url*, timeout, dry_run — Fetch a document by URL and extract its text and metadata: PDF (page count, title/author, text from uncompressed and FlateDecode streams), HTML, plain text, Markdown, CSV/TSV (columns, row count, sample rows), JSON (top-level shape) and XML. Returns text = null with a stated reason for encrypted, scanned or image-only PDFs rather than inventing content; Office formats, images and archives are refused with a 422 naming the supported list.
  Reference: https://www.monocrawl.com/docs/endpoints/web/parse.md
  - url (required): URL of the document to parse (http/https, public hosts only). Supported: PDF, HTML, plain text, Markdown, CSV/TSV, JSON, XML. Example: "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"
  - timeout (optional): Fetch budget in milliseconds, clamped to 1000-15000 Example: "10000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/scrape (2cr) — params: url*, formats, only_main_content, timeout, fetch_mode, dry_run — Fetch a public web page and return its content as markdown, text, raw HTML, links, and/or page metadata. Fetch modes: direct by default; browser, enhanced and rendered are deployment-gated and off by default. Requested output shapes are unchanged. An unavailable non-direct mode returns 424 rather than silently ignoring the requested mode.
  Reference: https://www.monocrawl.com/docs/endpoints/web/scrape.md
  - url (required): Page URL to scrape (http/https, public hosts only) Example: "https://example.com"
  - formats (optional): Comma-separated subset of markdown,html,text,links,metadata (default markdown,metadata) Example: "markdown,metadata"
  - only_main_content (optional): Strip page chrome (nav/header/footer/aside) and return the main content region (default true) Example: "true"
  - timeout (optional): Fetch budget in milliseconds, clamped to 1000-15000 Example: "10000"
  - fetch_mode (optional): Fetch mode: direct (default) reads static HTML; browser explicitly runs JavaScript in an owned, isolated browser. Enhanced and rendered try direct first and permit configured fallbacks. Non-direct modes require deployment enablement, an approved target and applicable resource or spending limits; otherwise the request is refused. Output formats are unchanged. Example: "direct"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/sessions (0cr) — params: limit, cursor, dry_run — Your browser sessions, newest first, with a cursor to the next page. Expired sessions are marked as they are listed.
  Reference: https://www.monocrawl.com/docs/endpoints/web/sessions.md
  - limit (optional): Sessions per page (default 25, cap 100) Example: "25"
  - cursor (optional): Opaque cursor from the previous page Example: "1757100000000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/sessions/close (0cr) — params: session_id*, dry_run — Release the hosted browser and mark the session closed. Closing early does not refund the hold.
  Reference: https://www.monocrawl.com/docs/endpoints/web/sessions/close.md
  - session_id (required): Session id returned by web/sessions/create Example: "ws_k3j2h1g0abcd"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/sessions/create (5cr) — params: url, ttl_seconds, activity_ttl_seconds, dry_run — Open an interactive hosted browser session: returns the session id, status, expiry and the credits held (billed at creation). Up to three live sessions per account; the longest lifetime is fifteen minutes. Drive it with web/sessions/execute; close it with web/sessions/close.
  Reference: https://www.monocrawl.com/docs/endpoints/web/sessions/create.md
  - url (optional): Page to open first (http/https) Example: "https://example.com"
  - ttl_seconds (optional): Session lifetime, 30 to 900 seconds (default 300) Example: "300"
  - activity_ttl_seconds (optional): Close after this many idle seconds (optional) Example: "120"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/sessions/execute (1cr) — params: session_id*, code*, url, language, timeout, dry_run — Evaluate JavaScript in the session's page, optionally after navigating: success flag, the returned value, any thrown error, the page URL and the duration.
  Reference: https://www.monocrawl.com/docs/endpoints/web/sessions/execute.md
  - session_id (required): Session id returned by web/sessions/create Example: "ws_k3j2h1g0abcd"
  - code (required): JavaScript evaluated in the page (a promise is awaited); the value is returned as JSON Example: "document.title"
  - url (optional): Navigate here first (optional) Example: "https://example.com"
  - language (optional): Only javascript: code runs in the page over DevTools, not node, python or bash on a host Example: "javascript"
  - timeout (optional): Milliseconds to allow, 1000 to 30000 (default 10000) Example: "10000"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/sessions/get (0cr) — params: session_id*, dry_run — One browser session: status, expiry, credits held and billed, and the supplier's live status while active.
  Reference: https://www.monocrawl.com/docs/endpoints/web/sessions/get.md
  - session_id (required): Session id returned by web/sessions/create Example: "ws_k3j2h1g0abcd"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/web/social-profiles (35cr) — params: platform*, handle*, dry_run — Starting from one known profile, the same person or brand's profiles on other platforms, with a confidence score and the evidence behind each match, plus link-in-bio and website URLs.
  Reference: https://www.monocrawl.com/docs/endpoints/web/social-profiles.md
  - platform (required): Platform of the known profile Example: "instagram"
  - handle (required): Handle on that platform Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## x
- GET /v1/x/community (3cr) — params: url*, dry_run — One X community: name, description, member count and rules.
  Reference: https://www.monocrawl.com/docs/endpoints/x/community.md
  - url (required): Full x.com community URL. Example: "https://x.com/i/communities/1926186499399139650"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/community-tweets (2cr) — params: url*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent tweets inside an X community with authors and engagement counts.
  Reference: https://www.monocrawl.com/docs/endpoints/x/community-tweets.md
  - url (required): Full x.com community URL. Example: "https://x.com/i/communities/1926186499399139650"
  - cursor (optional): Opaque continuation cursor from the preceding response; keep the same community URL.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/following (3cr) — params: handle*, limit, cursor, dry_run — The accounts an X account follows, as profile cards — handle, name, bio, location, follower/following/post counts, join date, avatar — up to 200 a page with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/x/following.md
  - handle (required): X username without the @. Example: "monzo"
  - limit (optional): Accounts per page, 20–200 (default 200). Smaller pages cost the upstream MORE per account, not less. Example: "200"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/mentions (3cr) — params: handle*, cursor, from_date, to_date, dry_run — Public X posts that mention an account, newest first, 20 a page: each as a full post card with its author, counts, media and links, with cursor pagination and an optional date window.
  Reference: https://www.monocrawl.com/docs/endpoints/x/mentions.md
  - handle (required): X username without the @. Example: "monzo"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - from_date (optional): ISO date lower bound on post time. Example: "2026-08-01"
  - to_date (optional): ISO date upper bound on post time. Example: "2026-09-01"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/profile (2cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — An X account's public profile: bio, follower and post counts, blue-verification.
  Reference: https://www.monocrawl.com/docs/endpoints/x/profile.md
  - handle (required): X username without the @. Example: "nasa"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/profile/full (5cr) — params: handle*, posts, cursor, include, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields are transparent page arithmetic, not SocialCrawl metric-schema equivalence.
  Reference: https://www.monocrawl.com/docs/endpoints/x/profile/full.md
  - handle (required): Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. Example: "NASA"
  - posts (optional): Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. Example: "25"
  - cursor (optional): Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
  - include (optional): CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. Example: "posts,computed"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/quotes (3cr) — params: id*, url, cursor, from_date, to_date, include_replies, dry_run — The posts that quote a public X post, newest first, 20 a page: each as a full post card with quoted_tweet_id set, its author and counts, with cursor pagination and an optional date window.
  Reference: https://www.monocrawl.com/docs/endpoints/x/quotes.md
  - id (required): Numeric post id. Pass url instead if you only have the link. Example: "1876576540177105257"
  - url (optional): An x.com or twitter.com status link; the id is read from it locally. Example: "https://x.com/monzo/status/1876576540177105257"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - from_date (optional): ISO date lower bound on quote time. Example: "2026-08-01"
  - to_date (optional): ISO date upper bound on quote time. Example: "2026-09-01"
  - include_replies (optional): false to leave out quotes that are themselves replies. Default true. Example: "true"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/retweeters (3cr) — params: id*, url, cursor, dry_run — The accounts that reposted a public X post, as profile cards with follower counts and join dates, with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/x/retweeters.md
  - id (required): Numeric post id. Pass url instead if you only have the link. Example: "1876576540177105257"
  - url (optional): An x.com or twitter.com status link; the id is read from it locally. Example: "https://x.com/monzo/status/1876576540177105257"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/search-tweets (1cr) — params: query*, mode, cursor, from_date, to_date, include_reposts, sort, sort_by, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Keyword search over public X posts, newest or top first: text, author card, like/repost/reply/quote/view counts, media, hashtags, mentions and links — 20 posts a page with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/x/search-tweets.md
  - query (required): Search terms. X's advanced operators work: from:handle, to:handle, lang:en, min_faves:100, "exact phrase", -word. Example: "Monzo bank"
  - mode (optional): latest (default) for newest first, top for X's relevance ranking. Example: "latest"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - from_date (optional): ISO date lower bound (translated to X's since_time operator). Example: "2026-08-01"
  - to_date (optional): ISO date upper bound (translated to X's until_time operator). Example: "2026-09-01"
  - include_reposts (optional): Set true to include reposts or false to exclude them. Set this explicitly and preserve it across pages; omitted behavior can differ across sources. Example: "false"
  - sort (optional): Alias for mode: latest or top. mode takes precedence; otherwise sort takes precedence over sort_by. Equivalent spellings share the response cache. Example: "latest"
  - sort_by (optional): Alias for mode: latest or top. mode, then sort, take precedence. Equivalent spellings share the response cache. Example: "top"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/tweet (2cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One X post: text, author and current engagement counts.
  Reference: https://www.monocrawl.com/docs/endpoints/x/tweet.md
  - url (required): Full X post URL. Example: "https://x.com/nasa/status/2095621168208248911"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/tweet-replies (5cr) — params: id*, url, cursor, from_date, to_date, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The replies under a public X post, newest first, 20 a page: each reply as a full post card with its author, counts and in_reply_to_id / conversation_id so threads can be rebuilt.
  Reference: https://www.monocrawl.com/docs/endpoints/x/tweet-replies.md
  - id (required): Numeric post id. Pass url instead if you only have the link. Example: "1876576540177105257"
  - url (optional): An x.com or twitter.com status link; the id is read from it locally. Example: "https://x.com/monzo/status/1876576540177105257"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - from_date (optional): ISO date lower bound on reply time. Example: "2026-08-01"
  - to_date (optional): ISO date upper bound on reply time. Example: "2026-09-01"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/tweet-transcript (5cr) — params: url*, dry_run — The spoken words of a video in an X post as text. transcript is null when the video has no speech or captions — that is the honest answer, not an error.
  Reference: https://www.monocrawl.com/docs/endpoints/x/tweet-transcript.md
  - url (required): Full X post URL containing a video under ~2 minutes. Example: "https://x.com/TheoVon/status/1916982720317821050"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/tweets (3cr) — params: handle*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Recent posts for an X account with like, repost, reply and view counts.
  Reference: https://www.monocrawl.com/docs/endpoints/x/tweets.md
  - handle (required): X username without the @. Example: "nasa"
  - cursor (optional): Opaque cursor from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/user-followers (3cr) — params: handle*, limit, cursor, dry_run — An X account's followers as profile cards — handle, name, bio, location, follower/following/post counts, join date, avatar — up to 200 a page with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/x/user-followers.md
  - handle (required): X username without the @. Example: "monzo"
  - limit (optional): Followers per page, 20–200 (default 200). Smaller pages cost the upstream MORE per follower, not less. Example: "200"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/x/user-media (3cr) — params: handle*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — An X account's own posts that carry photos or video (replies left out), newest first: each as a full post card with its media urls, counts and author. A page covers 20 posts and `scanned` says how many were read, so a short page means few media posts in that stretch, not the end.
  Reference: https://www.monocrawl.com/docs/endpoints/x/user-media.md
  - handle (required): X username without the @. Example: "monzo"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/x/user-search (1cr) — params: query*, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Keyword search over X accounts: profile cards with handle, name, bio, location, follower/following/post counts, join date and avatar, with cursor pagination.
  Reference: https://www.monocrawl.com/docs/endpoints/x/user-search.md
  - query (required): Keywords matched against account names, handles and bios. Example: "fintech founder"
  - cursor (optional): Opaque cursor from the previous page's cursor field. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## yelp
- GET /v1/yelp/business (1cr) — params: id*, dry_run — One Yelp business record.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/business.md
  - id (required): Business id or alias, or its yelp.com URL Example: "the-old-fashioned-madison"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/menu (1cr) — params: id*, dry_run — The menu of a Yelp business in sections with prices, when one is published.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/menu.md
  - id (required): Business id or alias Example: "RJNAeNA-209sctUO0dmwuA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/photos (1cr) — params: id*, category, page, dry_run — Photos and videos of a Yelp business, twenty per page, with the category counts.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/photos.md
  - id (required): Business id or alias Example: "RJNAeNA-209sctUO0dmwuA"
  - category (optional): Media category slug (food, drink, menu, ...) Example: "food"
  - page (optional): Page number (20 per page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/related (1cr) — params: id*, limit, dry_run — Businesses the platform recommends alongside one business.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/related.md
  - id (required): Business id or alias Example: "RJNAeNA-209sctUO0dmwuA"
  - limit (optional): Up to 20 Example: "10"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/reviews (3cr) — params: id*, page, sort, keywords, language, dry_run — Reviews of a Yelp business, ten per page, with the author profile, votes, photos and any owner reply.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/reviews.md
  - id (required): Business id or alias, or its yelp.com URL Example: "RJNAeNA-209sctUO0dmwuA"
  - page (optional): Page number (10 per page) Example: "1"
  - sort (optional): yelp (default) or newest Example: "newest"
  - keywords (optional): Only reviews mentioning this text Example: ""
  - language (optional): ISO 639-1 language Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/search (1cr) — params: query*, location*, page, sort, dry_run — Businesses matching a query near a place, twenty per page, with rating, review count, price range, contact details and coordinates.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/search.md
  - query (required): What to look for Example: "Cheese Curds"
  - location (required): City, address or postcode Example: "Madison, WI"
  - page (optional): Page number (20 per page) Example: "1"
  - sort (optional): Result ordering Example: "recommended"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/yelp/search-suggestions (1cr) — params: query*, location*, dry_run — PARTIAL: business suggestions for a typed query near a place (name, id, URL, rating, address), from the held listing's search. The platform's own typeahead rows for categories, common terms and chains are not served; the answer lists what is missing.
  Reference: https://www.monocrawl.com/docs/endpoints/yelp/search-suggestions.md
  - query (required): Search words as typed Example: "pizza"
  - location (required): City, address or postcode Example: "New York, NY"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## youtube
- GET /v1/youtube/channel (1cr) — params: channelId, handle, forUsername, url, hl, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Channel profile: title, handle, subscriber/view/video counts, avatar, banner and the uploads playlist id.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/channel.md
  - channelId (optional): Channel id (UC…). One of channelId, handle, forUsername or url is required Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  - handle (optional): Channel @handle (with or without the @) Example: "@googledevelopers"
  - forUsername (optional): Legacy channel username Example: "GoogleDevelopers"
  - url (optional): Any channel URL (/channel/UC…, /@handle, /user/…, /c/…) Example: "https://www.youtube.com/@googledevelopers"
  - hl (optional): BCP-47 language for localized snippet text Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/channel/playlists (1cr) — params: channelId, handle, url, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public playlists owned by a channel: title, description, item count and privacy.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/channel/playlists.md
  - channelId (optional): Channel id. One of channelId, handle or url is required Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  - handle (optional): Channel @handle (resolved to a channel id first) Example: "@googledevelopers"
  - url (optional): Any channel URL Example: "https://www.youtube.com/@googledevelopers"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/channel/videos (1cr) — params: channelId, handle, url, max_results, cursor, sort, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A channel's uploaded videos, newest first, read from its uploads playlist.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/channel/videos.md
  - channelId (optional): Channel id. One of channelId, handle or url is required Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  - handle (optional): Channel @handle Example: "@googledevelopers"
  - url (optional): Any channel URL Example: "https://www.youtube.com/@googledevelopers"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - sort (optional): Accepted for compatibility but ignored — uploads come newest-first (noted in _warnings) Example: "newest"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/channels (2cr) — params: ids*, hl, dry_run — Batch channel lookup — one normalized record per id; unknown/terminated ids are reported in `missing`.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/channels.md
  - ids (required): Comma-separated (or JSON array of) channel ids; up to 250, chunked 50 per upstream call Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw,UCrDkAvwZum-UTjHmzDI2iIw"
  - hl (optional): BCP-47 language for localized snippet text Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/community-post (2cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One community post by URL.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/community-post.md
  - url (required): Full community post URL. Example: "https://www.youtube.com/post/UgkxzJ6r7VLAK03TN5Gjq7YpjHmjtee_Rdn9"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/community-posts (2cr) — params: handle*, channelId, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A channel's community-tab posts: text, images, likes and attached videos. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/community-posts.md
  - handle (required): Channel handle without the @ (or pass channelId). Example: "MrBeast"
  - channelId (optional): Channel id — alternative to handle.
  - cursor (optional): continuationToken from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/lives (2cr) — params: handle*, channelId, cursor, dry_run — A channel's live tab: current and past streams with view counts and live state. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/lives.md
  - handle (required): Channel handle without the @ (or pass channelId). Example: "IShowSpeed"
  - channelId (optional): Channel id — alternative to handle.
  - cursor (optional): continuationToken from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/playlist (1cr) — params: playlist_id*, dry_run — Playlist metadata: title, description, owning channel, video count and privacy.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/playlist.md
  - playlist_id (required): Playlist id Example: "PLOU2XLYxmsIKpaV8h0AGE05so0fAwwfTw"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/playlist/items (1cr) — params: playlist_id*, max_results, cursor, dry_run — The videos in a playlist, in playlist order, with per-item position and dates.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/playlist/items.md
  - playlist_id (required): Playlist id Example: "PLOU2XLYxmsIKpaV8h0AGE05so0fAwwfTw"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/post-transcript (2cr) — params: url*, dry_run — The spoken words of a YouTube video as timestamped segments plus plain text. transcript is null when the video has no captions.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/post-transcript.md
  - url (required): Full YouTube video URL. Example: "https://www.youtube.com/watch?v=jNQXAC9IVRw"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/profile (4cr) — params: handle*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Public YouTube channel: identity, description, subscriber/video/view counts.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/profile.md
  - handle (required): Channel handle, e.g. @NASA. Example: "@NASA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/profile/full (5cr) — params: channelId, handle, url, posts, cursor, include, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — One-call channel dossier: channel profile, recent uploads with stats, and computed engagement analytics; per-source failures reported inline.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/profile/full.md
  - channelId (optional): Channel id. One of channelId, handle or url is required Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  - handle (optional): Channel @handle Example: "@googledevelopers"
  - url (optional): Any channel URL Example: "https://www.youtube.com/@googledevelopers"
  - posts (optional): Recent uploads to sample for analytics, 1-50 (default 10) Example: "10"
  - cursor (optional): Opaque page token to continue the recent-uploads listing Example: "CAUQAA"
  - include (optional): Comma list: videos and/or analytics (default both) Example: "videos,analytics"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/search (1cr) — params: query*, type, sortBy, duration, uploadDate, region, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Search YouTube for videos, channels and playlists (Data API search.list; 100 quota units per call).
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/search.md
  - query (required): Search query Example: "lofi hip hop"
  - type (optional): Result kinds: video, channel, playlist (comma-separable) Example: "video"
  - sortBy (optional): relevance, date, rating, title or views (maps to order/viewCount) Example: "date"
  - duration (optional): short, medium or long (forces video results) Example: "medium"
  - uploadDate (optional): hour/today/week/month/year — mapped to publishedAfter Example: "week"
  - region (optional): ISO-3166 region code (maps to regionCode) Example: "US"
  - max_results (optional): Results per page, max 50 Example: "25"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/search/advanced (1cr) — params: query*, order, duration, event_type, license, category, region, language, published_after, published_before, channel_id, safe_search, video_caption, video_definition, video_dimension, video_embeddable, video_type, topic_id, location, location_radius, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Advanced YouTube search exposing the Data API search.list filters (order, duration, event/type, category, geo, dates, captions and more).
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/search/advanced.md
  - query (required): Search query Example: "machine learning"
  - order (optional): relevance, date, rating, title or viewCount Example: "viewCount"
  - duration (optional): short, medium or long (forces video results) Example: "long"
  - event_type (optional): live, upcoming or completed (forces video results) Example: "completed"
  - license (optional): any, creativeCommon or youtube (maps to videoLicense) Example: "creativeCommon"
  - category (optional): videoCategoryId Example: "28"
  - region (optional): ISO-3166 region code (maps to regionCode) Example: "US"
  - language (optional): Preferred content language (maps to relevanceLanguage) Example: "en"
  - published_after (optional): RFC-3339 lower bound (maps to publishedAfter) Example: "2024-01-01T00:00:00Z"
  - published_before (optional): RFC-3339 upper bound (maps to publishedBefore) Example: "2025-01-01T00:00:00Z"
  - channel_id (optional): Restrict to a channel (maps to channelId) Example: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  - safe_search (optional): none, moderate or strict (maps to safeSearch) Example: "moderate"
  - video_caption (optional): any, closedCaption or none (maps to videoCaption) Example: "closedCaption"
  - video_definition (optional): any, standard or high (maps to videoDefinition) Example: "high"
  - video_dimension (optional): 2d, 3d or any (maps to videoDimension) Example: "2d"
  - video_embeddable (optional): true or any (maps to videoEmbeddable) Example: "true"
  - video_type (optional): any, episode or movie (maps to videoType) Example: "movie"
  - topic_id (optional): Freebase topic id (maps to topicId) Example: "/m/019_rr"
  - location (optional): lat,long point (maps to location; requires location_radius) Example: "37.42307,-122.08427"
  - location_radius (optional): Search radius, e.g. 10km (maps to locationRadius) Example: "10km"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/search/hashtag (1cr) — params: hashtag*, type, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Best-effort hashtag search — a search.list keyword query for the "#tag" token (Data API has no dedicated hashtag endpoint; noted in _warnings).
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/search/hashtag.md
  - hashtag (required): Hashtag with or without the leading # Example: "shorts"
  - type (optional): Result kind (defaults to video) Example: "video"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/shorts (1cr) — params: handle*, channelId, sort, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A channel's Shorts shelf: title, URL, views, likes and comments per short. Paged by cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/shorts.md
  - handle (required): Channel handle without the @ (or pass channelId). Example: "starterstory"
  - channelId (optional): Channel id — alternative to handle.
  - sort (optional): newest or popular.
  - cursor (optional): continuationToken from the previous page.
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/shorts-trending (4cr) — params: dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The current trending Shorts feed with engagement counts.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/shorts-trending.md
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/typeahead (2cr) — params: query*, dry_run — YouTube's own search suggestions for a query — channels are identified with id and handle. Keyword-research signal.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/typeahead.md
  - query (required): Partial query. Example: "mr beast"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/video (1cr) — params: url*, hl, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Full video details: title, description, duration, view/like/comment counts, thumbnails and live details.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video.md
  - url (required): Video URL (watch, youtu.be, /shorts/…) or a bare 11-char video id Example: "https://www.youtube.com/watch?v=9bZkp7q19f0"
  - hl (optional): BCP-47 language for localized snippet text Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video-sponsors (4cr) — params: url*, language, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Detects the paid-promotion flag and infers likely sponsors from the description, links, promo codes and transcript — every sponsor carries its evidence. Experimental: absence of a detection is not proof there is no sponsor.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video-sponsors.md
  - url (required): Full YouTube video URL. Example: "https://www.youtube.com/watch?v=AVO0ifle-OU"
  - language (optional): Transcript language. Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video/audio (1cr) — params: url*, dry_run — The audio-only streams the platform offers for a video: format tag, direct time-limited link, MIME type, bitrate, sample rate, channels and duration. Links expire; fetch them promptly.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/audio.md
  - url (required): Video URL or id Example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/youtube/video/comment/replies (1cr) — params: comment_id*, format, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Replies under a specific top-level comment, addressed by the parent comment id.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/comment/replies.md
  - comment_id (required): Top-level (parent) comment id whose replies to fetch. the reference catalogue continuationToken is accepted as this id Example: "Ugz1234567890AbCdEf4AaABAg"
  - format (optional): html or plainText comment text (maps to textFormat) Example: "plainText"
  - max_results (optional): Requested page size, 1–100. The paid primary defaults to 100; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "100"
  - cursor (optional): Opaque page token from a previous response Example: "QURTSl9pMg"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video/comments (1cr) — params: url*, order, searchTerm, format, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Top-level comment threads on a video; comments-disabled videos surface as 404.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/comments.md
  - url (required): Video URL or a bare 11-char video id Example: "https://www.youtube.com/watch?v=9bZkp7q19f0"
  - order (optional): time or relevance (Data API order) Example: "relevance"
  - searchTerm (optional): Only comments matching this term (maps to searchTerms) Example: "great video"
  - format (optional): html or plainText comment text (maps to textFormat) Example: "plainText"
  - max_results (optional): Requested page size, 1–100. The paid primary defaults to 100; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "100"
  - cursor (optional): Opaque page token from a previous response Example: "QURTSl9pMg"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video/files (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The video stream files the platform offers for a video: format tag, direct time-limited link, MIME type, quality label, size, frame rate, bitrate and duration. Links expire; fetch them promptly.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/files.md
  - url (required): Video URL or id Example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video/subtitles (1cr) — params: url*, language, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The caption tracks a video carries: language code and name, whether auto-generated, and the track link. The transcript text itself is youtube/post-transcript.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/subtitles.md
  - url (required): Video URL or id Example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  - language (optional): Restrict to one language code Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/video/thumbnails (1cr) — params: url*, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — A video's thumbnail set from the snippet, plus conventional i.ytimg.com URLs for every size.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/video/thumbnails.md
  - url (required): Video URL or a bare 11-char video id Example: "https://www.youtube.com/watch?v=9bZkp7q19f0"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/videos (2cr) — params: ids*, hl, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — Batch video lookup — one normalized record per id; unknown/private/deleted ids are reported in `missing`.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/videos.md
  - ids (required): Comma-separated (or JSON array of) video ids or URLs; up to 250, chunked 50 per upstream call Example: "9bZkp7q19f0,kJQP7kiw5Fk"
  - hl (optional): BCP-47 language for localized snippet text Example: "en"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
- GET /v1/youtube/videos/trending (1cr) — params: region, category, language, max_results, cursor, dry_run, judgments, label, label_evidence, exclude, fit, goal, tokens — The most-popular videos chart (videos.list chart=mostPopular) for a region and optional category.
  Reference: https://www.monocrawl.com/docs/endpoints/youtube/videos/trending.md
  - region (optional): ISO-3166 region code (default US; maps to regionCode) Example: "US"
  - category (optional): videoCategoryId to restrict the chart Example: "10"
  - language (optional): Localized text language (maps to hl) Example: "en"
  - max_results (optional): Requested page size, 1–50. The paid primary defaults to 50; the source may return fewer. Keep an explicit size unchanged while paginating. Example: "50"
  - cursor (optional): Opaque page token from a previous response Example: "CAUQAA"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
  - judgments (optional): Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Example: "on"
  - label (optional): Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Example: "none"
  - label_evidence (optional): Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Example: "1"
  - exclude (optional): Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Example: "engagement_bait"
  - fit (optional): Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Example: "goal"
  - goal (optional): Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. Example: "Find concrete product complaints"
  - tokens (optional): Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. Example: "4000"
## zillow
- GET /v1/zillow/building (1cr) — params: url*, dry_run — Building details and unit-level rents, beds, area, required fees and availability dates. Records can include future availability; base rent and mandatory fees remain separate.
  Reference: https://www.monocrawl.com/docs/endpoints/zillow/building.md
  - url (required): Zillow apartment-building page URL. Example: "https://www.zillow.com/apartments/austin-tx/alexan-st.-elmo/C8gzfc/"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zillow/locations (1cr) — params: query*, dry_run — Location suggestions for property searches.
  Reference: https://www.monocrawl.com/docs/endpoints/zillow/locations.md
  - query (required): Location text. Example: "Austin TX"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zillow/property (1cr) — params: id*, dry_run — Property listing price, photos, description, basic facts and optional estimated values. Historical prices, tax history and school data are not supported.
  Reference: https://www.monocrawl.com/docs/endpoints/zillow/property.md
  - id (required): Numeric identifier from a parent result. Example: "29479546"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zillow/search-sale (1cr) — params: location*, min_price, max_price, min_beds, sort, cursor, dry_run — Homes for sale with listing prices, photos, bedrooms, bathrooms, address and coordinates where supplied. Native result pages use an opaque cursor.
  Reference: https://www.monocrawl.com/docs/endpoints/zillow/search-sale.md
  - location (required): City/region in the United States or Canada. Example: "Austin, TX"
  - min_price (optional): Minimum listing price. Example: ""
  - max_price (optional): Maximum listing price. Example: "600000"
  - min_beds (optional): Minimum bedrooms. Example: "3"
  - sort (optional): Newest listings first. Only newest is supported. Example: "newest"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zillow/search-sold (1cr) — params: location*, min_price, max_price, min_beds, sort, cursor, dry_run — Recently sold property listings and their displayed prices. This is a listing search, not a price-history or transaction-verification service.
  Reference: https://www.monocrawl.com/docs/endpoints/zillow/search-sold.md
  - location (required): City/region in the United States or Canada. Example: "Austin, TX"
  - min_price (optional): Minimum listing price. Example: ""
  - max_price (optional): Maximum listing price. Example: "600000"
  - min_beds (optional): Minimum bedrooms. Example: "3"
  - sort (optional): Newest listings first. Only newest is supported. Example: "newest"
  - cursor (optional): Opaque continuation from this operation; preserve all original parameters. Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
## zoopla
- GET /v1/zoopla/agent (2cr) — params: id*, url, dry_run — One agent branch's page: address, telephone, website and social links, memberships, description, photos and position.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/agent.md
  - id (required): The branch id from zoopla/agents (or pass url, the branch's page) Example: "55447"
  - url (optional): The branch's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/agents (2cr) — params: location, identifier, page, radius, type, name, sort, dry_run — The agent branches in an area with each one's market figures: homes available, average asking price and weeks on the market, for sale and to rent.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/agents.md
  - location (optional): A postcode, town or area name; resolved once and remembered (or pass identifier) Example: "Oxford"
  - identifier (optional): An area identifier from zoopla/locations or a path from zoopla/area Example: "oxford"
  - page (optional): Page number (25 a page) Example: "1"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: ""
  - type (optional): sales, lettings or commercial Example: ""
  - name (optional): Only agents whose name contains this Example: ""
  - sort (optional): a_z, shortest_avg_age, highest_avg_price or lowest_avg_price Example: "a_z"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/area (1cr) — params: postcode*, dry_run — The house-prices area for a postcode: its path (for zoopla/estimates and zoopla/agents), name and kind.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/area.md
  - postcode (required): A full postcode, or an area name Example: "SW2 1AH"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/estimates (3cr) — params: path*, page, limit, dry_run — Every address along one street with the portal's sale estimate, its attributes and its recorded sales, plus the street's market line (average price paid, properties sold).
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/estimates.md
  - path (required): A street path from zoopla/streets or zoopla/area Example: "london/oxford-road-se19"
  - page (optional): Page number Example: "1"
  - limit (optional): Addresses per page, 1 to 50 Example: "12"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/locations (1cr) — params: query*, dry_run — The areas the portal knows for a name, each with the identifier and label the searches take.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/locations.md
  - query (required): A postcode, town or area name Example: "Oxford"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/property (3cr) — params: id*, url, dry_run — One listing's page: title, address and UPRN, rooms and floor area, price with its qualifier and price per square foot, tenure, the portal's key facts (service charge, council tax, water…), EPC rating, description and features, photos, floorplans, transport and schools nearby, price history and the agent branch.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/property.md
  - id (required): The listing number (or pass url, the listing's page) Example: "69200045"
  - url (optional): The listing's page URL instead of an id Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/property-history (2cr) — params: uprn*, dry_run — The recorded sales of one address (date, price, change since the sale before) and the listings the portal has seen for it.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/property-history.md
  - uprn (required): The property's UPRN, from zoopla/property or zoopla/estimates Example: "10013983744"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/search-rent (3cr) — params: location, identifier, label, page, radius, min_price, max_price, min_bedrooms, max_bedrooms, min_bathrooms, max_bathrooms, property_type, sort, keywords, must_have, features, added, include_rented, furnished, available_from, retirement_homes, house_share, student, dry_run — Homes to rent in an area: address, title, rooms, monthly rent and its label, available-from date, agent, photos and position; the portal's featured homes beside them.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/search-rent.md
  - location (optional): A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier and label) Example: "Oxford"
  - identifier (optional): An area identifier from zoopla/locations Example: "oxford"
  - label (optional): The area's label from zoopla/locations, sent with the identifier Example: "Oxford, Oxfordshire"
  - page (optional): Page number Example: "1"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: ""
  - min_price (optional): Minimum monthly rent in pounds Example: ""
  - max_price (optional): Maximum monthly rent in pounds Example: ""
  - min_bedrooms (optional): Minimum bedrooms Example: ""
  - max_bedrooms (optional): Maximum bedrooms Example: ""
  - min_bathrooms (optional): Minimum bathrooms Example: ""
  - max_bathrooms (optional): Maximum bathrooms Example: ""
  - property_type (optional): detached, semi_detached, terraced, flats, bungalow; several separated by commas Example: "flats"
  - sort (optional): newest, highest_price, lowest_price or most_reduced Example: "newest"
  - keywords (optional): Words the listing must mention Example: ""
  - must_have (optional): has_garden, has_parking_garage, has_balcony_terrace and the portal's other must-haves; separated by commas Example: ""
  - features (optional): The portal's property-feature codes, separated by commas Example: ""
  - added (optional): Only homes added in the last 1, 3, 7, 14 or 30 days Example: ""
  - include_rented (optional): Include homes already let or let agreed Example: "false"
  - furnished (optional): any, furnished, part_furnished or unfurnished Example: ""
  - available_from (optional): now, 1months, 3months, 6months or 12months Example: ""
  - retirement_homes (optional): include, exclude or only Example: ""
  - house_share (optional): include, exclude or only Example: ""
  - student (optional): Student accommodation: include, exclude or only Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/search-sale (3cr) — params: location, identifier, label, page, radius, min_price, max_price, min_bedrooms, max_bedrooms, min_bathrooms, max_bathrooms, property_type, sort, keywords, must_have, features, added, include_sold, new_homes, retirement_homes, auction, shared_ownership, show_only, ownership, dry_run — Homes for sale in an area: address, title, rooms, price and its label, flag, agent, photos and position; the portal's featured homes beside them.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/search-sale.md
  - location (optional): A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier and label) Example: "Oxford"
  - identifier (optional): An area identifier from zoopla/locations Example: "oxford"
  - label (optional): The area's label from zoopla/locations, sent with the identifier Example: "Oxford, Oxfordshire"
  - page (optional): Page number Example: "1"
  - radius (optional): Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 Example: ""
  - min_price (optional): Minimum asking price in pounds Example: ""
  - max_price (optional): Maximum asking price in pounds Example: ""
  - min_bedrooms (optional): Minimum bedrooms Example: ""
  - max_bedrooms (optional): Maximum bedrooms Example: ""
  - min_bathrooms (optional): Minimum bathrooms Example: ""
  - max_bathrooms (optional): Maximum bathrooms Example: ""
  - property_type (optional): detached, semi_detached, terraced, flats, bungalow, farms_land, park_home; several separated by commas Example: "flats,terraced"
  - sort (optional): newest, highest_price, lowest_price or most_reduced Example: "newest"
  - keywords (optional): Words the listing must mention Example: ""
  - must_have (optional): has_garden, has_parking_garage, has_balcony_terrace and the portal's other must-haves; separated by commas Example: ""
  - features (optional): The portal's property-feature codes, separated by commas Example: ""
  - added (optional): Only homes added in the last 1, 3, 7, 14 or 30 days Example: ""
  - include_sold (optional): Include homes under offer or sold subject to contract Example: "false"
  - new_homes (optional): include, exclude or only Example: ""
  - retirement_homes (optional): include, exclude or only Example: ""
  - auction (optional): include, exclude or only Example: ""
  - shared_ownership (optional): include, exclude or only Example: ""
  - show_only (optional): chainFree, reducedPriceOnly; separated by commas Example: ""
  - ownership (optional): leasehold, freehold, share_of_freehold; separated by commas Example: ""
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/sold-prices (3cr) — params: location*, page, dry_run — The Land Registry sales in an area as the portal indexes them: each address with its last sale, its attributes and its UPRN, and the area's average prices by property type.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/sold-prices.md
  - location (required): A town, area, postcode or outcode, or a path such as london/croydon Example: "Oxford"
  - page (optional): Page number (25 a page) Example: "1"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/streets (1cr) — params: query*, dry_run — The streets and addresses the house-prices index knows for a name, each with the path zoopla/estimates takes.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/streets.md
  - query (required): Part of a street name or address Example: "Oxford Road"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"
- GET /v1/zoopla/valuation (3cr) — params: uprn, address, dry_run — The portal's valuation of one address, by UPRN or by street address: the current sale and rent estimates with their range and confidence, the estimate's history, the Land Registry sales, live and similar listings nearby, and the schools and stations around it.
  Reference: https://www.monocrawl.com/docs/endpoints/zoopla/valuation.md
  - uprn (optional): The property's UPRN, from zoopla/property, zoopla/estimates, zoopla/streets or zoopla/sold-prices (or pass address) Example: "200001198316"
  - address (optional): A street address with its postcode instead of a UPRN Example: "45 Princes Avenue, South Croydon CR2 9BE"
  - dry_run (optional): Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Example: "1"

This document regenerates from the live endpoint registry. Index: https://www.monocrawl.com/llms.txt · OpenAPI: https://www.monocrawl.com/openapi.json
