# Goro

> One connection gives your agent search, scraping and enrichment across the real world. One balance, pay per call, no subscription.

## Docs

- [Discover](https://docs.usegoro.ai/api/discover.md): POST /v1/discover. Rank the catalog against a plain-English query and get each match with its price and a fillable sample input.
- [Downloads](https://docs.usegoro.ai/api/downloads.md): Every generated file gets a Goro link that saves it. One address, one expiry, and nothing re-hosted.
- [Inspect](https://docs.usegoro.ai/api/inspect.md): POST /v1/inspect. Read one tool's real input schema, a fillable sample input, an output sample and its price.
- [API overview](https://docs.usegoro.ai/api/overview.md): Base URL, authentication, money format, pagination and the full error contract.
- [Run](https://docs.usegoro.ai/api/run.md): POST /v1/run. Execute a tool, get the rows inline when it is fast, or a run id to poll when it is not.
- [Runs](https://docs.usegoro.ai/api/runs.md): List your runs, poll one to completion, or stop one that is still going.
- [Uploads](https://docs.usegoro.ai/api/uploads.md): POST /v1/uploads. Send a file to Goro out of band, then name it in the run with a short handle instead of its bytes.
- [Wallet](https://docs.usegoro.ai/api/wallet.md): GET /v1/wallet/balance and GET /v1/wallet/activities. What is available to spend, and the ledger that explains it.
- [goro discover](https://docs.usegoro.ai/cli/discover.md): Find the tools that can answer a plain-English question, with the price of each.
- [Examples](https://docs.usegoro.ai/cli/examples.md): Recipes: piping to jq, scripting on exit codes, batching inputs, and running against a local gateway.
- [goro inspect](https://docs.usegoro.ai/cli/inspect.md): Read a tool's real input schema, its price and a sample input you can send as-is.
- [goro keys](https://docs.usegoro.ai/cli/keys.md): Store, list and switch API keys, without a secret ever reaching your screen or your shell history.
- [CLI](https://docs.usegoro.ai/cli/overview.md): Drive the gateway from a terminal or a script: discover a tool, inspect it, run it, and see what it cost.
- [goro run](https://docs.usegoro.ai/cli/run.md): Run a tool, with the input inline or from a file, synchronously or by polling.
- [goro runs](https://docs.usegoro.ai/cli/runs.md): Poll a single run to completion, or list what you have run recently and what it cost.
- [For humans](https://docs.usegoro.ai/guide/quickstart-cli.md): Sign in, get a key, make a call from your terminal, and see exactly what it cost.
- [For AI agents: MCP](https://docs.usegoro.ai/guide/quickstart-mcp.md): Add Goro to Claude, Cursor or any MCP client as a connector, and your agent gets the whole catalog as six tools.
- [For applications: OAuth](https://docs.usegoro.ai/guide/quickstart-oauth.md): Connect your product to Goro on a user's behalf with OAuth 2.1, PKCE and dynamic client registration.
- [For AI agents: Skill](https://docs.usegoro.ai/guide/quickstart-skill.md): Teach an agent the whole gateway with one markdown file and an API key. No client library, no MCP client.
- [Introduction](https://docs.usegoro.ai/index.md): One connection gives your agent search, scraping and enrichment across the real world.
- [Pricing](https://docs.usegoro.ai/pricing.md): What a call costs: an exact price where one exists, a rate and a ceiling where it cannot exist, and never a charge above the ceiling.
- [Amazon product details](https://docs.usegoro.ai/tools/ecommerce/amazon-product.md): The full detail page for specific Amazon ASINs or product URLs: title, brand, price and list price, rating count and star distribution, availability, bullet poi
- [Amazon product reviews](https://docs.usegoro.ai/tools/ecommerce/amazon-reviews.md): Customer reviews for one or more Amazon ASINs, with rating, title, body text, author name, date, verified purchase and Vine flags, helpful votes, attached image
- [Amazon reviews (global)](https://docs.usegoro.ai/tools/ecommerce/amazon-reviews_global.md): Amazon customer reviews across more than 20 regional domains, with star, keyword, media, date, language and verified purchase filters. Each review carries ratin
- [Amazon search results](https://docs.usegoro.ai/tools/ecommerce/amazon-search.md): Amazon search result pages for one or more keywords. Each product carries its ASIN, title, price and retail price, rating and review count, Prime and sponsored
- [Amazon seller leads](https://docs.usegoro.ai/tools/ecommerce/amazon-sellers_eu.md): Rows from a prebuilt database of Amazon marketplace sellers: business name and type, company registration and VAT number, published contact details, business ad
- [Google Shopping search](https://docs.usegoro.ai/tools/ecommerce/shopping-search.md): Live Google Shopping listings for a query: product title, merchant, price, product id, image URL, the listing link and the position it held, localized by countr
- [Grok Imagine image](https://docs.usegoro.ai/tools/image/image-grok.md): Generate an original image from a text prompt using xAI Grok Imagine. Returns the URLs of the generated images. Those URLs are temporary: kie.ai deletes generat
- [Nano Banana 2 image](https://docs.usegoro.ai/tools/image/image-nano_banana.md): Generate an original image from a text prompt, or EDIT images you supply, using Google Nano Banana 2 at 2K resolution. Send image_handles, image_urls or image_b
- [Nano Banana Pro image](https://docs.usegoro.ai/tools/image/image-nano_banana_pro.md): Generate an original image from a text prompt, or EDIT images you supply, using Google Nano Banana Pro at 2K resolution. Send image_handles, image_urls or image
- [Seedream 5 Lite image](https://docs.usegoro.ai/tools/image/image-seedream.md): Generate one original image from a text prompt using Seedream 5 Lite, at its 2K quality tier. Returns the URL of the generated image. Those URLs are temporary:
- [Z-Image image](https://docs.usegoro.ai/tools/image/image-z_image.md): Generate one original image from a text prompt using Z-Image, the cheapest and fastest model in the catalog. Returns the URL of the generated image. Those URLs
- [Google Maps places](https://docs.usegoro.ai/tools/maps/maps-places.md): Search Google Maps for places matching a query and get back name, address, rating, review count, phone, website, and coordinates.
- [Google Maps reviews](https://docs.usegoro.ai/tools/maps/maps-reviews.md): Reviews for a Google Maps place, with star rating, review text, publish date, owner response, review images and visit context, alongside the place's own address
- [Tool catalog](https://docs.usegoro.ai/tools/overview.md): Everything your agent can reach through one connection.
- [LinkedIn company employees](https://docs.usegoro.ai/tools/people/linkedin-company_employees.md): Lists the people who work at one or more LinkedIn companies, with filters for job title, seniority, function, location, tenure, and years of experience. Email l
- [LinkedIn job search](https://docs.usegoro.ai/tools/people/linkedin-jobs.md): Searches LinkedIn job postings by title and location, with filters for company, workplace type, employment type, seniority, salary band, and recency. Returns th
- [LinkedIn profile](https://docs.usegoro.ai/tools/people/linkedin-profile.md): Full LinkedIn profile records for a list of profile URLs: headline, current role, employer details, full work history, education, skills, certifications, langua
- [LinkedIn profile search by name](https://docs.usegoro.ai/tools/people/linkedin-search_name.md): Find LinkedIn profiles by a person's first and last name, with optional filters for location, current or past company, school, job title and industry.
- [LinkedIn profile search by keyword](https://docs.usegoro.ai/tools/people/linkedin-search_services.md): Searches LinkedIn people by a free-text query such as a service, skill, or role ('fractional CFO', 'machine learning engineer') and returns matching profiles, o
- [Google News search](https://docs.usegoro.ai/tools/search/news-search.md): News articles from Google News for one or more keywords, sections or topic URLs, with headline, publisher, publish time, link and image, in any of 80 region and
- [Web search](https://docs.usegoro.ai/tools/search/web-search.md): Run a Google web search and get back ranked organic results with title, url, and snippet.
- [Facebook Ads Library](https://docs.usegoro.ai/tools/social/facebook-ads.md): Ads from the public Facebook Ads Library for a page or a keyword search, with creative body, headline, call to action, landing URL, run dates, platforms and pag
- [Facebook post comments](https://docs.usegoro.ai/tools/social/facebook-comments.md): Comments and threaded replies on public Facebook posts, reels and videos, with comment text, author name and profile, timestamp, like count and threading depth.
- [Facebook events](https://docs.usegoro.ai/tools/social/facebook-events.md): Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address, organizers, ticket li
- [Facebook group posts](https://docs.usegoro.ai/tools/social/facebook-group_posts.md): Posts from public Facebook groups with post text, author, permalink, timestamp, attachments and reaction, comment and share counts.
- [Facebook page profile](https://docs.usegoro.ai/tools/social/facebook-page.md): Public profile data for Facebook pages: title, category, likes and follower counts, intro text, contact email, website, creation date, ad status and photo URLs.
- [Facebook profile posts](https://docs.usegoro.ai/tools/social/facebook-profile_posts.md): Posts from a public Facebook profile or page feed, with message text, permalink, timestamp, per-type reaction breakdown, comment and share counts, images and vi
- [Facebook page reviews](https://docs.usegoro.ai/tools/social/facebook-reviews.md): Recommendations and reviews left on a public Facebook page, with review text, reviewer, date, recommended or not, attribute tags and engagement counts.
- [Instagram hashtag](https://docs.usegoro.ai/tools/social/instagram-hashtag.md): Posts or reels carrying a given Instagram hashtag, with captions, engagement counts, and author handles.
- [Instagram posts](https://docs.usegoro.ai/tools/social/instagram-posts.md): Recent posts from one Instagram profile with captions, engagement counts, media URLs, and timestamps.
- [Instagram profile](https://docs.usegoro.ai/tools/social/instagram-profile.md): Public profile data for one or more Instagram accounts: follower and following counts, bio, verification, external link, and post count.
- [Instagram search](https://docs.usegoro.ai/tools/social/instagram-search.md): Search Instagram by keyword for hashtags, profiles, or places. Each result carries a type field, and the shape follows it: hashtags return a post count, profile
- [Instagram URL](https://docs.usegoro.ai/tools/social/instagram-url.md): Scrape any public Instagram URL: a profile, post, or reel. Returns posts, comments, reels, or profile details depending on what you ask for.
- [LinkedIn post search](https://docs.usegoro.ai/tools/social/linkedin-post_search.md): Searches LinkedIn posts by keyword with filters for recency, content type, author, author employer, and mentions. Returns post text, media, engagement counts, a
- [LinkedIn profile posts](https://docs.usegoro.ai/tools/social/linkedin-profile_posts.md): Recent posts from specific LinkedIn profiles or company pages, with text, media, engagement counts, and reposts. Reactions and comments can be pulled per post a
- [Reddit API search](https://docs.usegoro.ai/tools/social/reddit-api.md): Reddit posts, comments, communities and users read through Reddit's own API, returning title, body, HTML, upvotes, comment count, author and community for each
- [Reddit posts](https://docs.usegoro.ai/tools/social/reddit-posts.md): Reddit posts and their comments from a search term, subreddit, user profile or direct post URL, with title, body, community, author, timestamps and optionally u
- [TikTok](https://docs.usegoro.ai/tools/social/tiktok-api.md): TikTok data through TikTok's own endpoints: a profile and its stats, a user's posts and likes, posts for a hashtag, keyword search across posts, users, sounds,
- [TikTok profile posts](https://docs.usegoro.ai/tools/social/tiktok-profile.md): Every post from one or more TikTok profiles at the cheapest per item price in the catalog, with views, likes, comments, shares, bookmarks, hashtags, the song, a
- [X followers and following](https://docs.usegoro.ai/tools/social/twitter-followers.md): The follower list, and optionally the following list, of an X (Twitter) account, with each user's handle, display name, bio, location, follower and following co
- [X profile](https://docs.usegoro.ai/tools/social/twitter-profile.md): Public profile data for one or more X (Twitter) accounts: display name, bio, follower and following counts, tweet and media counts, verification status and type
- [Twitter search](https://docs.usegoro.ai/tools/social/twitter-search.md): Search recent tweets on X (Twitter) by keyword, hashtag, or advanced query and get back tweet text, author, and engagement metrics.
- [YouTube comments](https://docs.usegoro.ai/tools/social/youtube-comments.md): Comments on one or more YouTube videos, with author, comment text, vote count, reply count, whether the channel owner wrote it, and how long ago it was posted.
- [YouTube transcript](https://docs.usegoro.ai/tools/social/youtube-transcript.md): Full transcript of a YouTube video as timestamped lines and optionally as one plain text block, alongside the video's title, channel, duration, view and like co
- [YouTube videos](https://docs.usegoro.ai/tools/social/youtube-videos.md): YouTube videos from a search term, channel, playlist or direct URL, with title, channel, view and like counts, duration, upload date, description and hashtags.
- [Grok Imagine video](https://docs.usegoro.ai/tools/video/video-grok.md): Generate a video from a text prompt using xAI Grok Imagine, at 720p with sound, or animate a still image you supply. Returns the URL of the generated MP4. That
- [Kling 3.0 Turbo video](https://docs.usegoro.ai/tools/video/video-kling.md): Animate a still image into a video using Kling 3.0 Turbo, at 720p. You supply one image and a prompt describing how it should move. The image can be a file you
- [MiniMax H3 video](https://docs.usegoro.ai/tools/video/video-minimax.md): Generate a video from a text prompt using MiniMax H3 (Hailuo 03) at 2K with native audio, or animate a still image you supply. Returns the URL of the generated
- [Seedance 2.0 Mini video](https://docs.usegoro.ai/tools/video/video-seedance.md): Generate a video from a text prompt using ByteDance Seedance 2.0 Mini, at 720p with optional audio, or animate a still image you supply. Returns the URL of the
- [Seedance 2.0 video](https://docs.usegoro.ai/tools/video/video-seedance_pro.md): Generate a video from a text prompt using ByteDance Seedance 2.0, the full model, at 720p with optional audio, or animate a still image you supply. Returns the
- [Veo 3.1 video](https://docs.usegoro.ai/tools/video/video-veo.md): Generate an 8 second video with sound using Google Veo 3.1 at its Quality tier in 1080p, from a text prompt or from a still image you supply. Returns the URL of
- [Clone a voice](https://docs.usegoro.ai/tools/voice/voice-clone.md): Create a reusable voice model from one or more recordings of a person speaking, and get back a voice_id you can pass to voice.speak. Requires an explicit consen
- [Delete a voice](https://docs.usegoro.ai/tools/voice/voice-delete.md): Permanently delete one of your cloned voices, at the provider as well as here. After this the voice_id stops working and nothing further is charged for keeping
- [List your voices](https://docs.usegoro.ai/tools/voice/voice-list.md): List the voice models this workspace owns, with the id to pass to voice.speak, when each was created and what consent was attested for it.
- [Text to speech](https://docs.usegoro.ai/tools/voice/voice-speak.md): Turn text into natural speech and get back a link to the audio file. Choose the model, the output format and the speaking rate.
- [Speech to text](https://docs.usegoro.ai/tools/voice/voice-transcribe.md): Transcribe an audio file into text, with the detected language, the total duration and per-segment timings when you ask for them.