Amplify Syndication Gem

amplify_syndication is a Ruby gem that provides a simple interface to interact with the Amplify Syndication API. It includes methods to manage properties, media, and other related resources in real estate applications.

• Fetch and manage Property resources:
  • Retrieve specific properties by ListingKey
  • Query for properties with advanced filtering and sorting
• Fetch and manage Media resources:
  • Retrieve specific media by MediaKey
  • Query for media associated with properties, offices, and members
• Easy-to-use replication features for synchronizing data

Add the gem to your Gemfile:

gem 'amplify_syndication'

Then run:

bundle install

Or install it manually:

gem install amplify_syndication

You need to configure the base URL and access token for the Amplify Syndication API. Add the following to your application’s initializer or a setup script:

AmplifySyndication.configure do |config|
  config.base_url = "https://query.ampre.ca/odata"
  config.access_token = "your_api_access_token_here"
end

Create an instance of the API:

api = AmplifySyndication::API.new

Retrieve metadata for the API:

metadata = api.fetch_metadata
puts metadata

Perform an initial download of properties for replication:

properties = api.perform_initial_download(batch_size: 100)
puts "Downloaded #{properties.size} properties."

Retrieve full details of a property by its ListingKey:

property = api.fetch_property_by_key("12345")
puts property

Query for properties with advanced filtering:

filtered_properties = api.fetch_filtered_properties(
  filter: "City eq 'Toronto' and ListPrice gt 500000",
  select: "ListingKey,City,ListPrice",
  orderby: "ListPrice desc",
  top: 10
)
puts filtered_properties

Get the total count of properties:

count = api.fetch_property_count
puts "Total properties: #{count['@odata.count']}"

Retrieve full details of a media record by its MediaKey:

media = api.fetch_media_by_key("61400d19-417e-4f43-b36e-efffb352a128")
puts media

Retrieve all media records associated with a specific resource:

property_media = api.fetch_media_by_resource("Property", "12345")
puts property_media

Query for recently created or modified media:

recent_media = api.fetch_recent_media(
  filter: "ResourceName eq 'Property'",
  modification_date: "2023-12-01T00:00:00Z"
)
puts recent_media

If an API call fails, the gem raises a StandardError with details of the HTTP response:

begin
  property = api.fetch_property_by_key("invalid_key")
rescue StandardError => e
  puts "Error: #{e.message}"
end

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit your changes (git commit -m 'Add a new feature')
4. Push to the branch (git push origin feature/new-feature)
5. Create a Pull Request

Bug reports and pull requests are welcome on GitHub at https://github.com/gryphonandrook/amplify_syndication.

The gem is available as open source under the terms of the MIT License.