The Datafiniti Support Center

Welcome to the Datafiniti Support developer hub. You'll find comprehensive guides and documentation to help you start working with Datafiniti Support as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides    

Searching by Address in Property or Business Data

How to Search by Address in Property or Business Data

One of the more common use cases we see is customers looking for a specific property or business using the address field.

The tricky thing about searching by an address is that addresses have multiple parts that can vary from site to site. Think about these examples:

Variation 1

Variation 2

Variation 3

Street

St

St.

Avenue

Ave

Ave.

Lane

Ln

Ln.

Road

Rd

Rd.

These are just a few examples of parts of an address that can vary. When using a specific address in your query, we will need to remove these variables to ensure you get the specific property or business we are querying.

You can do this in the Portal or with our API. Let's review both use cases.

1. Searching by Address in the API

In this example, we are going to search for this property:

4801 Yucca Hill Drive
Austin, TX 78744

When we format the query, we will remove any parts that can be abbreviated; in this case, the word Drive like this:

"query": "address:\"4801 Yucca Hill\"",

Now we will want to add additional parameters to ensure that we get the property in the right city and state. However, these values can also have variances in them. In some cases, a website may use a specific variation of a city or may omit the city altogether. To get the highest probability of success, we will add these parameters:

  • AND province:TX to ensure that the address is in the correct state
  • AND (city:Austin OR postalCode:78744) to ensure that not only is this address in TX, but it also has EITHER a city value of Austin or a postalCode value of 78744

When put together, your query will look like this:

"query": "address:\"4801 Yucca Hill\" AND province:TX AND (city:Austin OR postalCode:78744)",

❗️

Does this query not make sense to you?

If this query structure doesn't make sense to you, please check out either the Postman: Property Data or Postman: Business Data walkthrough to review query composition and then come back.

When I run this query in the API using Postman, I get the expected property back!

This is the response from the Datafiniti API showing that we in fact got the property we were looking for. I am using a custom view, which is not displaying the full Property Data Schema. Check it out if you want to see all the data points we collect.

2. Searching by Address in the Portal

Using the techniques discussed in the Portal: Advanced Query tutorial, we can take the above query and translate it into a URL request on the portal.

https://portal.datafiniti.co/property?query=address:"4801 Yucca Hill" AND province:TX AND (city:Austin OR postalCode:78744)
https://portal.datafiniti.co/property?query=address:%224801%20Yucca%20Hill%22%20AND%20province:TX%20AND%20(city:Austin%20OR%20postalCode:78744)

You can copy and paste the text from the Text tab above into a new browser window or tab and it'll show you the same property. In order for the browser to understand it, it'll convert the query into HTML, like on the HTML tab.

Here, we can see the same Property being returned via the Portal.

📘

Property and Business Data

While this walkthrough has been using the Property database, you can do the exact same things with the Business database as well.

Updated 8 days ago


What's Next

Now that you've found the property or business you're looking for, learn how to download your results.

Portal: Downloading Results
Postman: Downloading Results

Searching by Address in Property or Business Data


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.