curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/history/instagram

# Get only regular posts (no Stories) within a date range
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/history/facebook?limit=20&since=2026-03-17&until=2026-03-20&dataType=posts"

# First request
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/history/twitter?limit=10"

# Next page request (use 'next' cursor from previous response)
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/history/twitter?limit=10&next=eyJ0b2tlbiI6IjE3MzkyNjg1MTQ0ODU3MTUi..."

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/history/instagram", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

const API_KEY = "API_KEY";

// Function to fetch posts with pagination (up to maxPosts or until cutoffTime)
async function fetchPosts(platform, { limit = 25, maxPosts = 100, cutoffTime = null } = {}) {
  const posts = [];
  let nextCursor = null;
  let pagePosts = [];

  do {
    const url = new URL(`https://api.ayrshare.com/api/history/${platform}`);
    url.searchParams.set("limit", limit);
    if (nextCursor) {
      url.searchParams.set("next", nextCursor);
    }

    const response = await fetch(url, {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    });

    const data = await response.json();
    pagePosts = data.posts || [];

    // Filter by date if cutoffTime is specified
    if (cutoffTime) {
      pagePosts = pagePosts.filter(post => new Date(post.created) >= cutoffTime);
    }

    posts.push(...pagePosts);

    // Get cursor for next page
    nextCursor = data.meta?.pagination?.hasMore ? data.meta.pagination.next : null;
  } while (nextCursor && pagePosts.length > 0 && posts.length < maxPosts);

  return posts.slice(0, maxPosts);
}

// Fetch up to 100 Twitter posts
fetchPosts("twitter", { maxPosts: 100 }).then(posts => console.log(posts));

// Fetch posts from the last 30 days (up to 200)
const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
fetchPosts("twitter", { maxPosts: 200, cutoffTime: thirtyDaysAgo }).then(posts => console.log(posts));

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/history/instagram', headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/history/instagram';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace HistoryPlatformGETRequest_csharp
{
class HistoryPlatform
{
    static async Task Main(string[] args)
    {
        string API_KEY = "API_KEY";
        string url = "https://api.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl";

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            try
            {
                var response = await client.GetStringAsync(url);
                Console.WriteLine(response);
            }
            catch (HttpRequestException ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}
}

{
    "status": "success",
    "posts": [
        // Bluesky Response Example
        {
            "cid": "bafyreigh7nz7x6pl4atgsextqtcbh33mg66yqt3caeihutn7ojkmpdtnzm",
            "created": "2025-01-06T21:35:08.951Z",
            "id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lfb57nxgxs2e",
            "indexedAt": "2025-01-06T21:35:09.156Z",
            "labels": [],
            "likeCount": 2,
            "post": "What a wonderful data day!",
            "postUrl": "https://bsky.app/profile/ayrshare.com/post/3lf43nl5jis24",
            "quoteCount": 3,
            "replyCount": 2,
            "repostCount": 1,
            "viewer": {
                "threadMuted": false,
                "embeddingDisabled": false
            }
        }
    ],
    "lastUpdated": "2022-11-14T16:04:51.994Z",
    "nextUpdate": "2022-11-14T16:37:21.994Z",
    "meta": {
        "pagination": {
            "hasMore": true,
            "next": "eyJ0b2tlbiI6IjE3MzkyNjg1MTQ0ODU3MTUiLCJzb3VyY2UiOiJwdWJsaWMiLCJwbGF0Zm9ybSI6InR3aXR0ZXIifQ==",
            "limit": 10
        }
    }
}

{
  "status": "error",
  "code": 196,
  "message": "Instagram is not connected"
}

{
    "status": "error",
    "posts": [
        {
            "action": "analytics",
            "code": 187,
            "message": "Error getting analytics.",
            "status": "error"
        }
    ]
}