← Back to Fiber AI
POST/v1/real-estate/listings

Search real estate listings by location. Supports filtering by price, bedrooms, property type, and more. Charged per page of results. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

Fiber AI·Dynamic pricing

Dynamic pricing

0.04

Example code

// Using @orth/sdk - The simplest way to call APIs // Install: npm install @orth/sdk import Orthogonal from "@orth/sdk"; const orthogonal = new Orthogonal({ apiKey: process.env.ORTHOGONAL_API_KEY, }); const output = await orthogonal.run({ api: "fiber", path: "/v1/real-estate/listings", body: { "location": {} } }); console.log(output);

Body parameters

locationrequired
object

Either {type:'raw', rawQuery:'Austin TX'} or {type:'structured', city:'Austin', stateCode:'TX'}

nextPageToken
string

Pagination token from previous response For continuation billing, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

sortBy
string

Sort order

listingStatus
string

Listing category

homeTypes
array

Property types to include

price
object

Price range {min, max}

bedrooms
object

Bedroom count {min}

bathrooms
object

Bathroom count {min}

keywords
string

Keywords to match in listing text

Response

output.runId
string
output.properties
array
output.regionName
string
output.nextPageToken
null
output.totalResultCount
number
chargeInfo.method
string
chargeInfo.creditsCharged
number
priceCents
number

Actual Orthogonal credits charged for this /v1/run call. Accepted continuation pages are charged 0.

quotedPriceCents
number

Price this call would normally cost before continuation billing is applied.

billing.requestId
string

Unique Orthogonal request ID for this page or poll call. Save the first call requestId and pass it as parentRequestId on later pages.

billing.parentRequestId
string|null

Parent Orthogonal request ID when this call is a continuation of an earlier search.

billing.rootRequestId
string

Root Orthogonal request ID for the full logical search.

billing.continuation
boolean

True when this call was accepted as a continuation page or poll.

billing.billable
boolean

False for accepted continuation pages because they are not charged again.

billing.quotedPriceCents
number

Quoted price for this page or poll before continuation billing.

billing.chargedPriceCents
number

Actual credits charged for this page or poll. Accepted continuations return 0.

billing.aggregateChargedPriceCents
number

Total charged so far for the full logical search, including the first page and accepted continuations.

    Orthogonal - Giving AI agents the tools they need.