All pages
Powered by GitBook
1 of 1

Loading...

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:

Location Object Example:

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:

Parameters

Field
Type
Description

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

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)

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)

Publishing Methods
Content Types
Media Handling
{
  "id": "308281375929281",
  "name": "Tirana",
  "info": "Tirana, Albania â‹… 590 follow this",
  "verified": true
}
{
  "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"
            }
          }
        ]
      }
    ]
  }
}

Search for Facebook locations

get

Search and retrieve Facebook locations based on a query string.

Authorizations
Query parameters
qstringRequired

Search query for Facebook locations

Responses
200

List of Facebook locations matching the search query

application/json
403

Authentication failure or invalid token

application/json
422

Invalid request or Facebook API error

application/json
get
/locations/facebook

Search for Instagram locations

get

Search and retrieve Instagram locations based on a query string.

Authorizations
Query parameters
qstringRequired

Search query for Instagram locations

Responses
200

List of Instagram locations matching the search query

application/json
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

Search for Threads locations

get

Search and retrieve Threads locations based on a query string.

Authorizations
Query parameters
qstringRequired

Search query for Threads locations

Responses
200

List of Threads locations matching the search query

application/json
403

Authentication failure, invalid token, or no Threads account

application/json
422

Invalid request or Threads API error

application/json
get
/locations/threads
[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City â‹… 1,030 follow this",
    "verified": true
  }
]
[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City â‹… 1,030 follow this",
    "verified": true
  }
]
[
  {
    "id": "text",
    "name": "text",
    "info": "Main office in New York City"
  }
]
GET /api/v1/locations/facebook?q=text HTTP/1.1
Host: app.publer.com
Accept: */*
GET /api/v1/locations/instagram?q=text HTTP/1.1
Host: app.publer.com
Accept: */*
GET /api/v1/locations/threads?q=text HTTP/1.1
Host: app.publer.com
Accept: */*