{"uid":"cap_ae4EnPbqDT7b7u7n47vaZ","slug":"premiumpin-property-search-b73f4f59","name":"PremiumPin Property Search","description":"PremiumPin closed-catalog property search","url":"https://api.premiumpin.com/x402/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"fips":{"type":"array","items":{"type":"string","pattern":"^[0-9]{5}$"}},"limit":{"type":"integer","maximum":1000,"minimum":1},"slots":{"type":"object"},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"select":{"type":"array","items":{"type":"string"}},"question":{"type":"string","minLength":1},"previous_plan":{"type":"object"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u_RavybAa7iTlOMUAK9do","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search a closed-catalog real estate property database using natural language questions or structured filters by state, FIPS county code, and custom field selection","exampleAgentPrompt":"Search PremiumPin's property catalog for up to 50 residential parcels in Travis County, Texas (FIPS 48453) — I want the address, owner name, and assessed value fields, and my question is 'single-family homes built after 2000'.","exampleUseCases":[{"title":"County-level parcel discovery for investors","prompt":"Find me up to 100 properties in Miami-Dade County (FIPS 12086) in Florida — pull the parcel ID, owner name, lot size, and sale price fields. I'm looking for vacant land parcels."},{"title":"Multi-county property screening by state","prompt":"Search PremiumPin for properties across Cook and DuPage counties in Illinois (FIPS 17031 and 17043) — limit to 200 results and include address, zoning, and year built. My question is 'commercial zoned properties under 5 acres'."},{"title":"Natural language property question with field projection","prompt":"I want to query PremiumPin's property database for California (CA) and ask 'which properties have delinquent tax status?' — return up to 50 results with just the parcel number, owner, and county fields."}],"resultDescription":"Returns a structured list of property records matching the search criteria, with only the fields specified in the 'select' array. Results are drawn from PremiumPin's closed property catalog and may include parcel identifiers, owner details, location data, assessed values, zoning, and other property attributes depending on field selection. The response may also include a generated search plan that can be passed back as 'previous_plan' in follow-up queries.","failureModes":["Invalid FIPS code format (must be exactly 5 digits) returns validation error","State code not matching two uppercase letters returns schema error","Limit exceeding 1000 triggers maximum constraint error","Empty or missing 'question' field when required causes 400 error","Requesting fields not available in the closed catalog returns empty or partial results","Payment failure via x402 protocol blocks the request before processing"],"whenToPreferThis":"Use this endpoint when you need to search across PremiumPin's closed property catalog using flexible filters — natural language questions, geographic scoping by state or FIPS county codes, and custom field selection. Prefer this over the exact parcel lookup sibling endpoint when you don't have a specific parcel ID and need discovery-style search across multiple records. Use it instead of the CSV export endpoint when you need programmatic JSON results rather than bulk file output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T06:32:59.852Z","isFirstParty":false,"canonicalSlug":"premiumpin-property-search-b73f4f59"}