> ## Documentation Index > Fetch the complete documentation index at: https://docs.perceptlayer.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com. > Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body. > A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}. > AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer . > Get a free key at https://perceptlayer.com/signup. # Zillow: Search > Search from Zillow. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Zillow API overview](https://perceptlayer.com/apis/zillow) for every Zillow endpoint. ## OpenAPI ````yaml /openapi.json get /v1/zillow/search openapi: 3.1.0 info: title: Perceptlayer API version: 1.0.0 description: >- One API key for structured web data. Each successful call costs the credits shown on its endpoint; failed calls are free. servers: - url: https://api.perceptlayer.com security: - ApiKeyAuth: [] tags: - name: 99acres - name: Agoda - name: Airbnb - name: AliExpress - name: Apartments.com - name: Apple App Store - name: Aramisauto - name: Arbeitsagentur Jobs - name: Argenprop - name: Autohero - name: AutoScout24 - name: AutoTempest - name: AutoTrack.nl - name: Autotrader - name: AutoTrader.ca - name: AutoTrader UK - name: AutoUncle - name: Autovit - name: Baidu - name: Bandcamp - name: Bayut - name: Behance - name: Bien'ici - name: Bilbasen - name: Bilibili - name: Billiger.de - name: Bing - name: Blocket Bil - name: Bluesky - name: Boliga - name: Booking.com - name: Booli - name: Brave Search - name: Bring a Trailer - name: Capterra - name: CarDekho - name: CarGurus - name: CarMax - name: Cars & Bids - name: Cars.com - name: Cars24 - name: Carsales - name: Carvana - name: Carwow - name: Casa.it - name: Centris - name: Coches.net - name: Copart - name: Craigslist - name: Crexi - name: Daft.ie - name: Dailymotion - name: DBA - name: Depop - name: DeviantArt - name: Dice - name: Domain Availability - name: Domain.com.au - name: Dribbble - name: Dubizzle - name: DuckDuckGo - name: eBay - name: Economy Car Rentals - name: Edmunds - name: Eventbrite - name: Expedia - name: Facebook - name: Facebook Ad Library - name: Fincaraiz - name: FINN - name: FINN Bil - name: Flickr - name: FlixBus - name: Fotocasa - name: Geizhals - name: Genius - name: GetYourGuide - name: GitHub - name: Glassdoor - name: Goodreads - name: Google Ads Transparency - name: Google Events - name: Google Finance - name: Google Flights - name: Google Forums - name: Google Hotels - name: Google Images - name: Google Jobs - name: Google Lens - name: Google Local - name: Google Local Services - name: Google Maps - name: Google News - name: Google Patents - name: Google Play - name: Google Related Questions - name: Google Scholar - name: Google Search - name: Google Shopping - name: Google Short Videos - name: Google Translate - name: Google Travel Explore - name: Google Trends - name: Google Videos - name: Gumtree - name: Habitaclia - name: Hacker News - name: Hemnet - name: heycar - name: HolidayCheck - name: Holidu - name: Homegate - name: HomeToGo - name: Hostelworld - name: HotPads - name: IAAI - name: Idealista - name: Idealo - name: Imgur - name: ImmobilienScout24 - name: ImmobilienScout24 Austria - name: ImmoScout24 Switzerland - name: Immoweb - name: Immowelt - name: Imovirtual - name: Impressum Extraction - name: Indeed - name: InfoJobs - name: Inmuebles24 - name: Instagram - name: Jameda - name: Kavak - name: Kayak Flights - name: Kayak - name: Kelley Blue Book - name: Kick - name: Kijiji - name: Kiwi.com - name: Kleinanzeigen - name: kununu - name: Kwai - name: La Centrale - name: Leboncoin Autos - name: Leboncoin Immo - name: Lemmy - name: Letterboxd - name: Link in Bio - name: LinkedIn - name: Linktree - name: LLM Answers - name: LoopNet - name: Madlan - name: MagicBricks - name: Marktplaats - name: Marktplaats Autos - name: Mastodon - name: Medium - name: Mercado Libre - name: Metrocuadrado - name: Milanuncios - name: Mixcloud - name: mobile.de - name: Motors.co.uk - name: MyAnimeList - name: Naukri - name: Naver - name: North Data - name: Odysee - name: OfferUp - name: Ohne-Makler - name: OLX Poland - name: Omio - name: OnTheMarket - name: Otodom - name: Otomoto - name: Patreon - name: Pinterest - name: Private Property - name: Product Hunt - name: Property Finder - name: realestate.com.au - name: Realtor.ca - name: Redfin - name: Reed - name: Rentalcars.com - name: Rentalia - name: Ricardo - name: Rightmove - name: Rumble - name: SEEK - name: SeLoger - name: Semrush - name: Similarweb - name: Skyscanner - name: Snapchat - name: SoundCloud - name: SpareRoom - name: Spotahome - name: Spotify - name: Sreality - name: Standvirtual - name: Startpage - name: Steam - name: StepStone - name: Subito - name: Subito Motori - name: Substack - name: SuperCasa - name: Telegram - name: Threads - name: TikTok - name: Trade Me Property - name: Trainline - name: Tripadvisor - name: Trivago - name: TrueCar - name: Trulia - name: Trusted Shops - name: Trustpilot - name: Truth Social - name: Tumblr - name: tutti.ch - name: Twitch - name: Viator - name: Vimeo - name: Vinted - name: VivaReal - name: VK - name: Vrbo - name: Wallapop - name: Walmart - name: Web Scraper - name: Weibo - name: Welcome to the Jungle - name: WG-Gesucht - name: willhaben - name: wlw - name: X (Twitter) - name: XING Jobs - name: Yad2 - name: Yaencontre - name: Yahoo Search - name: Yelp - name: YouTube - name: Zillow - name: Zonaprop - name: Zoopla - name: Zumper paths: /v1/zillow/search: get: tags: - Zillow summary: Search description: Search from Zillow. Costs 1 credit per successful call. operationId: zillow_search parameters: - name: latitude in: query required: false schema: type: number example: 47.6062 - name: longitude in: query required: false schema: type: number example: -122.3321 - name: radius_mi in: query required: false schema: type: number example: 5 - name: north_latitude in: query required: false schema: type: number - name: south_latitude in: query required: false schema: type: number - name: east_longitude in: query required: false schema: type: number - name: west_longitude in: query required: false schema: type: number - name: region_ids[] in: query required: false schema: type: array items: type: integer - name: region_id_type in: query required: false schema: type: integer - name: polygon in: query required: false schema: type: string maxLength: 4000 - name: listing_category in: query required: false schema: type: string enum: - all - category1 - category2 example: category1 - name: sort_order in: query required: false schema: type: string enum: - baths - yearBuilt - price - relevance - beds - daysOn - featured - livingArea - lotArea - nearby - recentlyChanged - rentalDays - rentalPriorityScore - name: sort_ascending in: query required: false schema: type: boolean - name: min_price in: query required: false schema: type: integer - name: max_price in: query required: false schema: type: integer - name: min_beds in: query required: false schema: type: integer - name: max_beds in: query required: false schema: type: integer - name: min_baths in: query required: false schema: type: integer - name: max_baths in: query required: false schema: type: integer - name: living_area_min in: query required: false schema: type: integer - name: lot_size_min in: query required: false schema: type: integer - name: year_built_min in: query required: false schema: type: integer - name: home_statuses[] in: query required: false schema: type: array items: type: string enum: - newConstruction - forRent - auction - foreclosed - fsbo - recentlySold - foreclosure - comingSoon - preforeclosure - fsba - name: keywords in: query required: false schema: type: string maxLength: 120 - name: zoom_level in: query required: false schema: type: integer - name: include_off_market in: query required: false schema: type: boolean - name: allow_empty in: query required: false schema: type: boolean - name: page in: query required: false schema: type: integer - name: page_size in: query required: false schema: type: integer example: 20 responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-Credits-Used: $ref: '#/components/headers/CreditsUsed' X-Credits-Remaining: $ref: '#/components/headers/CreditsRemaining' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' content: application/json: schema: type: object properties: data: type: object properties: listings: type: array items: type: object properties: zpid: type: integer location: type: object properties: latitude: type: number longitude: type: number address: type: object properties: streetAddress: type: string zipcode: type: string city: type: string state: type: string media: type: object properties: propertyPhotoLinks: type: object properties: mediumSizeLink: type: string highResolutionLink: type: string hasVRModel: type: boolean hasVideos: type: boolean hasIMX: type: boolean hasApprovedThirdPartyVirtualTour: type: boolean allPropertyPhotos: type: object properties: medium: type: array items: type: string highResolution: type: array items: type: string title: type: string isFeatured: type: boolean isShowcaseListing: type: boolean propertyHasLasViolation: type: boolean mapDotTag: type: object properties: name: type: string rental: type: object properties: areApplicationsAccepted: type: boolean hasVirtualTour: type: boolean currency: type: string country: type: string bestGuessTimeZone: type: string isUnmappable: type: boolean listCardRecommendation: type: object properties: flexFieldRecommendations: type: array items: type: string bathrooms: type: integer bedrooms: type: integer livingArea: type: integer yearBuilt: type: integer lotSizeWithUnit: type: object properties: lotSize: type: number lotSizeUnit: type: string propertyType: type: string listing: type: object properties: listingStatus: type: string marketingStatus: type: string palsId: type: string listingSubType: type: object properties: isFSBA: type: boolean isPreforeclosureAuction: type: boolean price: type: object properties: value: type: integer pricePerSquareFoot: type: integer estimates: type: object properties: zestimate: type: integer zillowOwnedProperty: type: object properties: isZillowOwned: type: boolean hdpView: type: object properties: listingStatus: type: string price: type: integer hdpUrl: type: string personalizedResult: type: object properties: isViewed: type: boolean userRecommendation: type: object properties: isRecommendedForYou: type: boolean propertyDisplayRules: type: object properties: canShowAddress: type: boolean canShowOnMap: type: boolean mls: type: object properties: mlsName: type: string mlsStatus: type: string providerLogoOnMap: type: string listingCategory: type: string ssid: type: integer hasFloorPlan: type: boolean richMedia: type: array items: type: object properties: rmxData: type: array items: type: string taxAssessment: type: object properties: taxAssessedValue: type: integer taxAssessmentYear: type: string count: type: integer total_matching_count: type: integer page: type: integer page_size: type: integer listing_category_counts: type: array items: type: object properties: totalMatching: type: integer listingCategory: type: string listing_category_counts_note: type: string freshness: type: array items: type: string paging_note: type: string description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: data: listings: - zpid: 2068074790 location: latitude: 47.592564 longitude: -122.386925 address: streetAddress: 1124 Sunset Avenue SW zipcode: '98116' city: Seattle state: WA media: propertyPhotoLinks: mediumSizeLink: >- https://photos.zillowstatic.com/fp/4218b6d4de5511b0d968347ddf298954-p_c.jpg highResolutionLink: >- https://photos.zillowstatic.com/fp/4218b6d4de5511b0d968347ddf298954-p_f.jpg hasVRModel: true hasVideos: false hasIMX: true hasApprovedThirdPartyVirtualTour: false allPropertyPhotos: medium: - >- https://photos.zillowstatic.com/fp/4218b6d4de5511b0d968347ddf298954-p_c.jpg - >- https://photos.zillowstatic.com/fp/10855466fa66e19b3eb3e1af214b7134-p_c.jpg - >- https://photos.zillowstatic.com/fp/4409ab8198e5504fdf72554d5f539e6d-p_c.jpg highResolution: - >- https://photos.zillowstatic.com/fp/4218b6d4de5511b0d968347ddf298954-p_f.jpg - >- https://photos.zillowstatic.com/fp/10855466fa66e19b3eb3e1af214b7134-p_f.jpg - >- https://photos.zillowstatic.com/fp/4409ab8198e5504fdf72554d5f539e6d-p_f.jpg title: West Seattle L&I Co 1st Of isFeatured: false isShowcaseListing: true propertyHasLasViolation: false mapDotTag: name: showcase rental: areApplicationsAccepted: false hasVirtualTour: true currency: usd country: usa bestGuessTimeZone: America/Los_Angeles isUnmappable: false listCardRecommendation: flexFieldRecommendations: - … - … - … bathrooms: 6 bedrooms: 4 livingArea: 7870 yearBuilt: 2015 lotSizeWithUnit: lotSize: 0.2652 lotSizeUnit: acres propertyType: singleFamily listing: listingStatus: forSale marketingStatus: active palsId: 39001_2591845 listingSubType: isFSBA: true isPreforeclosureAuction: false price: value: 14000000 pricePerSquareFoot: 1779 estimates: zestimate: 13068300 zillowOwnedProperty: isZillowOwned: false hdpView: listingStatus: forSale price: 14000000 hdpUrl: >- /homedetail/MobileAppHDPShopperPlatformServicePage.htm?fromApp=true&p=iphone&variant=SHOWCASE#zpid=2068074790&homeDetailsVariant=SHOWCASE&webviewLayout=doubleScroll&showFactsAndFeatures=true&fromApp=true&gmaps=false&streetview=false personalizedResult: isViewed: false userRecommendation: isRecommendedForYou: false propertyDisplayRules: canShowAddress: true canShowOnMap: true mls: mlsName: NWMLS as distributed by MLS GRID mlsStatus: Active providerLogoOnMap: >- https://photos.zillowstatic.com/fp/033de87a0051f29108423257c615e0b5-zillow_apps_95_35.jpg listingCategory: category1 ssid: 39 hasFloorPlan: true richMedia: - rmxData: - … - zpid: 49046647 location: latitude: 47.616028 longitude: -122.290596 address: streetAddress: 1627 33rd Avenue zipcode: '98122' city: Seattle state: WA media: propertyPhotoLinks: mediumSizeLink: >- https://photos.zillowstatic.com/fp/ab5afde65d0c3e01e9e18c81c23c3453-p_c.jpg highResolutionLink: >- https://photos.zillowstatic.com/fp/ab5afde65d0c3e01e9e18c81c23c3453-p_f.jpg hasVRModel: true hasVideos: false hasIMX: true hasApprovedThirdPartyVirtualTour: false allPropertyPhotos: medium: - >- https://photos.zillowstatic.com/fp/ab5afde65d0c3e01e9e18c81c23c3453-p_c.jpg - >- https://photos.zillowstatic.com/fp/37cfa3ef6dd145714431eb399337db14-p_c.jpg - >- https://photos.zillowstatic.com/fp/02d28b9f0d7480eafb9857446e13dc53-p_c.jpg highResolution: - >- https://photos.zillowstatic.com/fp/ab5afde65d0c3e01e9e18c81c23c3453-p_f.jpg - >- https://photos.zillowstatic.com/fp/37cfa3ef6dd145714431eb399337db14-p_f.jpg - >- https://photos.zillowstatic.com/fp/02d28b9f0d7480eafb9857446e13dc53-p_f.jpg title: Scenic Heights Supl Plat isFeatured: false isShowcaseListing: true propertyHasLasViolation: false mapDotTag: name: showcase rental: areApplicationsAccepted: false hasVirtualTour: false currency: usd country: usa bestGuessTimeZone: America/Los_Angeles isUnmappable: false listCardRecommendation: flexFieldRecommendations: - … - … bathrooms: 2 bedrooms: 4 livingArea: 2100 yearBuilt: 1974 lotSizeWithUnit: lotSize: 3933.468 lotSizeUnit: squareFeet propertyType: singleFamily listing: listingStatus: forSale marketingStatus: comingSoon palsId: 39001_2564211 listingSubType: isComingSoon: true isPreforeclosureAuction: false price: value: 1050000 pricePerSquareFoot: 500 zillowOwnedProperty: isZillowOwned: false taxAssessment: taxAssessedValue: 949000 taxAssessmentYear: '2025' hdpView: listingStatus: forSale price: 1050000 hdpUrl: >- /homedetail/MobileAppHDPShopperPlatformServicePage.htm?fromApp=true&p=iphone&variant=SHOWCASE#zpid=49046647&homeDetailsVariant=SHOWCASE&webviewLayout=doubleScroll&showFactsAndFeatures=true&fromApp=true&gmaps=false&streetview=false personalizedResult: isViewed: false userRecommendation: isRecommendedForYou: false propertyDisplayRules: canShowAddress: true canShowOnMap: true mls: mlsName: NWMLS as distributed by MLS GRID mlsStatus: First Look providerLogoOnMap: >- https://photos.zillowstatic.com/fp/033de87a0051f29108423257c615e0b5-zillow_apps_95_35.jpg listingCategory: category1 ssid: 39 hasFloorPlan: true richMedia: - rmxData: - … - zpid: 49147344 location: latitude: 47.62033 longitude: -122.29783 address: streetAddress: 2614 E John Street zipcode: '98112' city: Seattle state: WA media: propertyPhotoLinks: mediumSizeLink: >- https://photos.zillowstatic.com/fp/50ef8ca3a295b208198e1ffc39d1b10c-p_c.jpg highResolutionLink: >- https://photos.zillowstatic.com/fp/50ef8ca3a295b208198e1ffc39d1b10c-p_f.jpg hasVRModel: true hasVideos: false hasIMX: true hasApprovedThirdPartyVirtualTour: false allPropertyPhotos: medium: - >- https://photos.zillowstatic.com/fp/50ef8ca3a295b208198e1ffc39d1b10c-p_c.jpg - >- https://photos.zillowstatic.com/fp/8163e0832173ef0eb0c35dd70e568cfd-p_c.jpg - >- https://photos.zillowstatic.com/fp/a58c4d9d055dfd20ebd7c18a99036eef-p_c.jpg highResolution: - >- https://photos.zillowstatic.com/fp/50ef8ca3a295b208198e1ffc39d1b10c-p_f.jpg - >- https://photos.zillowstatic.com/fp/8163e0832173ef0eb0c35dd70e568cfd-p_f.jpg - >- https://photos.zillowstatic.com/fp/a58c4d9d055dfd20ebd7c18a99036eef-p_f.jpg isFeatured: false isShowcaseListing: true propertyHasLasViolation: false mapDotTag: name: showcase rental: areApplicationsAccepted: false hasVirtualTour: false currency: usd country: usa bestGuessTimeZone: America/Los_Angeles isUnmappable: false listCardRecommendation: flexFieldRecommendations: - … - … - … bathrooms: 1 bedrooms: 1 livingArea: 760 yearBuilt: 1908 lotSizeWithUnit: lotSize: 1119.492 lotSizeUnit: squareFeet propertyType: singleFamily listing: listingStatus: forSale marketingStatus: active palsId: 39001_2576305 listingSubType: isFSBA: true isPreforeclosureAuction: false price: value: 585000 pricePerSquareFoot: 770 zillowOwnedProperty: isZillowOwned: false taxAssessment: taxAssessedValue: 576000 taxAssessmentYear: '2025' hdpView: listingStatus: forSale price: 585000 hdpUrl: >- /homedetail/MobileAppHDPShopperPlatformServicePage.htm?fromApp=true&p=iphone&variant=SHOWCASE#zpid=49147344&homeDetailsVariant=SHOWCASE&webviewLayout=doubleScroll&showFactsAndFeatures=true&fromApp=true&gmaps=false&streetview=false personalizedResult: isViewed: false userRecommendation: isRecommendedForYou: false propertyDisplayRules: canShowAddress: true canShowOnMap: true mls: mlsName: NWMLS as distributed by MLS GRID mlsStatus: Active providerLogoOnMap: >- https://photos.zillowstatic.com/fp/033de87a0051f29108423257c615e0b5-zillow_apps_95_35.jpg listingCategory: category1 ssid: 39 hasFloorPlan: true richMedia: - rmxData: - … count: 20 total_matching_count: 2058 page: 1 page_size: 20 listing_category_counts: - totalMatching: 56 listingCategory: category2 listing_category_counts_note: >- These counts are cross-mapped upstream: a category1 (sale) request reports the category2 (rent) counts, and the reverse for a rent request. Read total_matching_count for the count of the category you asked for, and treat these as the size o… freshness: - >- Based on information submitted to the MLS GRID as of 2026-10-21 06:24:36 PDT. All data is obtained from various sources and may not have been verified by broker or MLS GRID. Supplied Open House Information is subject to change without notic… paging_note: >- page * page_size must not exceed 1000; up to 1000 rows come back in one request. '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '410': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '502': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' '504': $ref: '#/components/responses/Error' components: headers: RequestId: description: Unique ID for this request; quote it in support requests. schema: type: string CreditsUsed: description: Credits charged for this call (0 when it failed). schema: type: integer CreditsRemaining: description: Your balance after this call. schema: type: integer RateLimitLimit: description: >- Requests a minute your account may make: its rate in requests per second times 60. schema: type: integer RateLimitRemaining: description: Requests left in the current minute, shared by every key on the account. schema: type: integer RateLimitReset: description: Seconds until the current minute's count starts over. schema: type: integer RateLimitPolicy: description: The limit and its window in seconds, for example "300;w=60". schema: type: string responses: Error: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.