The Hive by Honeycomb

Listings

listingsFeed

Access all listings available from the Hive marketplace

A [RESO-compliant](https://www.reso.org/) listings feed


/the_hive/listings/feed

Usage and SDK Samples

curl -X GET \
 -H "Authorization: Bearer [[accessToken]]" \
 -H "Accept: application/json" \
 "https://app.thehoneycomb.ai/api/the_hive/listings/feed?ModificationTimestamp=2025-01-01T00:00Z"
import org.openapitools.client.*;
import org.openapitools.client.auth.*;
import org.openapitools.client.model.*;
import org.openapitools.client.api.ListingsApi;

import java.io.File;
import java.util.*;

public class ListingsApiExample {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();

        // Configure Bearer access token for authorization: api_key
        HttpBearerAuth api_key = (HttpBearerAuth) defaultClient.getAuthentication("api_key");
        api_key.setBearerToken("BEARER TOKEN");

        // Create an instance of the API class
        ListingsApi apiInstance = new ListingsApi();
        Date modificationTimestamp = 2025-01-01T00:00Z; // Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

        try {
            listingsFeed_200_response result = apiInstance.listingsFeed(modificationTimestamp);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ListingsApi#listingsFeed");
            e.printStackTrace();
        }
    }
}
import 'package:openapi/api.dart';

final api_instance = DefaultApi();

final Date modificationTimestamp = new Date(); // Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

try {
    final result = await api_instance.listingsFeed(modificationTimestamp);
    print(result);
} catch (e) {
    print('Exception when calling DefaultApi->listingsFeed: $e\n');
}

import org.openapitools.client.api.ListingsApi;

public class ListingsApiExample {
    public static void main(String[] args) {
        ListingsApi apiInstance = new ListingsApi();
        Date modificationTimestamp = 2025-01-01T00:00Z; // Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

        try {
            listingsFeed_200_response result = apiInstance.listingsFeed(modificationTimestamp);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ListingsApi#listingsFeed");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure Bearer access token for authorization: api_key
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

// Create an instance of the API class
ListingsApi *apiInstance = [[ListingsApi alloc] init];
Date *modificationTimestamp = 2025-01-01T00:00Z; // Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month. (optional) (default to null)

// Access all listings available from the Hive marketplace
[apiInstance listingsFeedWith:modificationTimestamp
              completionHandler: ^(listingsFeed_200_response output, NSError* error) {
    if (output) {
        NSLog(@"%@", output);
    }
    if (error) {
        NSLog(@"Error: %@", error);
    }
}];
var TheHiveByHoneycomb = require('the_hive_by_honeycomb');
var defaultClient = TheHiveByHoneycomb.ApiClient.instance;

// Configure Bearer access token for authorization: api_key
var api_key = defaultClient.authentications['api_key'];
api_key.accessToken = "YOUR ACCESS TOKEN";

// Create an instance of the API class
var api = new TheHiveByHoneycomb.ListingsApi()
var opts = {
  'modificationTimestamp': 2025-01-01T00:00Z // {Date} Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listingsFeed(opts, callback);
using System;
using System.Diagnostics;
using Org.OpenAPITools.Api;
using Org.OpenAPITools.Client;
using Org.OpenAPITools.Model;

namespace Example
{
    public class listingsFeedExample
    {
        public void main()
        {
            // Configure Bearer access token for authorization: api_key
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            // Create an instance of the API class
            var apiInstance = new ListingsApi();
            var modificationTimestamp = 2025-01-01T00:00Z;  // Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month. (optional)  (default to null)

            try {
                // Access all listings available from the Hive marketplace
                listingsFeed_200_response result = apiInstance.listingsFeed(modificationTimestamp);
                Debug.WriteLine(result);
            } catch (Exception e) {
                Debug.Print("Exception when calling ListingsApi.listingsFeed: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure Bearer access token for authorization: api_key
OpenAPITools\Client\Configuration::getDefaultConfiguration()->setAccessToken('', 'YOUR_ACCESS_TOKEN');

// Create an instance of the API class
$api_instance = new OpenAPITools\Client\Api\ListingsApi();
$modificationTimestamp = 2025-01-01T00:00Z; // Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

try {
    $result = $api_instance->listingsFeed($modificationTimestamp);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ListingsApi->listingsFeed: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::OPenAPIClient::Configuration;
use WWW::OPenAPIClient::ListingsApi;

# Configure Bearer access token for authorization: api_key
$WWW::OPenAPIClient::Configuration::access_token = 'YOUR_ACCESS_TOKEN';

# Create an instance of the API class
my $api_instance = WWW::OPenAPIClient::ListingsApi->new();
my $modificationTimestamp = 2025-01-01T00:00Z; # Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

eval {
    my $result = $api_instance->listingsFeed(modificationTimestamp => $modificationTimestamp);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ListingsApi->listingsFeed: $@\n";
}
from __future__ import print_statement
import time
import openapi_client
from openapi_client.rest import ApiException
from pprint import pprint

# Configure Bearer access token for authorization: api_key
openapi_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# Create an instance of the API class
api_instance = openapi_client.ListingsApi()
modificationTimestamp = 2025-01-01T00:00Z # Date | Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month. (optional) (default to null)

try:
    # Access all listings available from the Hive marketplace
    api_response = api_instance.listings_feed(modificationTimestamp=modificationTimestamp)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ListingsApi->listingsFeed: %s\n" % e)
extern crate ListingsApi;

pub fn main() {
    let modificationTimestamp = 2025-01-01T00:00Z; // Date

    let mut context = ListingsApi::Context::default();
    let result = client.listingsFeed(modificationTimestamp, &context).wait();

    println!("{:?}", result);
}

Scopes

Parameters

Query parameters
Name Description
ModificationTimestamp
Date (date-time)
Filter listings by when they were most recently updated. If no value is provided it will default to listings from the past month.

Responses