Go to website

Post with Location

Tag your posts with a real-world location to increase engagement and reach more local audiences. Publer supports location tagging for Facebook Pages and Instagram Business accounts.

Overview

Location tagging attaches a physical place (such as a city, office, or venue) to your Facebook or Instagram post. This is especially helpful for businesses, events, and local marketing.

Step 1: Search for a Location

Use Publer’s dedicated endpoints to search and select the correct location for your post:

Search for Facebook locations

get

Search and retrieve Facebook locations based on a query string.

Query parameters
qanyRequired

Search query for Facebook locations

Responses
200
List of Facebook locations matching the search query
application/json
get
GET /api/v1/locations/facebook HTTP/1.1
Host: app.publer.com
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City",
    "verified": true,
    "address": "123 Main St, New York, NY 10001",
    "checkins": 150
  }
]

Search for Instagram locations

get

Search and retrieve Instagram locations based on a query string.

Query parameters
qanyRequired

Search query for Instagram locations

Responses
200
List of Instagram locations matching the search query
application/json
get
GET /api/v1/locations/instagram HTTP/1.1
Host: app.publer.com
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City",
    "verified": true,
    "address": "123 Main St, New York, NY 10001",
    "checkins": 150
  }
]

Location Object Example:

{
  "id": "308281375929281",
  "name": "Tirana",
  "info": "Tirana, Albania ⋅ 590 follow this",
  "verified": true,
  "address": "Tirana, Albania",
  "checkins": 590
}

Step 2: Schedule or Publish a Post with a Location

When creating or scheduling a post, use the location object inside the relevant accounts array:

Example Request:

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "Facebook location"
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-06-14T10:21:00+02:00",
            "location": {
              "id": "308281375929281",
              "name": "Tirana",
              "info": "Tirana, Albania ⋅ 590 follow this",
              "verified": null,
              "address": "Tirana, Albania",
              "checkins": "590"
            }
          }
        ]
      }
    ]
  }
}

Parameters

Field
Type
Description

accounts[].id

string

Target account ID

accounts[].scheduled_at

string

ISO 8601 timestamp for scheduling (omit for immediate publish)

accounts[].location

object

Location object to tag (see below)

location.id

string

Unique identifier of the location (from search results)

location.name

string

Name of the location

location.info

string

Additional info about the location (optional)

location.verified

boolean

Whether the location is verified (optional)

location.address

string

Physical address (optional)

location.checkins

integer

Number of check-ins (optional)

Key Notes & Limitations

  • Supported Networks: Location tagging is supported for Facebook Pages and Instagram Business accounts only.

  • Media Types Restrictions: You cannot add locations to Facebook regular videos, GIFs, Stories, or Reels scheduled via reminders.

  • Other Networks: Twitter/X no longer supports location tagging via API.

  • Search Required: Always search and select the correct location using the endpoints above before scheduling your post.

Best Practices

  • Always verify the location by name and address before tagging.

  • Tagging your business or event location can boost local discovery and engagement.

  • Use location tags for promotions, events, or posts relevant to specific regions

Related Topics

PreviousPost with WatermarkNextPlatform-Specific Formats

Last updated

Was this helpful?