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, Instagram Business accounts and Threads accounts.

Overview

Location tagging attaches a physical place (such as a city, office, or venue) to your Facebook, Instagram or Threads 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.

Authorizations

Bearer

Query parameters

qstringRequired

Search query for Facebook locations

Responses

200

List of Facebook locations matching the search query

application/json

idstringRequired

Unique identifier of the location

namestringRequired

Name of the location

infostringOptional

Additional information about the location

Example: Main office in New York City ⋅ 1,030 follow this

verifiedbooleanOptional

Whether the location is verified

Example: true

403

Authentication failure or invalid token

application/json

422

Invalid request or Facebook API error

application/json

get

/locations/facebook

HTTPcURLJavaScriptPython

GET /api/v1/locations/facebook?q=text HTTP/1.1
Host: app.publer.com
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City ⋅ 1,030 follow this",
    "verified": true
  }
]

Search for Instagram locations

get

Search and retrieve Instagram locations based on a query string.

Authorizations

Bearer

Query parameters

qstringRequired

Search query for Instagram locations

Responses

200

List of Instagram locations matching the search query

application/json

idstringRequired

Unique identifier of the location

namestringRequired

Name of the location

infostringOptional

Additional information about the location

Example: Main office in New York City ⋅ 1,030 follow this

verifiedbooleanOptional

Whether the location is verified

Example: true

403

Authentication failure, invalid token, or no Instagram account with Facebook login

application/json

422

Invalid request or Instagram API error

application/json

get

/locations/instagram

HTTPcURLJavaScriptPython

GET /api/v1/locations/instagram?q=text HTTP/1.1
Host: app.publer.com
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City ⋅ 1,030 follow this",
    "verified": true
  }
]

Search for Threads locations

get

Search and retrieve Threads locations based on a query string.

Authorizations

Bearer

Query parameters

qstringRequired

Search query for Threads locations

Responses

200

List of Threads locations matching the search query

application/json

idstringRequired

Unique identifier of the location

namestringRequired

Name of the location

infostringOptional

Additional information about the location

Example: Main office in New York City

403

Authentication failure, invalid token, or no Threads account

application/json

422

Invalid request or Threads API error

application/json

get

/locations/threads

HTTPcURLJavaScriptPython

GET /api/v1/locations/threads?q=text HTTP/1.1
Host: app.publer.com
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City"
  }
]

Location Object Example:

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

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, Instagram Business and Threads 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

• Publishing Methods

• Content Types

• Media Handling