Analyze comp sets with survey tables, units, and floorplans.
This guide shows how to explore Market Surveys: comp sets, survey tables, units, and floorplans.Use this workflow to answer pricing and performance questions, such as:
How do our rents and NER compare to competitors today?
Which properties are offering concessions and how deep are they?
Where are we over/under-exposed by floorplan or bedroom type?
What unit mix trends should influence our pricing strategy?
This returns an array of comp sets you have access to. Each item includes helpful attributes like the comp set name, category, and subject property indicators.
Pick a comp set that represents the properties you actively compete with in a submarket. Save its id for the next steps.
The response includes per‑property metrics (asking rent, NER, all‑in rent and all‑in NER — the base metric plus recurring monthly fees, with per‑square‑foot variants — rent per sq ft, size, concessions, exposure, leased percent) and an overall comp‑average column for quick benchmarking.
See Key terms for definitions like NER, exposure, and leased percent.
This endpoint returns individual unit details, including property name, floorplan, rent and NER, all‑in rent and all‑in NER (base metric plus recurring monthly fees, with per‑square‑foot variants), square footage, availability dates, days on market, and concessions. Use it to drill into specific availability and price points.
Results can be grouped by bedroom only or by bedroom/bathroom. Each floorplan summary includes asking rent and NER (and their changes), all‑in rent and all‑in NER (base metric plus recurring monthly fees, with per‑square‑foot variants), rent per square foot, average size, estimated unit mix, and trends over time—ideal for floorplan‑level pricing decisions.
Set filter[aggregation_type]=avg to average metrics across underlying units, or omit to use the service default.
Example questions to guide analysis
Pricing strategy: “Are our 1‑bed asking rents above the market average? If so, by how much PSF?”
Concessions: “Which comps are offering the richest deals, and for which floorplans?”
Exposure and leasing: “Where is exposure high but leased percent trending down?”
Product mix: “Do larger 2‑bed homes have longer days on market relative to the comp average?”
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ApartmentIQ API","colors":{"primary":"#5046E5","light":"#7A7EF3","dark":"#5046E5"},"logo":{"light":"https://mintcdn.com/apartmentiq-c1886649/bOkm0DURAy3zqK_v/logo/light.svg?fit=max\u0026auto=format\u0026n=bOkm0DURAy3zqK_v\u0026q=85\u0026s=0c92db5d709d8537ed3442caf047462f","dark":"https://mintcdn.com/apartmentiq-c1886649/bOkm0DURAy3zqK_v/logo/dark.svg?fit=max\u0026auto=format\u0026n=bOkm0DURAy3zqK_v\u0026q=85\u0026s=236aedeedc8d1be8508b4194f1ec161f"},"favicon":"https://mintcdn.com/apartmentiq-c1886649/b14Ka2Z5VsBhEojA/favicon.ico?fit=max\u0026auto=format\u0026n=b14Ka2Z5VsBhEojA\u0026q=85\u0026s=269b6e8976f2a41da8bbadca410d14b2","api":{"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required"}},"navbar":{"links":[{"href":"https://support.apartmentiq.io/","label":"Support"},{"href":"https://app.apartmentiq.io/","label":"Login"}],"primary":{"type":"button","label":"Request a Demo","href":"https://www.apartmentiq.io/request-a-demo/"}},"footer":{},"seo":{"metatags":{"robots":"noindex"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","download-spec","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apartmentiq-c1886649","hasAudioNarration":false,"actualSubdomain":"apartmentiq-c1886649","customDomains":["developers.apartmentiq.io"],"gitSource":{"type":"github","owner":"abodo-dev","repo":"apartmentiq-api-docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af9205b59fc4106fcc45a33","clientVersion":"0.0.4263","searchFilterCounts":[{"language":"default","tag":"API Reference","count":38},{"language":"default","tag":"Overview","count":14},{"language":"default","tag":"Market Surveys","count":9},{"language":"default","tag":"Markets","count":7},{"language":"default","tag":"Bulk","count":6},{"language":"default","tag":"Use Cases","count":5},{"language":"default","tag":"Bulk Data Export","count":5},{"language":"default","tag":"Organizations","count":4},{"language":"default","tag":"Accounts","count":2},{"language":"default","tag":"Forecasts","count":2}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"v1/use-cases/market-survey","slug":"/v1/use-cases/market-survey","pageMetadata":{"title":"Market Survey","description":"Analyze comp sets with survey tables, units, and floorplans.","href":"/v1/use-cases/market-survey"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Analyze comp sets with survey tables, units, and floorplans.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This guide shows how to explore Market Surveys: comp sets, survey tables, units, and floorplans.`}),`\n`,_jsx(_components.p,{children:`Use this workflow to answer pricing and performance questions, such as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`How do our rents and NER compare to competitors today?`}),`\n`,_jsx(_components.li,{children:`Which properties are offering concessions and how deep are they?`}),`\n`,_jsx(_components.li,{children:`Where are we over/under-exposed by floorplan or bedroom type?`}),`\n`,_jsx(_components.li,{children:`What unit mix trends should influence our pricing strategy?`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A Bearer token (see `,_jsx(_components.a,{href:`/v1/authentication`,children:`Authentication`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`Account ID\n`,_jsxs(Tip,{children:[`If you need credentials, see `,_jsx(_components.a,{href:`/v1`,children:`Getting started`}),` → “Set up authentication”.`]})]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`1-list-competitive-sets`,children:`1) List competitive sets`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cyour_api_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://data.apartmentiq.io/apartmentiq/api/v1/accounts/\u003caccount_id>/comp_sets\"`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This returns an array of comp sets you have access to. Each item includes helpful attributes like the comp set name, category, and subject property indicators.`}),`\n`,_jsxs(Tip,{children:[`Pick a comp set that represents the properties you actively compete with in a submarket. Save its `,_jsx(_components.code,{children:`id`}),` for the next steps.`]}),`\n`,_jsx(Heading,{level:`3`,id:`2-get-the-market-survey-table-for-a-comp-set`,children:`2) Get the market survey table for a comp set`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cyour_api_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://data.apartmentiq.io/apartmentiq/api/v1/comp_sets/\u003ccomp_set_id>/market_survey\"`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`You can filter the table to focus on specific segments. Supported query filters (comma-separated values as strings):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[bedroom_count]`}),`, `,_jsx(_components.code,{children:`filter[bathroom_count]`})]}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`filter[iq_property_ids]`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[size_gte]`}),`, `,_jsx(_components.code,{children:`filter[size_lte]`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[rent_gte]`}),`, `,_jsx(_components.code,{children:`filter[rent_lte]`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[date_available_gte]`}),`, `,_jsx(_components.code,{children:`filter[date_available_lte]`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[year_built_gte]`}),`, `,_jsx(_components.code,{children:`filter[year_built_lte]`})]}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`filter[unit_style]`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`The response includes per‑property metrics (asking rent, NER, all‑in rent and all‑in NER — the base metric plus recurring monthly fees, with per‑square‑foot variants — rent per sq ft, size, concessions, exposure, leased percent) and an overall comp‑average column for quick benchmarking.`}),`\n`,_jsxs(Note,{children:[`See `,_jsx(_components.a,{href:`/v1/key-terms`,children:`Key terms`}),` for definitions like NER, exposure, and leased percent.`]}),`\n`,_jsx(Heading,{level:`3`,id:`3-list-units-in-a-comp-set`,children:`3) List units in a comp set`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cyour_api_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://data.apartmentiq.io/apartmentiq/api/v1/comp_sets/\u003ccomp_set_id>/units?filter[bedroom_count]=1,2\u0026filter[size_gte]=600\"`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This endpoint returns individual unit details, including property name, floorplan, rent and NER, all‑in rent and all‑in NER (base metric plus recurring monthly fees, with per‑square‑foot variants), square footage, availability dates, days on market, and concessions. Use it to drill into specific availability and price points.`}),`\n`,_jsx(Heading,{level:`3`,id:`4-list-floorplans`,children:`4) List floorplans`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cyour_api_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://data.apartmentiq.io/apartmentiq/api/v1/comp_sets/\u003ccomp_set_id>/floor_plans?filter[aggregation_type]=avg\"`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Results can be grouped by bedroom only or by bedroom/bathroom. Each floorplan summary includes asking rent and NER (and their changes), all‑in rent and all‑in NER (base metric plus recurring monthly fees, with per‑square‑foot variants), rent per square foot, average size, estimated unit mix, and trends over time—ideal for floorplan‑level pricing decisions.`}),`\n`,_jsxs(Tip,{children:[`Set `,_jsx(_components.code,{children:`filter[aggregation_type]=avg`}),` to average metrics across underlying units, or omit to use the service default.`]}),`\n`,_jsx(Heading,{level:`3`,id:`example-questions-to-guide-analysis`,children:`Example questions to guide analysis`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Pricing strategy: “Are our 1‑bed asking rents above the market average? If so, by how much PSF?”`}),`\n`,_jsx(_components.li,{children:`Concessions: “Which comps are offering the richest deals, and for which floorplans?”`}),`\n`,_jsx(_components.li,{children:`Exposure and leasing: “Where is exposure high but leased percent trending down?”`}),`\n`,_jsx(_components.li,{children:`Product mix: “Do larger 2‑bed homes have longer days on market relative to the comp average?”`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`errors-and-rate-limits`,children:`Errors and rate limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`401 if authorization is missing/invalid`}),`\n`,_jsx(_components.li,{children:`403 if you lack permissions`}),`\n`,_jsx(_components.li,{children:`429 if you exceed the rate limit`}),`\n`,_jsxs(_components.li,{children:[`See `,_jsx(_components.a,{href:`/v1/errors`,children:`Errors`}),` and `,_jsx(_components.a,{href:`/v1/rate-limits`,children:`Rate limits`})]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Market Survey","description":"Analyze comp sets with survey tables, units, and floorplans.","href":"/v1/use-cases/market-survey"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":3,"children":[]},{"title":"1) List competitive sets","slug":"1-list-competitive-sets","depth":3,"children":[]},{"title":"2) Get the market survey table for a comp set","slug":"2-get-the-market-survey-table-for-a-comp-set","depth":3,"children":[]},{"title":"3) List units in a comp set","slug":"3-list-units-in-a-comp-set","depth":3,"children":[]},{"title":"4) List floorplans","slug":"4-list-floorplans","depth":3,"children":[]},{"title":"Example questions to guide analysis","slug":"example-questions-to-guide-analysis","depth":3,"children":[]},{"title":"Errors and rate limits","slug":"errors-and-rate-limits","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"apartmentiq-c1886649","siteName":"ApartmentIQ API","title":"Market Survey - ApartmentIQ API","navMaps":{"firstHrefInVersion":{"API Version: 1":{"href":"/v1/use-cases/market-survey","matchLevel":0},"API Version: 2 (Preview)":{"href":"/v2","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-07-08T22:13:36.016Z","originalFileLocation":"v1/use-cases/market-survey.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Analyze comp sets with survey tables, units, and floorplans.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ApartmentIQ API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Market Survey - ApartmentIQ API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Analyze comp sets with survey tables, units, and floorplans.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ApartmentIQ API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.apartmentiq.io/v1/use-cases/market-survey\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apartmentiq-c1886649.mintlify.site/_mintlify/api/og/v2?division=Use+Cases\u0026amp;title=Market+Survey\u0026amp;description=Analyze+comp+sets+with+survey+tables%2C+units%2C+and+floorplans.\u0026amp;theme=dc0e3ba1149aaeec6590ba45\u0026amp;signature=fd7b8b6e8dea1b883e77fca3864e744679ec2073eb8cbee4521180fe6ec69819\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Market Survey - ApartmentIQ API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Analyze comp sets with survey tables, units, and floorplans.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apartmentiq-c1886649.mintlify.site/_mintlify/api/og/v2?division=Use+Cases\u0026amp;title=Market+Survey\u0026amp;description=Analyze+comp+sets+with+survey+tables%2C+units%2C+and+floorplans.\u0026amp;theme=dc0e3ba1149aaeec6590ba45\u0026amp;signature=fd7b8b6e8dea1b883e77fca3864e744679ec2073eb8cbee4521180fe6ec69819\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apartmentiq-c1886649/_q5dJxOe_4A4IlTw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ApartmentIQ API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5046E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.apartmentiq.io/v1/use-cases/market-survey\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v1/use-cases/market-survey.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.apartmentiq.io/#organization\",\"name\":\"ApartmentIQ API\",\"url\":\"https://developers.apartmentiq.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apartmentiq-c1886649/bOkm0DURAy3zqK_v/logo/light.svg?fit=max\u0026auto=format\u0026n=bOkm0DURAy3zqK_v\u0026q=85\u0026s=0c92db5d709d8537ed3442caf047462f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.apartmentiq.io#website\",\"name\":\"ApartmentIQ API\",\"url\":\"https://developers.apartmentiq.io\",\"publisher\":{\"@id\":\"https://developers.apartmentiq.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey#webpage\",\"url\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey\",\"name\":\"Market Survey\",\"description\":\"Analyze comp sets with survey tables, units, and floorplans.\",\"dateModified\":\"2026-07-08T22:13:36.016Z\",\"isPartOf\":{\"@id\":\"https://developers.apartmentiq.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ApartmentIQ API\",\"item\":\"https://developers.apartmentiq.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Market Survey\",\"item\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey#article\",\"headline\":\"Market Survey\",\"name\":\"Market Survey\",\"description\":\"Analyze comp sets with survey tables, units, and floorplans.\",\"url\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey\",\"mainEntityOfPage\":{\"@id\":\"https://developers.apartmentiq.io/v1/use-cases/market-survey#webpage\"},\"dateModified\":\"2026-07-08T22:13:36.016Z\",\"publisher\":{\"@id\":\"https://developers.apartmentiq.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.apartmentiq.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ApartmentIQ API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ApartmentIQ API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v1/use-cases/market-survey.md","siteName":"ApartmentIQ API","nav":{"global":{},"versions":[{"version":"API Version: 1","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/v1"},{"title":"Getting Started","href":"/v1/getting-started"},{"title":"Key Terms","href":"/v1/key-terms"},{"title":"Authentication","href":"/v1/authentication"},{"title":"Rate Limits","href":"/v1/rate-limits"},{"title":"Errors","href":"/v1/errors"},{"title":"Changelog","description":"Product updates and release notes for the ApartmentIQ API V1.","href":"/changelog/v1"}]},{"group":"Use Cases","pages":[{"title":"Market Survey","href":"/v1/use-cases/market-survey"},{"title":"Market Analysis","description":"Explore markets and retrieve bulk property data.","href":"/v1/use-cases/market-analysis"},{"title":"Compare Markets","href":"/v1/use-cases/compare-markets"},{"title":"Data Sync","href":"/v1/use-cases/data-sync"},{"title":"Bulk Data Export","href":"/v1/use-cases/bulk-data-export"}]},{"group":"API Reference","expanded":true,"pages":[{"group":"Accounts","expanded":true,"pages":[{"title":"List Accounts","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /accounts","href":"/api-reference/accounts/list-accounts"}]},{"group":"Market Surveys","expanded":true,"pages":[{"title":"List Competitive Sets","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /accounts/{account_id}/comp_sets","href":"/api-reference/market-surveys/list-competitive-sets"},{"title":"Get Market Survey Data","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /comp_sets/{comp_set_id}/market_survey","href":"/api-reference/market-surveys/get-market-survey-data"},{"title":"List Units In Competitive Set","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /comp_sets/{comp_set_id}/units","href":"/api-reference/market-surveys/list-units-in-competitive-set"},{"title":"List Floorplans","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /comp_sets/{comp_set_id}/floor_plans","href":"/api-reference/market-surveys/list-floorplans"}]},{"group":"Markets","expanded":true,"pages":[{"title":"Search Geo Boundaries","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /geo_boundaries/search","href":"/api-reference/markets/search-geo-boundaries"},{"title":"Search Properties","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /geo_boundaries/properties","href":"/api-reference/markets/search-properties"},{"title":"Property Lookup","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /properties/lookup","href":"/api-reference/markets/property-lookup"},{"title":"Bulk Property Details","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /properties/bulk_details","href":"/api-reference/markets/bulk-property-details"},{"title":"Compare Markets","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /explore_markets","href":"/api-reference/markets/compare-markets"},{"title":"Get Market Narrative","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /markets/narratives","href":"/api-reference/markets/get-market-narrative"}]},{"group":"Bulk Data Export","expanded":true,"pages":[{"title":"Create Batch Job","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /bulk_api/jobs","href":"/api-reference/bulk-data-export/create-batch-job"},{"title":"List Batch Jobs","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /bulk_api/jobs","href":"/api-reference/bulk-data-export/list-batch-jobs"},{"title":"Get Batch Job Status","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /bulk_api/jobs/{job_id}","href":"/api-reference/bulk-data-export/get-batch-job-status"},{"title":"Cancel Batch Job","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json delete /bulk_api/jobs/{job_id}","href":"/api-reference/bulk-data-export/cancel-batch-job"},{"title":"Download Batch Job Results","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json get /bulk_api/jobs/{job_id}/results","href":"/api-reference/bulk-data-export/download-batch-job-results"}]},{"group":"Forecasts","expanded":true,"pages":[{"title":"Geo Boundary Forecasts","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /geo_boundary/{geo_boundary_id}/forecasts","href":"/api-reference/forecasts/geo-boundary-forecasts"},{"title":"Property Forecasts","deprecated":null,"version":null,"openapi":"/openapi/v1/schema.json post /properties/{property_id}/forecasts","href":"/api-reference/forecasts/property-forecasts"}]}]}]},{"version":"API Version: 2 (Preview)","pages":[{"title":"API Version: 2 (Preview)","href":"/v2"}]}]},"basePath":"","title":"Market Survey - ApartmentIQ API","deploymentId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","buildId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","dynamics":[],"chunks":[]}