/v2/instagram/reels/search

GET

Search Reels

Find Google-indexed reels by keyword, with date filters and pagination. Results are best-effort, not a complete Instagram search.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`query` Keyword to search for.	query / required	`string`
`date_posted` Google-indexed date window. Hour/day filters are unsupported because indexing is unreliable for those windows.	query / optional	`string` Allowed values `["last-week","last-month","last-year"]`
`page` Page number, from 1 to 11. Page 12 or greater returns HTTP 400.	query / optional	`number`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v2/instagram/reels/search?query=YOUR_QUERY' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v2/instagram/reels/search?query=YOUR_QUERY", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v2/instagram/reels/search?query=YOUR_QUERY",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

reelsrequired

array

Array items

object

idrequired

string

__typenamerequired

string

shortcoderequired

string

urlrequired

string

captionrequired

string

thumbnail_srcrequired

string

display_urlrequired

string

video_urlrequired

string

has_audiorequired

boolean

accessibility_captionoptional

null

product_typerequired

string

video_durationrequired

number

clips_music_attribution_inforequired

object

artist_namerequired

string

song_namerequired

string

uses_original_audiorequired

boolean

should_mute_audiorequired

boolean

should_mute_audio_reasonrequired

string

audio_idrequired

string

is_videorequired

boolean

ownerrequired

object

idrequired

string

usernamerequired

string

is_verifiedrequired

boolean

profile_pic_urlrequired

string

full_namerequired

string

is_privateoptional

boolean

is_unpublishedoptional

boolean

follower_countoptional

integer

post_countoptional

integer

taken_atrequired

string

{
  "format": "date-time"
}

is_adrequired

boolean

like_countrequired

integer

is_affiliateoptional

boolean

is_paid_partnershiprequired

boolean

locationrequired

object

idrequired

string

has_public_pagerequired

boolean

namerequired

string

slugrequired

string

address_jsonrequired

string

comment_countrequired

integer

commentsrequired

array

Array items

object

idrequired

string

textrequired

string

ownerrequired

object

idrequired

string

is_verifiedrequired

boolean

profile_pic_urlrequired

string

usernamerequired

string

full_nameoptional

string

like_countrequired

integer

created_atrequired

string

{
  "format": "date-time"
}

video_view_countoptional

integer

next_pageoptional

integer

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited