> ## 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. # Rightmove: Search > Search from Rightmove. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Rightmove API overview](https://perceptlayer.com/apis/rightmove) for every Rightmove endpoint. ## OpenAPI ````yaml /openapi.json get /v1/rightmove/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/rightmove/search: get: tags: - Rightmove summary: Search description: Search from Rightmove. Costs 1 credit per successful call. operationId: rightmove_search parameters: - name: location in: query required: false schema: type: string maxLength: 120 example: London - name: location_identifier in: query required: false schema: type: string maxLength: 60 - name: location_name in: query required: false schema: type: string maxLength: 120 - name: channel in: query required: true schema: type: string enum: - BUY - RENT - COMMERCIAL_BUY - COMMERCIAL_RENT example: BUY - name: radius in: query required: false schema: type: integer - name: page in: query required: false schema: type: integer - name: sort in: query required: false schema: type: integer - name: min_price in: query required: false schema: type: integer - name: max_price in: query required: false schema: type: integer - name: min_bedrooms in: query required: false schema: type: integer - name: max_bedrooms in: query required: false schema: type: integer - name: property_type in: query required: false schema: type: string maxLength: 60 - name: must_have in: query required: false schema: type: string maxLength: 60 - name: enrich in: query required: false schema: type: boolean 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: endpoint: type: string params: type: object properties: location: type: string channel: type: string response: type: object properties: data: type: object properties: properties: type: array items: type: object properties: id: type: integer bedrooms: type: integer bathrooms: type: integer numberOfImages: type: integer numberOfFloorplans: type: integer numberOfVirtualTours: type: integer summary: type: string displayAddress: type: string countryCode: type: string location: type: object properties: latitude: type: number longitude: type: number images: type: array items: type: object properties: srcUrl: type: string url: type: string propertySubType: type: string tenure: type: object properties: tenureType: type: string listingUpdate: type: object properties: listingUpdateReason: type: string listingUpdateDate: type: string price: type: object properties: amount: type: integer frequency: type: string currencyCode: type: string displayPrices: type: array items: type: string premiumListing: type: boolean featuredProperty: type: boolean commercialSearchProminenceSelected: type: boolean customer: type: object properties: branchId: type: integer brandPlusLogoURI: type: string contactTelephone: type: string branchDisplayName: type: string branchName: type: string brandTradingName: type: string branchLandingPageUrl: type: string development: type: boolean mediaServerUrl: type: string showReducedProperties: type: boolean hasBrandPlus: type: boolean commercial: type: boolean showOnMap: type: boolean enhancedListing: type: boolean buildToRentListing: type: boolean buildToRent: type: boolean updateDate: type: string brandPlusLogoUrl: type: string premiumListingFeatures: type: array items: type: string transactionType: type: string productLabel: type: object properties: spotlightLabel: type: boolean commercial: type: boolean development: type: boolean residential: type: boolean students: type: boolean auction: type: boolean feesApply: type: boolean displaySize: type: string showOnMap: type: boolean propertyUrl: type: string contactUrl: type: string channel: type: string firstVisibleDate: type: string keywordMatchType: type: string saved: type: boolean hidden: type: boolean onlineViewingsAvailable: type: boolean lozengeModel: type: object properties: {} streetView: type: object properties: showStreetView: type: boolean updateDate: type: string enhancedListing: type: boolean propertyImages: type: object properties: images: type: array items: type: string mainImageSrc: type: string mainMapImageSrc: type: string formattedBranchName: type: string addedOrReduced: type: string formattedDistance: type: string heading: type: string propertyTypeFullDescription: type: string displayStatus: type: string isRecent: type: boolean hasBrandPlus: type: boolean listing_id: type: string branch_id: type: integer keyFeatures: type: array items: type: object properties: order: type: integer description: type: string htmlDescription: type: string count: type: integer page: type: integer page_size: type: integer channel: type: string location_identifier: type: string has_next_page: type: boolean record_limit: type: object properties: max_page: type: integer approx_records_per_search: type: integer note: type: string meta: type: object properties: attempts: type: integer lookups: type: integer duration_ms: type: integer description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: endpoint: rightmove.search params: location: London channel: BUY response: data: properties: - id: 90486465 bedrooms: 3 bathrooms: 2 numberOfImages: 20 numberOfFloorplans: 1 numberOfVirtualTours: 0 summary: >- This luxurious 3 bedroom duplex penthouse flat with lift access and parking has been newly-renovated, presenting high quality interiors throughout. It features an open plan reception leading onto a sizeable private terrace. Cavaye Place is … displayAddress: Cavaye Place, Chelsea, London, SW10 countryCode: GB location: latitude: 51.486678 longitude: -0.180225 images: - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/46118abd0/90486465/46118abd08e5ba9b2c9a6aaeb7da833f_max_476x317.jpeg url: >- property-photo/46118abd0/90486465/46118abd08e5ba9b2c9a6aaeb7da833f.jpeg caption: Picture No. 11 - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/d581aed8a/90486465/d581aed8ae17ec809a2f45944dd1989c_max_476x317.jpeg url: >- property-photo/d581aed8a/90486465/d581aed8ae17ec809a2f45944dd1989c.jpeg caption: Picture No. 15 - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/419fee10b/90486465/419fee10b2b2dffd88cce583d6f82033_max_476x317.jpeg url: >- property-photo/419fee10b/90486465/419fee10b2b2dffd88cce583d6f82033.jpeg caption: Picture No. 06 propertySubType: Apartment tenure: tenureType: LEASEHOLD listingUpdate: listingUpdateReason: new listingUpdateDate: '2026-07-03T22:30:31Z' price: amount: 1495000 frequency: not specified currencyCode: GBP displayPrices: - … premiumListing: true featuredProperty: true commercialSearchProminenceSelected: false customer: branchId: 298991 brandPlusLogoURI: >- /partner-logo/42794795-PRODUCTS_LOGO-1770220850955.png contactTelephone: 03330 389608 branchDisplayName: OB Private, Mayfair branchName: Mayfair brandTradingName: OB Private branchLandingPageUrl: /estate-agents/agent/OB-Private/Mayfair-298991.html development: false mediaServerUrl: https://media.rightmove.co.uk:443 showReducedProperties: true hasBrandPlus: true commercial: false showOnMap: true enhancedListing: false buildToRentListing: false buildToRent: false updateDate: '2026-03-26T16:51:19Z' brandPlusLogoUrl: >- https://media.rightmove.co.uk:443/partner-logo/42794795-PRODUCTS_LOGO-1770220850955.png primaryBrandColour: '#151c33' premiumListingFeatures: - KEY_FEATURES - VIDEO - LARGER_LISTING transactionType: buy productLabel: productLabelText: Premium Listing spotlightLabel: false commercial: false development: false residential: true students: false auction: false feesApply: false displaySize: 1,285 sq. ft. showOnMap: true propertyUrl: /properties/90486465#/?channel=RES_BUY contactUrl: >- /property-for-sale/contactBranch.html?propertyId=90486465 channel: BUY firstVisibleDate: '2026-07-03T22:24:14Z' keywordMatchType: no_keyword saved: false hidden: false onlineViewingsAvailable: false lozengeModel: {} streetView: showStreetView: true updateDate: '2026-10-23T04:52:13Z' enhancedListing: false propertyImages: images: - … - … - … mainImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/46118abd0/90486465/46118abd08e5ba9b2c9a6aaeb7da833f_max_476x317.jpeg mainMapImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/46118abd0/90486465/46118abd08e5ba9b2c9a6aaeb7da833f_max_296x197.jpeg formattedBranchName: ' by OB Private, Mayfair' addedOrReduced: Added on 03/07/2026 formattedDistance: '' heading: Featured Property propertyTypeFullDescription: 3 bedroom apartment for sale displayStatus: '' isRecent: false hasBrandPlus: true listing_id: '90486465' branch_id: 298991 - id: 760770556763601 bedrooms: 0 numberOfImages: 3 numberOfFloorplans: 0 numberOfVirtualTours: 0 summary: >- An exceptional prime office to residential opportunity in the heart of Westminster displayAddress: One Page Street, London, SW1P 4PQ countryCode: GB location: latitude: 51.493786 longitude: -0.12729 images: - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/26213ed6b/760770556763601/26213ed6b802f47cedac6c6a184d2e96_max_476x317.jpeg url: >- property-photo/26213ed6b/760770556763601/26213ed6b802f47cedac6c6a184d2e96.jpeg - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/644d6165a/760770556763601/644d6165a64631d1df9a0f5e6430a0c5_max_476x317.jpeg url: >- property-photo/644d6165a/760770556763601/644d6165a64631d1df9a0f5e6430a0c5.jpeg - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/6231f9713/760770556763601/6231f971326a209abece4ee0e932522d_max_476x317.jpeg url: >- property-photo/6231f9713/760770556763601/6231f971326a209abece4ee0e932522d.jpeg propertySubType: Land tenure: tenureType: FREEHOLD listingUpdate: listingUpdateReason: new listingUpdateDate: '2026-06-30T16:47:05Z' price: amount: 65000000 frequency: not specified currencyCode: GBP displayPrices: - … premiumListing: false featuredProperty: false commercialSearchProminenceSelected: false customer: branchId: 208037 brandPlusLogoURI: /partner-logo/11692847-PRODUCTS_LOGO-1766058716.jpeg contactTelephone: 020 3909 7811 branchDisplayName: Savills, Margaret Street- Development branchName: Margaret Street- Development brandTradingName: Savills branchLandingPageUrl: >- /estate-agents/agent/Savills/Margaret-Street--Development-208037.html development: false mediaServerUrl: https://media.rightmove.co.uk:443 showReducedProperties: true hasBrandPlus: false commercial: true showOnMap: true enhancedListing: false buildToRentListing: false buildToRent: false updateDate: '2026-06-30T17:28:43Z' brandPlusLogoUrl: >- https://media.rightmove.co.uk:443/partner-logo/11692847-PRODUCTS_LOGO-1766058716.jpeg transactionType: buy productLabel: spotlightLabel: false commercial: true development: false residential: true students: false auction: false feesApply: false displaySize: '' showOnMap: true propertyUrl: /properties/760770556763601#/?channel=COM_BUY contactUrl: >- /commercial-property-for-sale/contactBranch.html?propertyId=760770556763601 channel: COMMERCIAL_BUY firstVisibleDate: '2026-06-30T16:41:29Z' keywordMatchType: no_keyword saved: false hidden: false onlineViewingsAvailable: false lozengeModel: {} streetView: showStreetView: true updateDate: '2026-10-22T06:38:22Z' keyFeatures: - order: 1 description: >- Freehold office building in Westminster formerly single-let to Burberry Limited. htmlDescription: >- Freehold office building in Westminster formerly single-let to Burberry Limited. - order: 2 description: >- Refurbishment and recladding of the façade undertaken by Derwent London in 2012. htmlDescription: >- Refurbishment and recladding of the façade undertaken by Derwent London in 2012. - order: 3 description: >- Approximately 125,272 sq ft (11,638 sqm) NIA, 165,982 sqft GIA (15,420 sqm). htmlDescription: >- Approximately 125,272 sq ft (11,638 sqm) NIA, 165,982 sqft GIA (15,420 sqm). enhancedListing: false propertyImages: images: - … - … - … mainImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/26213ed6b/760770556763601/26213ed6b802f47cedac6c6a184d2e96_max_476x317.jpeg mainMapImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/26213ed6b/760770556763601/26213ed6b802f47cedac6c6a184d2e96_max_296x197.jpeg formattedBranchName: Marketed by Savills, Margaret Street- Development addedOrReduced: '' formattedDistance: '' heading: '' propertyTypeFullDescription: Land for sale displayStatus: '' isRecent: false hasBrandPlus: false listing_id: '760770556763601' branch_id: 208037 - id: 94619721 bedrooms: 2 bathrooms: 1 numberOfImages: 1 numberOfFloorplans: 0 numberOfVirtualTours: 0 summary: This is a test property| displayAddress: Great Titchfield Street, London, W1W countryCode: GB location: latitude: 51.518155 longitude: -0.140158 images: - srcUrl: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/a34e8799f/94619721/a34e8799f29feecb8068cb24e52a238f_max_476x317.png url: >- property-photo/a34e8799f/94619721/a34e8799f29feecb8068cb24e52a238f.png propertySubType: Flat tenure: tenureType: LEASEHOLD listingUpdate: listingUpdateReason: new listingUpdateDate: '2026-10-22T15:18:08Z' price: amount: 50000000 frequency: not specified currencyCode: GBP displayPrices: - … premiumListing: false featuredProperty: false commercialSearchProminenceSelected: false customer: branchId: 86223 brandPlusLogoURI: >- /partner-logo/34443567-PRODUCTS_LOGO-1781700490314.jpg contactTelephone: 020 4652 4492 branchDisplayName: KEAZE LIMITED, Covering London branchName: Covering London brandTradingName: KEAZE LIMITED branchLandingPageUrl: >- /estate-agents/agent/KEAZE-LIMITED/Covering-London-86223.html development: false mediaServerUrl: https://media.rightmove.co.uk:443 showReducedProperties: true hasBrandPlus: true commercial: false showOnMap: true enhancedListing: false buildToRentListing: false buildToRent: false updateDate: '2026-10-22T14:58:14Z' brandPlusLogoUrl: >- https://media.rightmove.co.uk:443/partner-logo/34443567-PRODUCTS_LOGO-1781700490314.jpg premiumListingFeatures: - KEY_FEATURES - VIDEO - LARGER_LISTING transactionType: buy productLabel: spotlightLabel: false commercial: false development: false residential: true students: false auction: false feesApply: false displaySize: 700 sq. ft. showOnMap: true propertyUrl: /properties/94619721#/?channel=RES_BUY contactUrl: >- /property-for-sale/contactBranch.html?propertyId=94619721 channel: BUY firstVisibleDate: '2026-10-22T15:12:54Z' keywordMatchType: no_keyword saved: false hidden: false onlineViewingsAvailable: false lozengeModel: {} streetView: showStreetView: true updateDate: '2026-10-22T15:18:08Z' keyFeatures: - order: 1 description: This is a test htmlDescription: This is a test - order: 2 description: Open plan living area htmlDescription: Open plan living area - order: 3 description: Lots of natural light htmlDescription: Lots of natural light enhancedListing: false propertyImages: images: - … mainImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/a34e8799f/94619721/a34e8799f29feecb8068cb24e52a238f_max_476x317.png mainMapImageSrc: >- https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/a34e8799f/94619721/a34e8799f29feecb8068cb24e52a238f_max_296x197.png formattedBranchName: ' by KEAZE LIMITED, Covering London' addedOrReduced: Added yesterday formattedDistance: '' heading: '' propertyTypeFullDescription: 2 bedroom flat for sale displayStatus: '' isRecent: true hasBrandPlus: true listing_id: '94619721' branch_id: 86223 count: 60081 page: 1 page_size: 24 channel: BUY location_identifier: REGION^87490 has_next_page: true record_limit: max_page: 41 approx_records_per_search: 1025 note: >- Rightmove caps a single search sweep at roughly 1,000 records over 41 pages. Narrow the location to go deeper. meta: attempts: 1 lookups: 1 duration_ms: 1253 '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.