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 and retrieve Facebook locations based on a query string.
Search query for Facebook locations
List of Facebook locations matching the search query
Authentication failure or invalid token
Invalid request or Facebook API error
GET /api/v1/locations/facebook 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 and retrieve Instagram locations based on a query string.
Search query for Instagram locations
List of Instagram locations matching the search query
Authentication failure, invalid token, or no Instagram account with Facebook login
Invalid request or Instagram API error
GET /api/v1/locations/instagram 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 and retrieve Threads locations based on a query string.
Search query for Threads locations
List of Threads locations matching the search query
Authentication failure, invalid token, or no Threads account
Invalid request or Threads API error
GET /api/v1/locations/threads 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
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
Last updated
Was this helpful?