ShareGrid APIsharegrid.com ↗
Search, browse, and retrieve camera gear rental and buy listings from ShareGrid.com. Access pricing, location, images, and seller profiles via 3 endpoints.
What is the ShareGrid API?
The ShareGrid API exposes 3 endpoints for searching and inspecting peer-to-peer camera gear listings on ShareGrid.com. The search_listings endpoint returns paginated results across rental and buy categories, including pricing, author details, delivery options, and location data. Developers can drill into individual listings with get_listing_detail or power search-ahead interfaces with autosuggest.
curl -X GET 'https://api.parse.bot/scraper/7b9bcd1e-a039-4604-9e34-c0a30bad759b/search_listings?page=1&query=camera&location=losangeles&max_pages=1&listing_type=rent' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace sharegrid-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.sharegrid_api import ShareGrid, ListingType, ListingNotFound
sg = ShareGrid()
# Search for camera gear in Los Angeles
for listing in sg.listings.search(query="sony fx6", listing_type=ListingType.RENT):
print(listing.title, listing.rental_price, listing.author.name)
# Navigate from summary to full detail
detail = listing.details()
print(detail.times_viewed, detail.watch_count, detail.community.name)
break
# Get a specific listing by ID
full = sg.listings.get(listing_id="391954")
print(full.title, full.rental_price, full.instant_book)
# Autocomplete suggestions for gear discovery
for suggestion in sg.suggestions.search(query="canon", listing_type=ListingType.BUY):
print(suggestion.name, suggestion.product_id)
Full-text search over gear listings in a ShareGrid community. Returns paginated results with listing summaries including pricing, author, location, and delivery options. Pagination via page counter; each page holds up to 48 listings. Supports both rental and buy listing types.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
| queryrequired | string | Search term (e.g., 'camera', 'lens', 'tripod', 'sony fx6') |
| location | string | Community slug for location (e.g., 'losangeles', 'newyork', 'chicago', 'sfbay', 'miami', 'boston', 'denver') |
| max_pages | integer | Maximum number of pages to fetch in a single call |
| listing_type | string | Type of listing to search |
{
"type": "object",
"fields": {
"page": "integer - starting page number",
"listings": "array of listing summary objects",
"total_pages": "integer - total available pages (present when reported by server)",
"pages_fetched": "integer - number of pages actually fetched",
"total_results": "integer - count of listings returned across all fetched pages"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "391954",
"url": "https://www.sharegrid.com/losangeles/l/391954-contax-g2-film-camera-build-your-kit",
"title": "Contax G2 Film Camera (Build Your Kit!)",
"author": {
"id": "bq_I5Grpmr7yabaKkSeqad",
"name": "Retro Rebound Films",
"slug": "chris_wu",
"level": null,
"verified": null,
"avatar_url": "https://d1rzxhvrtciqq1.cloudfront.net/uploads/images/listingimage/1387909/image/big.jpg",
"feedback_count": 24,
"is_rental_house": false,
"feedback_positive_pct": 100
},
"package": {
"can_ship": false,
"can_pickup": true,
"free_shipping": false
},
"location": {
"lat": 34.091,
"lon": -118.299
},
"promoted": null,
"quantity": 1,
"sold_out": false,
"community": "losangeles",
"image_url": "https://d1rzxhvrtciqq1.cloudfront.net/uploads/images/listingimage/1387909/image/big-b5ae48eee0c40ba1d9d708ff96cf9fe4.jpg",
"is_package": true,
"instant_book": false,
"rental_price": 46.75,
"sale_offering": null,
"insurance_price": 9394,
"rental_offering": null,
"repeat_rental_rate": null,
"cheapest_config_price": 55,
"rental_shipping_price": null
}
],
"total_pages": 50,
"pages_fetched": 1,
"total_results": 48
},
"status": "success"
}
}About the ShareGrid API
Search Gear Listings
The search_listings endpoint accepts a required query string (e.g., 'sony fx6', 'anamorphic lens') and an optional location slug such as 'losangeles', 'newyork', or 'sfbay'. Results are paginated at up to 48 listings per page; the page parameter controls where you start, max_pages lets you fetch multiple pages in one call, and total_pages tells you how far the result set extends. Each listing summary in the listings array includes author name, location, delivery options, and pricing. The listing_type parameter filters between rental and buy listings.
Listing Detail
get_listing_detail takes a numeric listing_id from search results and returns the full listing record. That includes a structured author object with id, name, username, level, and feedback_count; an images array with thumb, big, and original URL derivatives for every photo; a product object carrying brand and model; a category object with name, slug, and parent; a package object with description, component_count, and discount_percent; and a location object with latitude and longitude. Active promotions and related suggestions are also included where present.
Autocomplete
The autosuggest endpoint accepts a partial query and returns two typed arrays: products (gear names with product_id and url) and people (vendors and creators with name, username, avatar_url, and url). This is useful for building search-ahead UIs or resolving canonical product names before passing them to search_listings. The optional location and listing_type parameters narrow suggestions to a specific community or listing category.
The ShareGrid API is a managed, monitored endpoint for sharegrid.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sharegrid.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sharegrid.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate rental price data across multiple ShareGrid markets (LA, NYC, Chicago) for gear cost benchmarking.
- Build a production budget tool that queries
search_listingsfor specific camera and lens models and surfaces current rental rates. - Populate a gear discovery feed by pulling
listing_type=buylistings filtered by location slug. - Display seller reputation details from the
author.levelandauthor.feedback_countfields before recommending a rental. - Implement search-ahead in a filmmaking app using the
autosuggestendpoint'sproductsandpeoplearrays. - Pull high-resolution gear images via
imagesarrayoriginalURLs for editorial or comparison content. - Track listing availability by monitoring
quantitychanges on specific listing IDs over time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ShareGrid have an official public developer API?+
What does `get_listing_detail` return beyond what `search_listings` shows?+
get_listing_detail goes deeper than search summaries. It returns the full image set with thumb, big, and original URL variants, a structured product object with brand and model, a category hierarchy including parent, kit package details with component_count and discount_percent, lat/lon coordinates, active promotions, and the author's level and feedback_count.Which geographic markets are supported by the `location` parameter?+
location parameter accepts community slugs documented as losangeles, newyork, chicago, sfbay, miami, boston, and denver. Listings outside these communities may not be reachable by location filter, though an unfiltered query search can still surface them.Does the API expose booking, transaction, or messaging data for listings?+
How does pagination work in `search_listings` and what is the per-page limit?+
page parameter sets the starting page (1-based), and max_pages controls how many consecutive pages are fetched in one call. The response includes total_pages when the server reports it, pages_fetched for how many were actually retrieved, and total_results for the count of listings across all fetched pages.