# SocialAPIs endpoints > 54 endpoints for public Facebook and Instagram data. Base URL https://api.socialapis.io, auth header `x-api-token: `. Prices are per call, in credits. Machine-readable: https://socialapis.io/openapi.json. How to call us: https://socialapis.io/agents.txt. Format: METHOD /route — description — params ("(required)" marked) — price ## Facebook GET /facebook/ads/archive-details — Get detailed info about a specific archived ad by archive ID — ad_archive_id (required), page_id, country, is_ad_non_political, is_ad_not_aaa_eligible — 1 credit GET /facebook/ads/countries — Get list of supported country codes for Meta Ads Library filtering — no params — 1 credit GET /facebook/ads/keywords — Search for ads by keyword with optional country filter — query (required), country — 1 credit GET /facebook/ads/page-details — Get detailed info about a specific Facebook page from the Ads Library — page_id (required) — 1 credit GET /facebook/ads/search — Search ads in the Meta Ad Library by keyword or page ID with filters — query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor — 1 credit GET /facebook/albums/items — Get the photos and videos inside a Facebook album, from a page or a group. Takes the album id returned by /facebook/pages/albums or /facebook/groups/albums — album_id (required), end_cursor — 1 credit GET /facebook/groups/albums — List the photo albums of a Facebook group (album_id, album_title, url, thumbnail_uri, photos_count, videos_count). Use the album_id with /facebook/albums/items to get the photos — group_id (required), limit — 1 credit GET /facebook/groups/details — Get detailed metadata and statistics about a Facebook group including member count, description, and rules — link (required) — 1 credit GET /facebook/groups/id — Retrieve the Facebook Group ID from a public group link — link (required) — 1 credit GET /facebook/groups/posts — Fetch recent posts from a Facebook group, including text, media, reactions, and comments — link (required), limit, end_cursor, after_time, before_time, timezone — 1 credit; round(limit ÷ 3) credits when limit is set, up to 3 GET /facebook/groups/videos — Get videos from a Facebook group with pagination — link (required), end_cursor — 1 credit GET /facebook/marketplace/categories — Get all Marketplace categories with seo_url and category ID values — no params — 1 credit GET /facebook/marketplace/city-coordinates — Get GPS coordinates for a city to use as Marketplace location filters — city (required), country, exactly_one — 1 credit GET /facebook/marketplace/listing — Get detailed info about a single Marketplace listing — listing_id (required) — 1 credit GET /facebook/marketplace/rentals — Search Marketplace rental property listings with filters for bedrooms, bathrooms, location, and price — sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, is_c2c_listing_only, end_cursor — 1 credit GET /facebook/marketplace/search — Search Facebook Marketplace items with filters for location, price, category, condition, and more — query, category_url, proxy_country, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, end_cursor, fields — 1 credit GET /facebook/marketplace/seller — Get seller profile, ratings, reviews, and badges — seller_id (required) — 1 credit GET /facebook/marketplace/vehicles — Search Marketplace vehicle listings with filters for location, price, mileage, year, and more — sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, exact_match, end_cursor — 1 credit GET /facebook/media/download — Download media (images, videos, audio) from Facebook URLs — url (required) — 1 credit; up to 100 credits per call depending on the result GET /facebook/pages/albums — List the photo albums of a Facebook page (album_id, album_title, url, thumbnail_uri, album_items_count). Use the album_id with /facebook/albums/items to get the photos — profile_id (required), limit, end_cursor — 1 credit GET /facebook/pages/details — Get Facebook page details — link (required), exact_followers_count, page_section — 1 credit; 5 credits when exact_followers_count=true GET /facebook/pages/id — Get Facebook page id — link (required) — 1 credit GET /facebook/pages/posts — Get Facebook page posts — link (required), limit, end_cursor, after_time, before_time, timezone — 1 credit; round(limit ÷ 3) credits when limit is set, up to 3 GET /facebook/pages/reels — Get Facebook page reels — link (required), end_cursor — 1 credit GET /facebook/pages/videos — Get Facebook page videos — link (required), end_cursor — 1 credit GET /facebook/posts/attachments — Get details of all media attachments for a given Facebook post — post_id (required) — 5 credits GET /facebook/posts/comments — Retrieve top-level comments from a Facebook post or reel — link (required), end_cursor, include_reply_info — 1 credit GET /facebook/posts/comments/replies — Fetch replies to a specific comment on a Facebook post. Requires comment_feedback_id and expansion_token obtained from the /facebook/posts/comments endpoint with include_reply_info=true — comment_feedback_id (required), expansion_token (required) — 1 credit GET /facebook/posts/details — Get detailed data about a Facebook post including reactions, media, and user info — link (required) — 1 credit GET /facebook/posts/details/extended — Get extended details about a Facebook post including views, video URLs, music info, and author verification — link (required) — 1 credit GET /facebook/posts/id — Extract the Facebook post ID from a given post link — link (required) — 1 credit GET /facebook/posts/video — Retrieve video metadata, feedback stats, and post context for a Facebook video post — video_id (required) — 1 credit GET /facebook/search/locations — Search for Facebook locations by keyword. Returns location UIDs that can be used to filter other search endpoints — query (required) — 1 credit GET /facebook/search/pages — Search for Facebook pages by keyword with optional location filtering — query (required), location_uid, end_cursor — 1 credit GET /facebook/search/people — Search for Facebook people/profiles by keyword with optional location filtering — query (required), location_uid, end_cursor — 1 credit GET /facebook/search/posts — Search for Facebook posts by keyword with optional location and time filters — query (required), location_uid, start_time, end_time, recent_posts, end_cursor — 1 credit GET /facebook/search/videos — Search for Facebook videos by keyword with optional recency and live filters — query (required), most_recent, videos_live, fields, end_cursor — 1 credit ## Instagram GET /instagram/highlight/details — Get details of a specific highlight by ID — highlight_id (required) — 1 credit GET /instagram/location/nearby — Get nearby places/locations for a specific Instagram location — location_id (required) — 1 credit GET /instagram/location/posts — Get Instagram posts from a specific location (ranked or recent) — location_id (required), tab, end_cursor — 1 credit GET /instagram/post/details — Get details of a specific Instagram post — shortcode (required) — 1 credit GET /instagram/post/id — Extract the post shortcode from an Instagram URL — link (required) — 1 credit GET /instagram/profile/details — Get user profile information by username including bio, followers, posts count, and related profiles — username (required), link — 1 credit GET /instagram/profile/highlights — Get all highlights from a user profile — user_id (required) — 1 credit GET /instagram/profile/posts — Get posts from a user profile with pagination — username, user_id, end_cursor — 1 credit GET /instagram/profile/reels — Get reels from a user profile with pagination — user_id (required), end_cursor — 1 credit GET /instagram/reels/audio — Get Instagram Reels associated with a specific audio/music ID — audio_id (required), max_id — 1 credit GET /instagram/reels/feed — Get Instagram Reels feed with recommended, trending, or chained clips — clips_media_id — 1 credit GET /instagram/search — Search Instagram by keyword and get popular results (users, hashtags, places) — keyword (required), end_cursor — 1 credit GET /instagram/user/id — Get the unique ID of any Instagram profile from link or username — link, username — 1 credit ## Account and usage (free) GET /usage — Get current credit usage and plan info. Free — does not consume credits — no params — Free GET /usage/limits — Get plan limits (rate limit, max tasks, allowed top-ups). Free — does not consume credits — no params — Free GET /usage/top-ups — Get auto top-up settings and recent history. Free — does not consume credits — no params — Free ## Website GET /website/contacts — Find the public contact details a business publishes on its own website (emails, phone numbers, social profile links) from its homepage URL — start_url (required), max_requests — 1 credit