Skip to main content

Listings

The Listings API provides access to listing data and allows external systems to import or update rental listings in ShowMojo.

Authentication​

The Listings API uses token authentication. HTTP Basic auth with a ShowMojo login and password is deprecated and stops working on 2027-01-19; see the versioning and deprecation policy.

Send the token in the Authorization header using this format:

Authorization: Token {token}

The token is available in Settings > Listing Import.

Token lifecycle​

  • Each account has one active API token, shown in Settings > Listing Import. The same token authenticates every token-authenticated endpoint.
  • Generating a new token revokes the previous one immediately. Requests that still send the old token receive 401 Unauthorized. Update every integration that uses the token before you generate a new one.
  • There is no separate revoke action: to revoke a token, generate a new one.
  • Generating a token does not affect Zapier connections, which authenticate with OAuth 2.0.

Notes​

  • Photos: When the account has watermarking enabled, each photo returns a single watermarked URL instead of three size variants.
  • Highlights: If the listing is associated with a property that has highlights, they are appended to the listing's highlights (separated by a double newline).
  • Details: Combines detail values from both the listing and its parent property.
  • Neighborhoods: The neighborhood, primary_neighborhood, and secondary_neighborhood fields are mutually exclusive depending on account configuration. Custom neighborhoods take precedence.
  • External ID/Source: Derived from the first non-null integration ID field on the listing. Only one external source is returned per listing.