--- source_url: "https://www.olostep.com/api-endpoints" title: Endpoints mirrored_at: 2026-08-15T15:35:16.706Z host: www.olostep.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/www.olostep.com/api-endpoints" --- > **Original source:** https://www.olostep.com/api-endpoints ## Choose the right API endpoint for your job. Olostep exposes focused HTTP APIs: Answers and Search for questions and discovery; Scrapes for known URLs; Maps for site URL inventory; Crawls for multi-page site walks; Batches for large arbitrary URL lists. Thank you! Your submission has been received! Oops! Something went wrong while submitting the form. ![](https://www.olostep.com/images/svgexport-11-1.svg) ## Trusted by the best startups **startups** in the world ## All endpoints at a glance Each API solves a different shape of problem. Follow the landing page for code samples, pricing context, and how it pairs with other endpoints. ![](https://www.olostep.com/images/search-window_1.svg) ### Scrapes Extract content from a URL you already know — markdown, HTML, text, JSON, screenshots, parsers, LLM extract. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) One page or a small set of known URLs ![](https://www.olostep.com/images/check-svgrepo-com.svg) Rich formats and structured extraction per page ### You get Per-URL content (markdown\_content, html\_content, json\_content, etc.) ready for RAG, agents, or storage. ![](https://www.olostep.com/images/light-bulb.svg) Use Batch when you have hundreds to thousands of URLs and want one job with predictable wall-clock time. ![](https://www.olostep.com/images/internet_1.svg) ### Crawls Walk a site from a start URL with depth and page limits; poll until completed; list pages and retrieve content. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Multi-page documentation or blogs on one site ![](https://www.olostep.com/images/check-svgrepo-com.svg) When you want exploration + content in one workflow ### You get Crawl status, per-page retrieve\_ids, then markdown/HTML/JSON via /v1/retrieve — similar to batch but site-shaped. ![](https://www.olostep.com/images/light-bulb.svg) Use Batch when your URLs come from anywhere (not one crawl frontier); use Crawl for hierarchical site walks. ![](https://www.olostep.com/images/map_1.svg) ### Maps Discover URLs for a single domain — sitemaps, links, filters, and cursor pagination. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Discovery without maintaining your own SERP scrapers ![](https://www.olostep.com/images/check-svgrepo-com.svg) Feeding candidate URLs into Scrapes or Batches ### You get A search object with result.links (url, title, description) plus optional hosted JSON for the full result set. ![](https://www.olostep.com/images/light-bulb.svg) Map discovers URLs only; Crawl fetches content across many pages of a site. ![](https://www.olostep.com/images/apple-shortcuts.svg) ### Batches Process large URL lists in one job — predictable completion time, parsers, webhooks, metadata, cursor over items. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Thousands of arbitrary URLs (catalogs, SERPs, exports) ![](https://www.olostep.com/images/check-svgrepo-com.svg) Pipelines that need webhooks and batch-level parsers ### You get Batch status, paginated items, then per-item retrieve — ideal for scale without hand-rolling concurrency. ![](https://www.olostep.com/images/light-bulb.svg) Parallel Scrapes are often faster for tiny sets; Batch wins for large lists and operational simplicity. ![](https://www.olostep.com/images/search.svg) ### Searches Semantic web search from a plain-English query — deduplicated links with titles and descriptions. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Discovery without maintaining your own SERP scrapers ![](https://www.olostep.com/images/check-svgrepo-com.svg) Feeding candidate URLs into Scrapes or Batches ### You get A search object with result.links (url, title, description) plus optional hosted JSON for the full result set. ![](https://www.olostep.com/images/light-bulb.svg) Search returns links across the web for a query; Map returns URLs discovered for one site you already chose. ![](https://www.olostep.com/images/bubble-search_1.svg) ### Answers Ask a question in natural language; get a source-backed answer and optional structured JSON. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Grounding LLMs on live web data ![](https://www.olostep.com/images/check-svgrepo-com.svg) Enrichment when the input is a question, not a URL list ### You get An answer object with validated fields, citations, and NOT\_FOUND when the web cannot support a claim — not just raw page text. ![](https://www.olostep.com/images/light-bulb.svg) Use Search when you need a list of links to explore; use Answers when you need a single synthesized response. ![](https://www.olostep.com/images/bell-notification-1.svg) ### Monitors Create persistent monitors from natural-language queries; run scheduled checks, detect page changes, and send alerts. ### Use when ![](https://www.olostep.com/images/check-svgrepo-com.svg) Tracking pricing, changelogs, blogs, or status pages ![](https://www.olostep.com/images/check-svgrepo-com.svg) Alerting teams by email, Slack, SMS, or webhook ### You get Monitor status, schedule, tracked targets, snapshot events, change summaries, and run logs for recurring checks. ![](https://www.olostep.com/images/light-bulb.svg) Use Scrapes for one-time extraction; use Monitors when the same source must be checked repeatedly. ## Trusted by Amazing Teams Building the Future of AI ![](https://www.olostep.com/images/michelle-pic.jpg) Michelle Julia Co-founder & CEO Aurium Olostep is the best!!! We automated entire data pipelines with just a prompt ![](https://www.olostep.com/images/richard-he.avif) Richard He Co-founder & CEO Openmart Olostep has become the default Web Layer infrastructure for our company ![](https://www.olostep.com/images/mx-pic.jpeg) Max Brodeur-Urbas Co-founder & CEO Gumloop Olostep works like a charm! And your customer service is exceptional ![](https://www.olostep.com/images/rob-pic.jpeg) Rob Hayes Co-founder Merchkit Olostep lets us turn any website into an API. Great product, great people ![](https://www.olostep.com/images/brandon-civilgrid.webp) Brandon Cohen Co-founder & CTO CivilGrid I highly recommend Olostep, great product! ![](https://www.olostep.com/images/berk-pic.jpeg) Co-founder & CEO Gedd.it We verify coupon codes at scale. Love Olostep. It works on any e-commerce ![](https://www.olostep.com/images/trevor-west.jpeg) Trevor West Co-founder & CEO Podqi Olostep is the best API to search, extract, and structure data from the Web. Happy to be customers ![](https://www.olostep.com/images/rida_pic.jpg) Rida Naveed Co-founder Zecento We use /batches combined with parsers and it's magical how we can get structured data at large scale ![](https://www.olostep.com/images/kieran-plots.jpeg) Kieran V. Growth PlotsEvents Olostep allowed us to search and structure events data across the Web ![](https://www.olostep.com/images/paul-mit.jpg) Paul Mit Founder Foundbase Reliable and cost-effective API for working with data. Congrats on the cool product ## Frequently asked questions Product & Capabilities ### I have a single URL — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/scrapes (Scrapes) to extract markdown, HTML, JSON, screenshots, or parser output from that page. ### I need every URL on a website — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/maps (Maps) for domain-level URL discovery with optional path filters and cursor pagination. ### I need to walk a site and get many pages of content — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/crawls (Crawls) when you want a multi-page crawl from a start URL, then list pages and retrieve content per page. Usage & Automation ### I have thousands of arbitrary URLs — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/batches (Batches) for large lists with predictable job time, optional parsers, webhooks, and metadata. ### I need a direct answer from the web — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/answers (Answers) for agentic Q&A with validation and optional structured JSON — not just a link list. Pricing & Plans ### I need ranked links for a question — which endpoint? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) Use POST /v1/searches (Search) for semantic web search that returns deduplicated links with titles and descriptions; then scrape selected URLs if you need full page content. ### When are parallel Scrapes better than a Batch? ![](https://www.olostep.com/images/6177739448baa6e16cce1db4_icon_plus.svg) For a small number of URLs, parallel /v1/scrapes calls often finish faster. Batches shine for large lists and operational patterns (webhooks, single job id, item cursoring).