Resources

Unique identifier for this location.

Output only.

Official public name of the business.

Max. length is 125 characters.

Primary contact phone number for the business.

International format is required. For example: "+49 351 8629318", "+1 541-754-3010"

Two-letter country code where the business is located, as defined by the ISO 3166-1 code reference (the Alpha-2 code column).

Supported values: US, AU, FR, DE, GB, CA, IN, ES, IT, NL, BR, AT, BE, DK, FI, NO, PL, SE, CH, JP, MX, IL, NZ, SG, ZA, TR, AE, HK, ID, VN, PK, CO, IE, BD, MY, SA, RO, CL, PH, PT, NG, GR, TH, AR, PE, KE, HU, CZ, RS, NP, LT, UA, BG, EC, CY, HR, EE, LV, IS, SK, SI, AM, AD, PY, GY, EG, MV, UY, SR, KH, BO, LA, MT, PA, PR, TN, DO, MN, GU, VE, ME, MP The list of supported countries will increase in the future.

Highest administrative subdivision for postal addresses in a country or region. For example, a state, province, oblast, or prefecture. Specifically, for Spain this is the province rather than the autonomous community (for example, "Barcelona" instead of "Catalonia"). Many countries do not use administrative areas in postal addresses.

Required for Canada, Australia, Brazil, India, and US.

City or locality name.

Max. length is 64 characters.

Postal or ZIP code.

Required for the following countries: US, AU, FR, DE, GB, CA, IN, ES, IT, NL, BR, AT, BE, DK, FI, NO, PL, SE, CH, JP, MX, IL, NZ, SG, ZA, TR, ID, VN, PK, CO, IE, BD, MY, SA, RO, CL, PH, PT, NG, GR, TH, AR, PE, KE, HU, CZ, RS, NP, LT, UA, BG, EC, CY, HR, EE, LV, IS, SK, SI, AM, AD, PY, EG, MV, UY, KH, LA, MT, PA, PR, TN, DO, MN, GU, VE, ME, MP

Street address, including house number and street name.

Max. length is 190 characters.

Supplemental address information (for example, suite, floor, or building).

Max. length is 64 characters.

URL for the business. Must start with https://. If possible, use a URL specific to this location rather than a generic brand website.

Max. length is 255 characters.

Detailed description of the business and its services.

Min. length is 10 characters. Max. length is 750 characters.

The Business Hours object.

List of Special Hours objects.

List of More Hours objects.

List of Service Area Place objects.

List of category identifiers (max. 10) that describe the business and help customers find relevant services.

Identifiers must be retrieved from the Get Categories endpoint.

If set to true, the physical address is hidden from public listings and search results. If the address is hidden, service_area_places must be populated to define the business’s geographic reach.

The Coordinates object.

Promotional message or announcement displayed on the business profile.

Max. length is 50 characters.

Call-to-action URL associated with the featured message.

Example: "https://www.semrush.com/local-business/start/"

Max. length is 255 characters.

URL of a YouTube video showcasing the business.

Example: "https://www.youtube.com/watch?v=ndJB4J951_k"

Max. length is 150 characters.

Instagram profile handle.

Example: semrush

Max. length is 30 characters.

X (formerly Twitter) profile handle.

Example: semrush

Max. length is 15 characters.

Date ("YYYY-MM-DD") when a temporarily closed location is scheduled to reopen. This must be a future date and is only applicable if the location status is set to temporarily closed.

Supported payment methods for the business.

Identifiers must be retrieved from the Get Payment Options endpoint.

Supported values: "COMPLETED", "PROCESSING", "FAILED".

Current status of the location.

COMPLETED: Location is ready for use. All features and data management are fully accessible. PROCESSING: Location is currently being initialized. Data editing is unavailable until the process completes. FAILED: Location could not be created. This status does not consume user limits. You may delete the location and create a new location using your existing limit. Contact Semrush Customer Support if the issue persists.

Output only.

If true, the location is frozen due to an overdue payment. A frozen location cannot be edited, and management actions cannot be performed on its associated resources (such as images, listings, etc.).

Output only.

Date and time when the location was first submitted in the "YYYY-MM-DDThh:mm:ss" format (for example, "2026-03-10T17:03:42").

Output only.

List of Error objects.

Output only.

List of Hour Range objects for Monday.

List of Hour Range objects for Tuesday.

List of Hour Range objects for Wednesday.

List of Hour Range objects for Thursday.

List of Hour Range objects for Friday.

List of Hour Range objects for Saturday.

List of Hour Range objects for Sunday.

Start of the interval in the "HH:MM" format (for example, "09:00").

End of the interval in the "HH:MM" format (for example, "20:00").

Supported values: "CLOSED", "OPENED_ALL_DAY", "RANGE".

If the value is "RANGE", the times parameter must be specified.

If the value is "CLOSED" or "OPENED_ALL_DAY", the times parameter must not be specified.

Date of the specified item. Must be in the "yyyy-mm-dd" format.

The value must be unique across all special_hours entries—only one item is allowed for each date.

List of Hour Range objects. Must be specified only for type = "RANGE". The time ranges of the specified day (or consecutive specified days) can’t overlap.

Type of hours. Valid values must be retrieved from the Get More Hour Types endpoint.

Weekly operating schedule for this hour type. An empty list implies the location is closed. The Business Hours object.

Unique identifier for the location (Google Place ID).

Get the Google Place ID from the Google Maps Platform documentation.

Max. length is 500 characters.

Latitude in decimal degrees (for example, 40.7128).

Min. value is -90, max. value is 90.

Longitude in decimal degrees (for example, -74.0060).

Min. value is -180, max. value is 180.

Unique, machine-readable string identifying the error type (for example, "INVALID_ZIP_CODE").

Human-readable explanation of the error to help with debugging.

Unique identifier for the image.

Image category. Possible values: PHOTO, PROFILE, COVER.

Public URL where the image can be accessed or downloaded.

Caption describing the image content.

Timestamp when the image was created, in the ISO 8601 format (YYYY-MM-DDThh:mm:ss).

Unique identifier of the listing across all listing platforms.

Current connection status of the listing.

Supported values: CONNECTED, SUBMITTED, UNAVAILABLE, DISCONNECTED, PROCESSING.

Display name of the listing platform (for example, "Apple Maps", "Google Business Profile").

Indicates if the listing can be toggled (enabled or disabled) by the user.

Public URL of the business profile on the listing platform.

Identifier of the parent listing, if this listing belongs to a hierarchy. Disabling a parent listing typically affects all its child listings.