We plan it in under a second: which tools to run, in what order, and the estimated cost. Free.
Hand it to your AI agent
Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.
Use the Lovely Router data tool catalog (pay-per-result scrapers and search for maps, social networks, e-commerce, reviews, jobs and the web) to get data for me.
- Docs (read first): https://lovelyrouter.com/docs/tools.md and https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Find the right tool: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<what I need>"}` plans the task, or GET https://lovelyrouter.com/v1/tools?category=<category> lists them.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Each tool takes its own input fields: read them with GET https://lovelyrouter.com/v1/tools/<id> (public, no key needed) before the first run.
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <describe the data you need and the output format>Search the web: up to 50 results with title, URL, date, site, a short snippet and a long summary written for models (and the page text if asked). Operators: site:, -site:, "exact phrase", -word, lang:, after:, before:.
Read any public web page as clean Markdown: its title and text, without navigation or ads. For one page you already have the URL of.
Give it a goal and a start page; an AI agent drives a real browser to do it: navigate, fill forms, log in with saved secrets, ask you for codes, hand over for CAPTCHAs, wait for your approval before purchases, and return structured JSON in your schema. For tasks that need interaction; to just read a page, use Read a web page (web-fetch). $0.006 per step in fast mode, $0.012 in accurate mode (looks at screenshots when unsure, can run read-only code to read data). Each step includes 1 minute; time beyond that (e.g. waiting for your approval) costs $0.005/min. Full API: /v1/browser.
Google results pages for a query: organic results (position, title, URL, snippet, date, sitelinks) and related searches. One result = one results page (~10 links).
Find local businesses on Google Maps by keyword and location: name, address, phone, website, rating, review count, opening hours, coordinates.
Reviews of a Google Maps place (by place ID or URL): text, stars, date, owner replies.
News articles from Google News for a search (operators work: "exact phrase", OR, -word, site:, intitle:), optionally within a time window: title, source, date and the article's link on the publisher's site.
Crawl websites and extract emails, phone numbers and social profile links. One result = one website (up to 5 of its pages crawled, contacts merged).
Tweets matching search terms, hashtags or from given handles: text, author, engagement, date. Each search term takes X's advanced search operators (from:, since:, min_faves:, filter:, lang: …).
Profile details for X/Twitter handles: bio, followers, following, verification, counts.
Instagram profile details by username: bio, followers, posts count, recent posts.
Recent posts from Instagram profiles: caption, likes, comments count, media, owner with follower counts, date.
Comments on Instagram posts or reels by URL: text, likes, replies count, author, date.
TikTok videos for keywords or hashtags: caption, views, likes, shares, author, music.
A TikTok account's videos with the author's follower and like counts.
Comments on a TikTok video by URL.
YouTube videos for search keywords, or from YouTube links (search results, channel, playlist or video URLs): title, views, likes, comments count, duration, channel, date.
Full transcripts (captions) of YouTube videos, with timestamps: one per video link, in the language you ask for when the video has it.
Comments on YouTube videos or Shorts: text, likes, replies count, author, date. Sorted by top or latest.
Public LinkedIn profile by URL: headline, experience, education, skills, location.
LinkedIn company pages: description, industry, size, headquarters, website, followers.
LinkedIn job postings for a title/skill and location (or a jobs search URL): title, company, location, salary, posted date, applicants, description.
Recent posts from LinkedIn profiles or company pages, with engagement counts.
Search LinkedIn people by keyword, location, company and title. One call returns up to 25 short profiles.
Reddit posts for a query or subreddit: title, body, score, comments count, author, date.
A Reddit thread's post and comments by URL: text, score, author, date, reply depth.
Posts from public Facebook pages (or groups): text, reactions, comments and shares counts, photos, date.
Ads from the Meta Ad Library for a search URL: creative, copy, start date, advertiser.
Full Amazon product page by ASIN: price, rating, features, images, seller, rank.
Customer reviews for an Amazon ASIN: stars, title, text, date, verified purchase. Reviews come in pages of 10 (maxPages in the input).
Indeed job postings by title and location: company, salary, posted date, description.
Trustpilot reviews of a company by domain: stars, text, date, reply.
Apple App Store reviews for an app ID and country.
Google Play Store reviews for an Android app.
Hotels on Booking.com for a destination (and dates): name, price for the stay, review score, stars, address, free cancellation.
Airbnb listings for a place and dates: price for the stay and per night, rating, reviews, host, amenities, house rules, photos.
Google Trends interest over time and by region for a keyword.
Threads posts from users, a keyword search or a thread: text, likes, replies, reposts, views, media, date.
Pinterest pins for a search: image, title, link, saves.
eBay listings for keywords (first results page): price, condition, seller, shipping.
Shopee products for keywords (or Shopee links) in a country: title, price, discount, rating, location, shop.
AliExpress products for a search: price, orders, rating, store.
Glassdoor job postings by keyword and location.
Zillow homes for sale, for rent or recently sold in ZIP codes: price, beds, baths, living area, address, Zestimate.
Tripadvisor hotels, restaurants and attractions for a location.
G2 reviews of a software product.
Messages from public Telegram channels posted on or after oldestMessageDate (YYYY-MM-DD).
Xiaohongshu (RED) notes for a keyword.
Douyin videos for keywords.
Weibo posts for a keyword.
Crawl a whole website (or a section of it) and return each page as clean, LLM-ready markdown. Good for RAG and documentation sites.
Search a B2B contact database (800M-style Apollo/ZoomInfo data) by job title, seniority, location, industry, company size and more: name, title, work email and status, phone, LinkedIn, company domain, size, industry and revenue.
Local businesses from Google Maps plus the emails, phones and social links found on their websites. Built for local lead lists.
Employees of LinkedIn companies, filterable by job title, location and keyword: name, headline, position, profile URL.
Check whether email addresses are deliverable: syntax, domain, MX records and mailbox status.
Work email address for LinkedIn profile URLs.
Reels from Instagram profiles: caption, views, likes, comments, video URL, date.
Posts or reels for Instagram hashtags or keywords: caption, likes, comments, author, media.
Search Instagram for users, places or hashtags by keyword.
Posts from public Facebook groups: text, author, reactions, comments count, date.
Comments on public Facebook posts or reels by URL.
Videos from YouTube channels (handles such as @MrBeast, or channel URLs): title, views, likes, comments count, duration, date.
Shorts from YouTube channels: title, views, likes, comments, date.
Recent posts from LinkedIn company pages with engagement counts.
Search LinkedIn companies by keyword, location and size: name, industry, size, URL.
An advertiser's ads from the Google Ads Transparency Center: format, text, dates shown, regions.
Spoken-word transcripts of TikTok videos by URL.
Guest reviews of Booking.com hotels: score, likes, dislikes, traveler type, date.
Reviews of Tripadvisor hotels, restaurants and attractions: rating, title, text, date, trip type.
What items actually sold for on eBay: sold price, shipping, condition, end date. For price research and valuation.
Estimated traffic for websites from Similarweb: monthly visits, ranks, traffic sources, top countries, engagement.
Listings from a Facebook Marketplace search or category URL: title, price, location, photos.
Amazon Best Sellers for a category: rank, title, price, rating, ASIN.
Freelance jobs on Upwork for a search: title, budget or rate, skills, client history, posted time.
Fresh job postings straight from companies' own career sites and ATSs (Greenhouse, Lever, Workday…), searchable by title, location and company.
Ads from the LinkedIn Ad Library for an advertiser or keyword search URL: copy, format, dates.
Replies to X/Twitter posts by URL: text, author, engagement, date.
Full-page screenshot (PNG or PDF) of web pages; returns a link to the image.
Flight options and prices from Google Flights for a route and dates: airlines, times, stops, duration, price.
A TikTok Shop product page by URL: price, sales, rating, shop, variants.
Medium articles by keyword search, tag, author, publication or link, with their text as Markdown: title, subtitle, author, publication, claps, responses, reading time, tags, date. Member-only stories give Medium's public preview (flagged).
Upcoming Eventbrite events for a US city, optional keywords and a date window (or an Eventbrite search link): name, start and end, venue and address, organizer, price range, online or in person, link.
Taobao and Tmall product pages by link: title, price and promotions, shop, brand, images, specs, sales and variants.
Wholesale products from 1688.com (Alibaba's China B2B market) by keyword: title, tiered price in CNY, minimum order, sales, repurchase rate, supplier and location.
Products from Naver Shopping, Korea's largest shopping search, by keyword or link: name, price and discount, store, rating, review count, category.
Recent posts (videos and image posts) from Douyin creator profiles: caption, date, plays, likes, comments, shares, music, author stats.
Douyin videos by link: caption, title, date, plays, likes, comments, shares, hashtags, music, author, and the video and audio stream links.
Second-hand listings from Xianyu (Goofish, China's largest resale market) by keyword: title, price and original price, condition, city, seller, photos, posted date.
Alibaba.com product listings or suppliers by keyword: price range, minimum order, supplier, years on Alibaba, verification, ratings, delivery estimate.
Software reviews from Capterra for a product: title, date, overall and sub-ratings, pros, cons, comments, reviewer role and company size.
Enterprise software reviews from Gartner Peer Insights: headline, summary, rating, date, reviewer role, industry and company size.
B2B software reviews from TrustRadius: heading, rating, date, use cases, pros, cons, likelihood to recommend, feature ratings, reviewer.
Upcoming trade shows, conferences and workshops from 10times by topic and country: name, dates, venue and city, event type, organizer, link.
Text in an image, read with Google Lens: the full text, or paragraphs, lines and words with positions; optional translation.
Yandex search results pages for a query: organic results (position, title, link, snippet) and ads. Best for Russian-language markets.
US customs import records from ImportYeti: importers and their overseas suppliers, shipment counts and dates, addresses, trademarks.
Find a US person from a name, address, phone number or email: age, current and past addresses, phone numbers with line type, email addresses, relatives. For locating people and reverse lookups; not for employment, credit, tenant or other eligibility decisions.
Public Tinder profile pages that match a name or keyword: username, display name, profile link and page snippet.
Check where a username exists across 400+ social networks, forums and sites (Sherlock): returns the profile links found for each username. Some matches can be false positives.
Craigslist listings for sale, housing, jobs, cars and services in any city: title, price, full description, photos, location with coordinates, category, attributes and posting date.
The websites that send visitors to a domain, ranked by visits (Similarweb Pro referral report, last six months): visits, share of the site's referral traffic, change, new senders, global rank and category. Results are the top 500; page with offset and limit. Find what drives traffic or checkouts, estimate a competitor's reach.
The websites a domain's visitors go on to, ranked by visits (Similarweb Pro referral report, last six months): visits, share, change, global rank and category. Results are the top 500; page with offset and limit.
Connect your agent
Add the MCP server once and your agent can search the catalog, read a tool’s input schema and run it on demand. Or call the REST API directly.
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \ --header "Authorization: Bearer $LOVELY_KEY"
{
"mcpServers": {
"lovely-tools": {
"type": "http",
"url": "https://lovelyrouter.com/mcp",
"headers": { "Authorization": "Bearer <your key>" }
}
}
}# 1. find a tool (or plan a whole task with /v1/tools/suggest {"task": "…"})
curl https://lovelyrouter.com/v1/tools/discover -H "content-type: application/json" \
-d '{"query":"google maps restaurants"}'
# 2. run it (waits up to 60s, then returns 202 + a run id to poll)
curl https://lovelyrouter.com/v1/tools/google-maps-places/run \
-H "Authorization: Bearer $LOVELY_KEY" -H "content-type: application/json" \
-d '{"input":{"searchStringsArray":["coffee"],"locationQuery":"Austin, TX"},"max_results":20}'
# 3. poll a long run
curl https://lovelyrouter.com/v1/tools/runs/run_… -H "Authorization: Bearer $LOVELY_KEY"Billing: a run reserves its maximum cost (per-call fee + per-result fee × max_results) and is settled to what it actually returned. A failed run pays no call fee, only for results it delivered. API docs