---
title: "Search Instagram reels by keyword"
method: GET
path: "/v1/reels-search"
tags: ["Discovery"]
---

# Search Instagram reels by keyword

`GET /v1/reels-search`

## Request

- Base URL: `https://data.fastsocial.co`
- URL: `https://data.fastsocial.co/v1/reels-search`
- Auth: API key in header `X-API-Key`

Reels matching a keyword. Page with cursor.

Cost: **3 credits**.

## Query parameters

- `q` string, required
- `cursor` string

## Response `200`

OK

- object
  - `ok` unknown, required
  - `data` ReelsSearchPage, required
    - `query` string
    - `posts` Post[]
      - `shortcode` string
      - `url` string
      - `taken_at` integer, nullable: Unix seconds, UTC
      - `format` 'image' | 'video' | 'reel' | 'carousel'
      - `likes` integer, nullable
      - `comments` integer, nullable
      - `views` integer, nullable
      - `caption` string
      - `image_url` string, nullable
      - `video_url` string, nullable
      - `pinned` boolean
      - `owner_username` string, nullable
      - `owner_id` string, nullable
    - `next_cursor` string, nullable
  - `meta` Meta, required
    - `cache` 'hit' | 'miss' | 'stale'
    - `age_seconds` integer
    - `stale` boolean
    - `credits` integer
    - `credits_remaining` integer, nullable

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `422`: Error
- `429`: Error
- `451`: Error
- `502`: Error
- `503`: Error

---

[API](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api.md) · [All operations](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api/revisions/fe69c993e76a?raw)