---
title: "Instagram Popular Search"
method: GET
path: "/instagram/search/popular"
tags: ["Instagram"]
---

# Instagram Popular Search

`GET /instagram/search/popular`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/instagram/search/popular`
- Auth: API key in header `X-API-KEY`

Explore an Instagram topic by keyword: curated popular media, related keywords, and topic description.
Confirmed missing topics return found=false and empty media. Completed lookups, including
confirmed missing topics and valid empty results, cost one credit. Unavailable or unconfirmed
lookups return retryable HTTP 503 and do not consume credits.

## Query parameters

- `q` string, required

## Response `200`

- object
  - `success` boolean, required
  - `found` boolean, required
  - `query` string, required
  - `media` object[], required
  - `media_count` integer, required
  - `related_keywords` string[], required
  - `description` string, nullable, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `403`: Instagram explicitly requires login. Scrappa does not retry the login-gated resource. Profile lookups may recover from public profile data; unresolved login requirements are nonbillable and not retryable.
- `422`: The q parameter is missing or empty.
- `503`: Instagram is unavailable or the topic lookup could not be confirmed. Retry the request later. This is not a confirmed missing topic; the request is retryable and does not consume credits.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)