data/properties

The data endpoint lets you run preview searches and initiate downloads for property data.

Returns

If you set download=false (or don't set it), the data/properties API call will return a list of matching properties for your query.

  • If you don't set records when download=false, it will return up to 10 properties.
  • You can set records to a value between 0 and 10 to return up to that many properties.

If you set download=true, it will return a request object that can be used to monitor the status of the download request.

  • If you don't set records when download=true, it will initiate a download request for all matching businesses.
  • You can set records to a value between 1 and the number of matching businesses.

Response Codes and Messages

Response CodeError MessageWhat You Should Do
200N/AEverything worked! You should check out the awesome data you just requested.
400field name does not exist in property schemaMake sure you're using the correct name for a field. Consult the business data schema for available fields.
400invalid queryYour query syntax has a mistake somewhere. Check what you're setting for q for any mistakes.
400view does not existMake sure you're using the correct value for view. See a list of available views.
401N/AYou're using an invalid API token. Check out your account page on the Datafiniti Portal to make sure you have the right token.
Query Params
string
Defaults to properties_all

Determines which fields will be returned. See all available views.

string
Defaults to json

csv for CSV-formatted data. json for JSON-formatted data.

boolean
Defaults to false

false to see a real-time preview. true to initiate a download.

int32
Defaults to 1

The number of properties you want returned. Set it to a blank value if you want all products returned. If download is set to false and records is left blank, then a default value of 10 will be used.

string
Defaults to categories:hotels

A search query that specifies what data to return. Use the business schema to see which fields you can query on.

Response

Language
Credentials
apiKey
Request
Response
Choose an example:
application/json