# 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 > Search and retrieve Facebook locations based on a query string. ```json {"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Locations","description":"Endpoints for searching social media locations"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{},"schemas":{"Location":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the location"},"name":{"type":"string","description":"Name of the location"},"info":{"type":"string","description":"Additional information about the location"},"verified":{"type":"boolean","description":"Whether the location is verified"}},"required":["id","name"]},"403ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}},"ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/locations/facebook":{"get":{"tags":["Locations"],"summary":"Search for Facebook locations","description":"Search and retrieve Facebook locations based on a query string.","operationId":"searchFacebookLocations","parameters":[{"schema":{"type":"string"},"name":"q","in":"query","description":"Search query for Facebook locations","required":true}],"responses":{"200":{"description":"List of Facebook locations matching the search query","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Location"}}}}},"403":{"description":"Authentication failure or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403ErrorResponse"}}}},"422":{"description":"Invalid request or Facebook API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Search for Instagram locations > Search and retrieve Instagram locations based on a query string. ```json {"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Locations","description":"Endpoints for searching social media locations"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{},"schemas":{"Location":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the location"},"name":{"type":"string","description":"Name of the location"},"info":{"type":"string","description":"Additional information about the location"},"verified":{"type":"boolean","description":"Whether the location is verified"}},"required":["id","name"]},"ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/locations/instagram":{"get":{"tags":["Locations"],"summary":"Search for Instagram locations","description":"Search and retrieve Instagram locations based on a query string.","operationId":"searchInstagramLocations","parameters":[{"schema":{"type":"string"},"name":"q","in":"query","description":"Search query for Instagram locations","required":true}],"responses":{"200":{"description":"List of Instagram locations matching the search query","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Location"}}}}},"403":{"description":"Authentication failure, invalid token, or no Instagram account with Facebook login","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request or Instagram API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Search for Threads locations > Search and retrieve Threads locations based on a query string. ```json {"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Locations","description":"Endpoints for searching social media locations"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{},"schemas":{"ThreadsLocation":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the location"},"name":{"type":"string","description":"Name of the location"},"info":{"type":"string","description":"Additional information about the location"}},"required":["id","name"]},"ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/locations/threads":{"get":{"tags":["Locations"],"summary":"Search for Threads locations","description":"Search and retrieve Threads locations based on a query string.","operationId":"searchThreadsLocations","parameters":[{"schema":{"type":"string"},"name":"q","in":"query","description":"Search query for Threads locations","required":true}],"responses":{"200":{"description":"List of Threads locations matching the search query","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ThreadsLocation"}}}}},"403":{"description":"Authentication failure, invalid token, or no Threads account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request or Threads API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` **Location Object Example:** ```json { "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:** ```json { "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
FieldTypeDescription
accounts[].idstringTarget account ID
accounts[].scheduled_atstringISO 8601 timestamp for scheduling (omit for immediate publish)
accounts[].locationobjectLocation object to tag (see below)
location.idstringUnique identifier of the location (from search results)
location.namestringName of the location
location.infostringAdditional info about the location (optional)
location.verifiedbooleanWhether the location is verified (optional)
location.addressstringPhysical address (optional)
location.checkinsintegerNumber 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](/docs/posting/create-posts/publishing-methods.md) * [Content Types](/docs/posting/create-posts/content-types.md) * [Media Handling](/docs/posting/create-posts/media-handling.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://publer.com/docs/posting/create-posts/content-types/post-with-location.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.