Use case

Segment enterprise software reviews by buyer role, industry and size

Pull Gartner Peer Insights reviews as JSON with rating, headline, summary, reviewer role, industry and company size, to see what enterprise buyers value.

Prepaid, no subscriptionREST or MCPOne key for models, data and agents
Gartner Peer I…lovelyjsonitems[0]"headline": "Reliable, but admin i…"rating": 4"role": "IT Director""industry": "Manufacturing""company_size": "1B-3B USD""date": "2026-10-02"

Selling to enterprises means knowing what an IT director at a manufacturer cares about, which is not what a marketing lead at a startup cares about. Gartner Peer Insights labels each review by reviewer role, industry and company size, but only one page at a time. Lovely Router reads them for you. Send Gartner product links, get one JSON object per review, pay per review from a prepaid balance. Call it from a script or an AI agent with one API key.

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.

Segment enterprise software reviews by buyer role, industry and size. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- 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`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (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: <the inputs (links, keywords or accounts) and how many results you need>
01

How it works

010203
  1. Choose the products

    Up to 10 Gartner Peer Insights product pages: yours and your rivals.

  2. Run the tool with a cap

    Send them in productUrls with maxResults, which splits the reviews across the products. The run holds its maximum cost from your balance.

  3. Cut by segment

    Group the reviews by role, industry and company size, and compare ratings and the words used in each group.

02

Get Gartner reviews with one request

Get Gartner Peer Insights reviews takes product pages in productUrls. maxResults is the total number of reviews across the products:

curl https://lovelyrouter.com/v1/tools/gartner-reviews/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "productUrls": [
        "https://www.gartner.com/reviews/market/meeting-solutions/vendor/zoom/product/zoom-workplace"
      ],
      "maxResults": 5
    },
    "max_results": 5
  }'

sort is most-recent, most-helpful or least-recent, and starRating filters by stars. Filter to low ratings to read complaints. A run still going after 60 seconds returns 202; Run a tool shows how to poll.

03

What each review holds

Field groupWhat you get
Review textHeadline and summary
RatingStar rating
DateWhen it was written
ReviewerRole, industry and company size

Because role, industry and size come with the review, you can build segment tables without guessing from the text.

04

Recipes

Learn what each segment values

Pull 300 reviews and group them by company size; ask a model what the largest companies praise and criticize.

Build a battlecard for one industry

Keep the reviews from your target industry and list the rival's weaknesses there.

Find objections to expect

Filter starRating to low scores and read the summaries for the objections your sales team will meet.

Prepare an analyst briefing

Show the recent reviews of your product (sort set to most-recent) sorted by role.

Check a vendor before you buy

If you are the buyer, read the reviews from companies of your size and industry.

Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Read the 100 most recent Gartner Peer Insights reviews for these three products, group them by reviewer role, and list what IT directors complain about. Set max_results to 300."

06

What you pay

You pay per review: starting a run holds its maximum cost, the per-call fee plus the per-review fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the reviews it delivered, and a run refused at the start costs nothing.

Reading 300 reviews a quarter is billed as 300 reviews a quarter. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.

07

Frequently asked questions

?
What do I get besides the rating?+

The headline, the summary, the date, and the reviewer's role, industry and company size.

How many products can I pass?+

Up to 10 product pages per run. maxResults is split across them.

Can I get only low ratings?+

Yes. Set starRating to the stars you want; leave it empty for all ratings.

Do I need a Gartner account?+

No. You send product links and an API key.

Do I need a subscription?+

No. You add credit to a prepaid balance and each run draws it down. Nothing renews automatically.

More on the same theme: review monitoring, lead generation and the tool catalog.

One prepaid key for models, data and agents

No subscription. Top up, use what you need, see every charge in your logs.