{ "openapi": "3.0.1", "info": { "title": "XY Planning Network Scraper — Fee-Only CFP® Advisor Leads", "description": "Export XYPN's Find an Advisor directory: fee-only CFP® advisor name, firm, city/state, client niches, full fee schedule (flat/hourly/monthly/quarterly/AUM), states served, website, LinkedIn and SEC IAPD links with CRD numbers. Filter by state, niche or name. No login. Export JSON/CSV.", "version": "0.1", "x-build-id": "C3BUDnAWZjxeSgoDb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~xy-planning-advisor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-xy-planning-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapersdelight~xy-planning-advisor-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-xy-planning-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapersdelight~xy-planning-advisor-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-xy-planning-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "states": { "title": "States served", "type": "array", "description": "States to search, one scope each. 'Serves' semantics, matched by XYPN server-side: California returns 379 advisors but only 167 are headquartered there — the rest list CA as a state they serve. Counts in the list were measured on the live directory on 2026-08-15 and drift. An advisor serving two chosen states is deduplicated on their profile slug and billed once. Leave empty for the entire directory.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama — 118 advisors serve it", "Alaska — 107 advisors serve it", "Arizona — 180 advisors serve it", "Arkansas — 116 advisors serve it", "California — 379 advisors serve it", "Colorado — 206 advisors serve it", "Connecticut — 148 advisors serve it", "Delaware — 126 advisors serve it", "District of Columbia — 136 advisors serve it", "Florida — 245 advisors serve it", "Georgia — 181 advisors serve it", "Hawaii — 115 advisors serve it", "Idaho — 119 advisors serve it", "Illinois — 192 advisors serve it", "Indiana — 151 advisors serve it", "Iowa — 120 advisors serve it", "Kansas — 128 advisors serve it", "Kentucky — 137 advisors serve it", "Louisiana — 96 advisors serve it", "Maine — 119 advisors serve it", "Maryland — 175 advisors serve it", "Massachusetts — 184 advisors serve it", "Michigan — 169 advisors serve it", "Minnesota — 151 advisors serve it", "Mississippi — 109 advisors serve it", "Missouri — 143 advisors serve it", "Montana — 115 advisors serve it", "Nebraska — 117 advisors serve it", "Nevada — 121 advisors serve it", "New Hampshire — 124 advisors serve it", "New Jersey — 179 advisors serve it", "New Mexico — 115 advisors serve it", "New York — 248 advisors serve it", "North Carolina — 206 advisors serve it", "North Dakota — 105 advisors serve it", "Ohio — 163 advisors serve it", "Oklahoma — 127 advisors serve it", "Oregon — 158 advisors serve it", "Pennsylvania — 203 advisors serve it", "Rhode Island — 122 advisors serve it", "South Carolina — 148 advisors serve it", "South Dakota — 104 advisors serve it", "Tennessee — 146 advisors serve it", "Texas — 319 advisors serve it", "Utah — 139 advisors serve it", "Vermont — 121 advisors serve it", "Virginia — 193 advisors serve it", "Washington — 196 advisors serve it", "West Virginia — 110 advisors serve it", "Wisconsin — 144 advisors serve it", "Wyoming — 113 advisors serve it" ] }, "default": [] }, "niches": { "title": "Client niches", "type": "array", "description": "XYPN's live niche vocabulary — 128 niches in 10 groups, read from the directory's own metadata endpoint on 2026-08-15, with the number of advisors declaring each. Multiple niches widen the result (OR), they do not narrow it. The list is re-validated against the live endpoint at the start of every run, so a renamed niche fails loudly instead of silently returning nothing.", "items": { "type": "string", "enum": [ "Business Financial Management", "Business Owners", "Business Planning", "Family Business", "Non-Profits & Private Foundations", "Small Business", "Career Changers", "Established Professionals", "Graduate Degree", "Junior Executives", "Mid-Career Professionals", "Young Professionals", "African Americans/Black", "Foreign Language Speaker", "Hispanic/Latino/Latinx", "Immigrants", "Minorities", "Biblically Responsible Investing (BRI)", "Christian Business Owners", "Christian Faith Based", "Pastors", "The Church of Jesus Christ of Latter-Day Saints", "Blended Family", "Childfree", "Couples/Partners", "Divorced", "Dual Income Family", "Intergenerational Families", "Married Couples", "Newlywed/Engaged", "Non-Traditional Life Path", "Parents", "Sandwich Generation", "Single Income Family", "Widow/Widower", "Young Families", "Divorced Women", "Female Business Owners", "Female Doctor", "Female Entrepreneurs", "Female Executives", "LGBTQIA", "Single Women", "Women Professionals", "Women in Transition", "Women's Finance", "Baby Boomers", "Gen X", "Gen Y/Millennials", "Gen Z", "Charitable Giving", "Cryptocurrency", "Fitness Enthusiast", "Motorcycle Owners & RV Owners", "Outdoor Enthusiasts", "Political Party Affiliation", "Sabbatical Planning", "Travel Enthusiasts", "Advice-Only", "Cash Flow/Budgeting", "College Planning", "Coronavirus Relief", "Cross-border Planning", "Debt Management", "Elder Care Planning", "Equity Recipients (RS/RSU SOP ESPP)", "Estate Planning", "Expatriates", "FIRE (Financial Independence Retire Early)", "Family Financial Planning", "Financial Coaching", "Financial Life Planning", "Financial Therapy", "First Generation Wealth", "HENRY (High Earners, Not Rich Yet)", "Holistic Financial Planning", "Home Buying", "In Transition", "Income Planning", "Inherited Wealth", "Investment Planning & Management", "New Wealth", "Personal Growth & Development", "Portfolio Management", "Pro Bono", "Retirement Planning", "Risk Management", "SRI/ESG (Socially Responsible Investing/Environmental, Social and Corporate Governance)", "Social Security", "Special Needs", "Student Loan Debt", "Tax Planning", "Trusts", "Ultra High Net-worth", "Wealth Management", "Work/Life Balance", "Airline Pilots", "Artists & Creatives", "Attorneys", "Biotech Professionals", "Business Executives", "Caretakers", "Consultants", "Dentists", "Educators, Teachers, and Academics", "Engineering Professionals", "Entertainment Industry", "Entrepreneurs", "Financial Professionals", "Government Employees", "Independent Contractors", "Medical Professionals", "Military & Veterans", "Oil & Gas", "Optometrists", "Pharmacists", "Professional Athletes", "Public Service Employees", "Real Estate Professionals", "Remote Professionals", "Retail Professionals", "Sales Professionals", "Scientific Professionals", "Self-Employed Individuals", "Startup Founders", "Technology Professionals", "University Employees", "Veterinarians" ], "enumTitles": [ "Business Financial Management — 8 advisors (Business Planning Specialities)", "Business Owners — 214 advisors (Business Planning Specialities)", "Business Planning — 11 advisors (Business Planning Specialities)", "Family Business — 8 advisors (Business Planning Specialities)", "Non-Profits & Private Foundations — 4 advisors (Business Planning Specialities)", "Small Business — 32 advisors (Business Planning Specialities)", "Career Changers — 15 advisors (Career Stage)", "Established Professionals — 52 advisors (Career Stage)", "Graduate Degree — 0 advisors (Career Stage)", "Junior Executives — 2 advisors (Career Stage)", "Mid-Career Professionals — 81 advisors (Career Stage)", "Young Professionals — 78 advisors (Career Stage)", "African Americans/Black — 10 advisors (Ethnicity/Language)", "Foreign Language Speaker — 4 advisors (Ethnicity/Language)", "Hispanic/Latino/Latinx — 6 advisors (Ethnicity/Language)", "Immigrants — 17 advisors (Ethnicity/Language)", "Minorities — 9 advisors (Ethnicity/Language)", "Biblically Responsible Investing (BRI) — 15 advisors (Faith Focus)", "Christian Business Owners — 12 advisors (Faith Focus)", "Christian Faith Based — 72 advisors (Faith Focus)", "Pastors — 2 advisors (Faith Focus)", "The Church of Jesus Christ of Latter-Day Saints — 1 advisors (Faith Focus)", "Blended Family — 6 advisors (Family Structure/Marital Status)", "Childfree — 6 advisors (Family Structure/Marital Status)", "Couples/Partners — 14 advisors (Family Structure/Marital Status)", "Divorced — 19 advisors (Family Structure/Marital Status)", "Dual Income Family — 35 advisors (Family Structure/Marital Status)", "Intergenerational Families — 12 advisors (Family Structure/Marital Status)", "Married Couples — 11 advisors (Family Structure/Marital Status)", "Newlywed/Engaged — 6 advisors (Family Structure/Marital Status)", "Non-Traditional Life Path — 5 advisors (Family Structure/Marital Status)", "Parents — 31 advisors (Family Structure/Marital Status)", "Sandwich Generation — 16 advisors (Family Structure/Marital Status)", "Single Income Family — 2 advisors (Family Structure/Marital Status)", "Widow/Widower — 38 advisors (Family Structure/Marital Status)", "Young Families — 42 advisors (Family Structure/Marital Status)", "Divorced Women — 22 advisors (Gender/Identity)", "Female Business Owners — 11 advisors (Gender/Identity)", "Female Doctor — 6 advisors (Gender/Identity)", "Female Entrepreneurs — 6 advisors (Gender/Identity)", "Female Executives — 5 advisors (Gender/Identity)", "LGBTQIA — 35 advisors (Gender/Identity)", "Single Women — 19 advisors (Gender/Identity)", "Women Professionals — 57 advisors (Gender/Identity)", "Women in Transition — 35 advisors (Gender/Identity)", "Women's Finance — 34 advisors (Gender/Identity)", "Baby Boomers — 244 advisors (Generation Focus)", "Gen X — 368 advisors (Generation Focus)", "Gen Y/Millennials — 312 advisors (Generation Focus)", "Gen Z — 3 advisors (Generation Focus)", "Charitable Giving — 34 advisors (Interests & Hobbies)", "Cryptocurrency — 5 advisors (Interests & Hobbies)", "Fitness Enthusiast — 4 advisors (Interests & Hobbies)", "Motorcycle Owners & RV Owners — 0 advisors (Interests & Hobbies)", "Outdoor Enthusiasts — 11 advisors (Interests & Hobbies)", "Political Party Affiliation — 0 advisors (Interests & Hobbies)", "Sabbatical Planning — 6 advisors (Interests & Hobbies)", "Travel Enthusiasts — 11 advisors (Interests & Hobbies)", "Advice-Only — 81 advisors (Planning Need)", "Cash Flow/Budgeting — 16 advisors (Planning Need)", "College Planning — 18 advisors (Planning Need)", "Coronavirus Relief — 3 advisors (Planning Need)", "Cross-border Planning — 22 advisors (Planning Need)", "Debt Management — 6 advisors (Planning Need)", "Elder Care Planning — 5 advisors (Planning Need)", "Equity Recipients (RS/RSU SOP ESPP) — 142 advisors (Planning Need)", "Estate Planning — 23 advisors (Planning Need)", "Expatriates — 7 advisors (Planning Need)", "FIRE (Financial Independence Retire Early) — 45 advisors (Planning Need)", "Family Financial Planning — 67 advisors (Planning Need)", "Financial Coaching — 9 advisors (Planning Need)", "Financial Life Planning — 43 advisors (Planning Need)", "Financial Therapy — 6 advisors (Planning Need)", "First Generation Wealth — 10 advisors (Planning Need)", "HENRY (High Earners, Not Rich Yet) — 52 advisors (Planning Need)", "Holistic Financial Planning — 59 advisors (Planning Need)", "Home Buying — 4 advisors (Planning Need)", "In Transition — 5 advisors (Planning Need)", "Income Planning — 35 advisors (Planning Need)", "Inherited Wealth — 46 advisors (Planning Need)", "Investment Planning & Management — 143 advisors (Planning Need)", "New Wealth — 18 advisors (Planning Need)", "Personal Growth & Development — 1 advisors (Planning Need)", "Portfolio Management — 20 advisors (Planning Need)", "Pro Bono — 10 advisors (Planning Need)", "Retirement Planning — 382 advisors (Planning Need)", "Risk Management — 2 advisors (Planning Need)", "SRI/ESG (Socially Responsible Investing/Environmental, Social and Corporate Governance) — 34 advisors (Planning Need)", "Social Security — 19 advisors (Planning Need)", "Special Needs — 8 advisors (Planning Need)", "Student Loan Debt — 18 advisors (Planning Need)", "Tax Planning — 245 advisors (Planning Need)", "Trusts — 3 advisors (Planning Need)", "Ultra High Net-worth — 27 advisors (Planning Need)", "Wealth Management — 55 advisors (Planning Need)", "Work/Life Balance — 13 advisors (Planning Need)", "Airline Pilots — 9 advisors (Profession)", "Artists & Creatives — 12 advisors (Profession)", "Attorneys — 18 advisors (Profession)", "Biotech Professionals — 5 advisors (Profession)", "Business Executives — 55 advisors (Profession)", "Caretakers — 4 advisors (Profession)", "Consultants — 8 advisors (Profession)", "Dentists — 9 advisors (Profession)", "Educators, Teachers, and Academics — 28 advisors (Profession)", "Engineering Professionals — 31 advisors (Profession)", "Entertainment Industry — 8 advisors (Profession)", "Entrepreneurs — 55 advisors (Profession)", "Financial Professionals — 6 advisors (Profession)", "Government Employees — 35 advisors (Profession)", "Independent Contractors — 3 advisors (Profession)", "Medical Professionals — 77 advisors (Profession)", "Military & Veterans — 41 advisors (Profession)", "Oil & Gas — 5 advisors (Profession)", "Optometrists — 2 advisors (Profession)", "Pharmacists — 2 advisors (Profession)", "Professional Athletes — 4 advisors (Profession)", "Public Service Employees — 9 advisors (Profession)", "Real Estate Professionals — 14 advisors (Profession)", "Remote Professionals — 2 advisors (Profession)", "Retail Professionals — 0 advisors (Profession)", "Sales Professionals — 7 advisors (Profession)", "Scientific Professionals — 7 advisors (Profession)", "Self-Employed Individuals — 39 advisors (Profession)", "Startup Founders — 4 advisors (Profession)", "Technology Professionals — 93 advisors (Profession)", "University Employees — 5 advisors (Profession)", "Veterinarians — 3 advisors (Profession)" ] }, "default": [] }, "search": { "title": "Search term", "type": "string", "description": "XYPN's own fuzzy search box. Works best for a NAME ('Livadary' returns exactly the one advisor); broad words over-match because the search also walks bios — 'Mana' returns 803 rows on a 1,233-row directory. Prefer the state and niche filters for segmentation; use this to look up one person or firm.", "default": "" }, "requireWebsite": { "title": "Require a website", "type": "boolean", "description": "Drop advisors with no published website (16.3% of the directory, measured 2026-08-15). Dropped rows are NOT billed. Turn this on when the row feeds an email-finder — the website is the handle those tools enrich from, because XYPN publishes no email or phone.", "default": false }, "maxItems": { "title": "Max advisors", "minimum": 0, "type": "integer", "description": "Hard cap and cost ceiling: you are never charged for more than this many advisors. 0 means everything in scope — the whole 1,233-row directory costs $4.93 at $0.004 per advisor. The default 100 keeps the first click at $0.40. Duplicates never count against it.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy by default — measured 20/20 (100%) on a sustained contiguous page walk, with rotating-IP retries surviving the occasional proxy-side disconnect. RESIDENTIAL also measured 100% but costs more and buys nothing here. You should not need to change this.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }