Foursquare Business Search

Foursquare Business Search looks for a company in Foursquare place and business-listing data. The Foursquare Workflow Builder block exposes the foursquare service for business entities.

Requirements

Application field	Requirement	Notes
Business legal name	Required	Used as the company search term.
Business address city	Optional	Recommended to improve matching.
Business address state	Optional	Recommended to improve matching; use a state code.

Run Foursquare Business Search

Call Enrich Business Credit Application with provider set to foursquare, then poll Get Commercial Data with services[]=foursquare.

{
  "provider": "foursquare"
}

The asynchronous result appears at commercial_data.foursquare, the lifecycle message appears at statuses.foursquare, and the stored request appears at request_data.foursquare.

Foursquare Business Search is not included in the current Data Orchestration service catalog.

What the service returns

Response area	Meaning
Response array	Candidate Foursquare places.
`location`	Street, locality, region, and postal-code information.
Categories and features	Provider categories, payment methods, and other venue features.
Hours and contact fields	Operating hours, telephone, website, and social profiles.
`photos`	Components used to construct provider image URLs.

Representative response

[
  {
    "name": "Example Business",
    "fsq_id": "5069dfe3e4b029655d7903f6",
    "location": {
      "address": "475 Anton Blvd",
      "locality": "Costa Mesa",
      "region": "CA",
      "postcode": "92626"
    },
    "description": "Provider description",
    "categories": [
      {
        "name": "Financial Service"
      }
    ],
    "features": {
      "payment": {
        "credit_cards": {
          "visa": true,
          "amex": true
        }
      }
    },
    "hours": {
      "display": "Mon 9:00 AM-5:00 PM",
      "regular": [
        {
          "day": 1,
          "open": "0900",
          "close": "1700"
        }
      ]
    },
    "score": 42.8,
    "tel": "(949) 555-0100",
    "website": "https://example.com",
    "social_media": {
      "twitter": "example"
    }
  }
]

The result is an array of possible places, not a verified single match. Optional fields can be omitted or empty.

Response attributes

Attribute	Type	Meaning	Possible values or units	When returned
`[]`	Array	Candidate Foursquare places.	Zero or more place objects.	On a successful lookup.
`[].name`	String or null	Place name.	Provider text.	When available.
`[].fsq_id`	String or null	Foursquare place identifier.	Provider identifier.	When available.
`[].location`	Object or null	Place address.	Can contain `address`, `locality`, `region`, and `postcode`.	When available.
`[].description`	String or null	Provider description.	Provider text.	When available.
`[].categories`	Array	Place categories.	Items can contain `name`.	When available.
`[].features.payment.credit_cards`	Object or null	Accepted-card indicators.	Boolean map such as `visa`, `amex`, or `master_card`.	When available.
`[].hours.display`	String or null	Provider-formatted hours.	Text.	When available.
`[].hours.regular`	Array	Structured weekly hours.	`day` uses `1` through `7`; `open` and `close` use `HHMM` in the fixture.	When available.
`[].score`	Number or null	Upstream match or ranking score.	Scale and business meaning are not defined in the repositories.	When available.
`[].tel`	String or null	Place telephone.	Provider-formatted text.	When available.
`[].website`	String or null	Place website.	URL text.	When available.
`[].social_media`	Object or null	Social profile identifiers.	Provider-controlled key/value object.	When available.
`[].photos`	Array	Photo URL components.	Each usable item contains `prefix` and `suffix`.	When available.
`error`	String	Failure or no-result message.	Service-generated text.	When the lookup fails.

Errors and statuses

statuses.foursquare describes the Lendflow request lifecycle. Success means a response was stored; it does not guarantee that every listing field was found. A response containing error marks the request as failed.

FAQ

Why does the response schema vary?

Lendflow stores the upstream Foursquare result without a fixed field-level normalization contract.

Can this service run in Data Orchestration?

It is not included in the current Data Orchestration service catalog.