# LoopNet Search ## Overview | Property | Value | |----------|-------| | **Status** | inactive | | **Method** | `GET` | | **Endpoint** | `/v2/loopnet/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/loopnet-search | ## Description Search LoopNet commercial listings by city or by a results URL. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/loopnet/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### New York for sale, 484 Amsterdam Ave ```json { "results": [ { "url": "https://www.loopnet.com/Listing/484-Amsterdam-Ave-New-York-NY/31379002/", "city": "New York", "image": "https://images1.loopnet.com/i2/n72IA42dlAZTU0D5kvXnJ81X-x2jGvgVig2wkZ0zIkk/117/image.jpg", "price": 8900000, "state": "NY", "title": "484 Amsterdam Ave", "units": 13, "address": "New York, NY 10024", "country": "US", "summary": "Five-story residential walk-up on the Upper West Side featuring 12 residential apartments, a ground-floor commercial unit, and recent renovations.", "cap_rate": 5.12, "currency": "USD", "lot_count": null, "listing_id": "31379002", "year_built": null, "broker_name": "Michelle Blake", "postal_code": "10024", "listing_tier": "platinum", "listing_type": "PropertyForSale", "starting_bid": null, "bid_increment": null, "price_display": "$8,900,000", "property_type": "Multifamily", "broker_company": "Keyah Enterprises, Inc", "lot_size_acres": null, "property_count": null, "year_renovated": null, "lot_size_display": null, "property_subtype": "Apartment", "transaction_type": "ForSale", "building_size_sqft": null, "starting_bid_display": null, "bid_increment_display": null, "building_size_display": null } ], "pagination": { "next": "https://www.loopnet.com/search/commercial-real-estate/new-york-ny/for-sale/2/", "page": 1, "per_page": 40, "total_pages": null, "total_results": 750 } } ``` ## Documentation ## Overview Search commercial real estate for sale on LoopNet. `New York, NY` calls `/search/commercial-real-estate/new-york-ny/for-sale/`. You can also send a LoopNet `/search/` URL. The response is `{ results, pagination }`. `price` is the amount printed on the card, and `price_display` is that label, such as `$8,900,000`. A trailing dash is removed. When the card says `Price Upon Request`, `price` is null. On an auction card, `price` is the starting bid, and `starting_bid` repeats that amount. ## Quickstart ``` GET https://api.piloterr.com/v2/loopnet/search?query=New%20York%2C%20NY GET https://api.piloterr.com/v2/loopnet/search?query=https://www.loopnet.com/search/commercial-real-estate/new-york-ny/for-sale/&page=2 ``` Pass `results[].url` to `/v2/loopnet/property`. `listing_id` is the numeric id in that URL. ## Parameters | Parameter | Required | Example | |---|---|---| | `query` | yes | `New York, NY` | | `page` | no | `2` | `query` is a city and state, or a loopnet.com URL whose path contains `/search/`. A listing URL is rejected here. `page` starts at 1. A page already present in a search URL is kept when you omit `page` or pass `1`. A value of `2` or higher overrides it. ## Response fields | Field | Type | Meaning | |---|---|---| | `results[].listing_id` | string | Listing id | | `results[].url` | string | Listing URL | | `results[].title` | string or null | Building or listing name | | `results[].address` | string or null | Address line on the card | | `results[].city` | string or null | City | | `results[].state` | string or null | State code | | `results[].postal_code` | string or null | ZIP code | | `results[].country` | string or null | Country code | | `results[].property_type` | string or null | LoopNet property type | | `results[].property_subtype` | string or null | Subtype printed on the card | | `results[].price` | number or null | Printed amount. Null for `Price Upon Request` | | `results[].price_display` | string or null | Printed label, without a trailing dash | | `results[].currency` | string or null | Currency of the printed amount, such as `USD` | | `results[].cap_rate` | number or null | Cap rate percent | | `results[].units` | number or null | Unit count printed on the card | | `results[].building_size_sqft` | number or null | Building size in square feet | | `results[].image` | string or null | Card image | | `results[].broker_name` | string or null | Broker name | | `results[].broker_company` | string or null | Brokerage | | `results[].starting_bid` | number or null | Auction starting bid | | `pagination.page` | integer | Page you asked for | | `pagination.per_page` | integer | Cards on this page | | `pagination.total_results` | number or null | Floor when the heading uses `+`, otherwise the printed count | | `pagination.total_pages` | number or null | Null when the heading is a floor such as `750+` | | `pagination.next` | string or null | Next page URL, or null | ## Pagination `page` starts at 1. Ids are unique on a page. When the heading says `750+`, `total_results` is `750` and `total_pages` is null. `next` is still the following page URL when LoopNet prints one. The unit count on a card can differ from the listing page. Each page prints its own figure. ## Use cases - A broker searches `New York, NY` and drops cards whose `price_display` is `Price Upon Request`. - An analyst compares `cap_rate` and `units` on multifamily cards. - A researcher opens a `/search/` URL and follows `pagination.next`. ## Error codes | Code | Meaning | |---|---| | `400` | Empty query, a host other than loopnet.com, a listing URL sent to search, or a page below 1 | | `401` | Missing API key | | `404` | The page had no listing cards | | `500` | The fetch failed | ## Related endpoints [LoopNet Property](https://www.piloterr.com/library/loopnet-property)