# Instagram API

**Provider:** Instagram
**Category:** maps
**Base URL:** `https://api.instagram.com/v1`
**Auth:** api-key — `GET /endpoint?access_token=YOUR_KEY`
**Rate Limit:** 200 req/hour (Basic Display)
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://instagram.com/developer/support

## Description

Description of Instagram RESTful API.

Current limitations:
  * Instagram service does not support cross origin headers
  for security reasons, therefore it is not possible to use Swagger UI and make API calls directly from bro

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.instagram.com/v1/geographies/{geo-id}/media/recent` | Get recent media from a custom geo-id. |
| GET | `https://api.instagram.com/v1/locations/search` | Search for a location by geographic coordinate. |
| GET | `https://api.instagram.com/v1/locations/{location-id}` | Get information about a location. |
| GET | `https://api.instagram.com/v1/locations/{location-id}/media/recent` | Get a list of recent media objects from a given location. |
| GET | `https://api.instagram.com/v1/media/popular` | Get a list of currently popular media. |
| GET | `https://api.instagram.com/v1/media/search` | Search for media in a given area. |
| GET | `https://api.instagram.com/v1/media/shortcode/{shortcode}` | Get information about a media object. |
| GET | `https://api.instagram.com/v1/media/{media-id}` | Get information about a media object. |

## Authentication

API key as a query parameter (access_token)

```
GET /endpoint?access_token=YOUR_KEY
```

## Sample Request

```bash
curl -X GET 'https://api.instagram.com/v1/geographies/{geo-id}/media/recent' \
  -H 'GET /endpoint?access_token=YOUR_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Free with Meta developer account. Basic Display API: user media. Graph API: business features.

---

*Source: [API Map](https://apimap.dev/apis/instagram/) — CC BY 4.0*