sharegrid.com APIwww.sharegrid.com ↗
Search and browse ShareGrid camera gear listings by location and keyword. Get rental pricing, listing details, images, author info, and autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/7b9bcd1e-a039-4604-9e34-c0a30bad759b/search_listings?page=1&query=lens&location=newyork&max_pages=1&listing_type=rent' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for gear listings on ShareGrid by location and search term. Returns paginated results with listing details, pricing, author info, and location data. Supports both rental and buy listings.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to start from (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 |
| listing_type | string | Type of listing: 'rent' or 'buy' |
{
"type": "object",
"fields": {
"page": "integer - starting page number",
"listings": "array of listing objects with id, title, url, image_url, instant_book, rental_price, location, author, sale_offering, rental_offering, package info",
"total_pages": "integer - total available pages (if available)",
"pages_fetched": "integer - number of pages actually fetched",
"total_results": "integer - count of listings returned"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "396939",
"url": "https://www.sharegrid.com/losangeles/l/396939-triple-sony-package-fx9-two-fx3s-lenses-tripods-monitors-etc",
"title": "Triple Sony Package - FX9 & Two FX3s - Lenses, Tripods, monitors, etc",
"author": {
"id": "chNazAFvir5Oadbagq7ICb",
"name": "Griswold Media",
"slug": "griswoldmedia",
"level": "elite",
"feedback_count": 764,
"feedback_positive_pct": 100
},
"package": {
"can_ship": false,
"can_pickup": true,
"free_shipping": false
},
"location": {
"lat": 34.1637,
"lon": -118.397
},
"quantity": 1,
"sold_out": false,
"community": "losangeles",
"image_url": "https://d1rzxhvrtciqq1.cloudfront.net/uploads/images/listingimage/1534119/image/big-c9b13e20108f3db03c7798058e8c5a16.jpg",
"is_package": true,
"instant_book": false,
"rental_price": 214.09,
"sale_offering": null,
"rental_offering": null
}
],
"total_pages": 50,
"pages_fetched": 1,
"total_results": 48
},
"status": "success"
}
}About the sharegrid.com API
The ShareGrid API exposes 3 endpoints to search, detail, and autocomplete peer-to-peer filmmaking gear listings across ShareGrid.com. The search_listings endpoint returns paginated results covering rental price, instant-book status, author info, and location data for both rent and buy listings. You can filter by community slug (e.g. 'losangeles', 'newyork') and listing type, then fetch full specs — including kit components, product brand/model, and multi-resolution images — via get_listing_detail.
Search Listings
The search_listings endpoint accepts a required query string (e.g. 'sony fx6', 'anamorphic lens') alongside optional location, listing_type ('rent' or 'buy'), page, and max_pages parameters. Each result object in the listings array includes id, title, url, image_url, instant_book flag, rental_price, location, author, and sale_offering / rental_offer fields. The response also surfaces total_pages and total_results so you can build pagination logic without extra round-trips.
Listing Detail
get_listing_detail takes a listing_id (numeric string from search results) plus optional community and listing_type inputs. The response expands well beyond search summaries: images is an array of objects each carrying thumb, big, and original URLs; package describes kit bundles with a component_count; product carries the gear's brand and model; and category includes a parent for hierarchical browsing. The author object adds level and feedback_count to help assess lender reputation. quantity reflects available stock.
Autocomplete Suggestions
The autosuggest endpoint returns two typed arrays for a given query: products (gear items with name, product_id, and url) and people (vendors/creators with name, username, avatar_url, and url). Both arrays respect the optional location and listing_type filters, making it practical to build a location-aware search-as-you-type UI.
- Build a gear availability dashboard filtered by city using
locationslugs like 'sfbay' or 'chicago' - Compare rental prices across multiple cities for the same camera body by running parallel
search_listingscalls - Display a lender reputation score in a rental workflow using
author.levelandauthor.feedback_countfromget_listing_detail - Power a search-as-you-type field for filmmaking equipment using
autosuggestproduct and people results - Aggregate kit bundle data for production planning by extracting
package.component_countandpackage.description - Track listing availability for specific gear models by polling
get_listing_detailfor thequantityfield - Distinguish buy vs. rent listings in a unified marketplace feed using the
listing_typefilter onsearch_listings
| 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 | 250 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 appears in search results?+
get_listing_detail adds multiple image sizes (thumb, big, original) per listing, kit package details including component count, the gear's product brand and model, a nested category with parent slug, GPS coordinates (lat/lon), available quantity, and expanded author fields (level and feedback count). Search results carry only a single image URL and condensed author info.Which geographic markets does the `location` filter support?+
location parameter accepts community slugs for: losangeles, newyork, chicago, sfbay, miami, boston, and denver. Listings outside these communities are not filterable by location through this parameter. You can fork the API on Parse and revise it to map additional ShareGrid community slugs if your target market isn't in the list.Does the API return user reviews or individual transaction history for a lender?+
author.feedback_count and author.level as reputation signals, but individual review text, star ratings, and transaction records are not returned by any of the three endpoints. You can fork the API on Parse and revise it to add an endpoint targeting lender profile pages where review content appears.How does pagination work in `search_listings`?+
page (starting page, 1-based) and max_pages (cap on pages fetched) input parameters. The response includes total_pages, pages_fetched, and total_results so you can determine how many additional pages exist without issuing a blind follow-up call. If total_pages is unavailable for a given query, the field may be absent from the response.