Get information about a place

API reference contents

GET geo/id/:place_id

Returns all the information about a known place.

Resource URL

https://api.twitter.com/1.1/geo/id/:place_id.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes
Requests / 15-min window (user auth) 75

Parameters

Name Required Description Default Value Example
place_id required A place in the world. These IDs can be retrieved from geo/reverse_geocode. df51dec6f4ee2b2c

Example Request

twurl /1.1/geo/id/df51dec6f4ee2b2c.json

Example Response

{
  "id": "df51dec6f4ee2b2c",
  "url": "https://api.twitter.com/1.1/geo/id/df51dec6f4ee2b2c.json",
  "place_type": "neighborhood",
  "name": "Presidio",
  "full_name": "Presidio, San Francisco",
  "country_code": "US",
  "country": "United States",
  "contained_within": [
    {
      "id": "5a110d312052166f",
      "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json",
      "place_type": "city",
      "name": "San Francisco",
      "full_name": "San Francisco, CA",
      "country_code": "US",
      "country": "United States",
      "centroid": [
        -122.4461400159226,
        37.759828999999996
      ],
      "bounding_box": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -122.514926,
              37.708075
            ],
            [
              -122.514926,
              37.833238
            ],
            [
              -122.357031,
              37.833238
            ],
            [
              -122.357031,
              37.708075
            ],
            [
              -122.514926,
              37.708075
            ]
          ]
        ]
      },
      "attributes": {
      }
    }
  ],
  "geometry": null,
  "polylines": [

  ],
  "centroid": [
    -122.46598425785236,
    37.79989625
  ],
  "bounding_box": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.4891333,
          37.786925
        ],
        [
          -122.4891333,
          37.8128675
        ],
        [
          -122.446306,
          37.8128675
        ],
        [
          -122.446306,
          37.786925
        ],
        [
          -122.4891333,
          37.786925
        ]
      ]
    ]
  },
  "attributes": {
    "geotagCount": "6",
    "162834:id": "2202"
  }
}

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.