SearchAPI - Multi-Platform Search

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Search across YouTube, Amazon, eBay, Walmart, TikTok, Instagram, Airbnb, and ad libraries.

Capabilities

• TripAdvisor Search: Search TripAdvisor listings
• YouTube Comments: Get comments on a YouTube video
• YouTube Channel: Get YouTube channel info
• Reddit Ad Library: Search Reddit ads library
• Meta Ad Library: Search Meta/Facebook ads library
• YouTube Transcripts: Get video transcript/captions
• Amazon Search: Search Amazon products
• eBay Search: Search eBay listings
• YouTube Video Details: Get detailed info about a YouTube video
• YouTube Channel Videos: Get videos from a YouTube channel
• Apple App Store Search: Search Apple App Store apps
• Airbnb Search: Search Airbnb listings
• TikTok Profile: Get TikTok user profile info
• Instagram Profile: Get Instagram profile info
• Walmart Search: Search Walmart products
• TikTok Ads Library: Search TikTok ads library
• LinkedIn Ad Library: Search LinkedIn ads library
• YouTube Search: Search YouTube videos by query

Usage

TripAdvisor Search

Search TripAdvisor listings

Parameters:

• engine* (string)
• q* (string) - Search query
• tripadvisor_domain (string) - TripAdvisor domain
• category (string) - Category filter (all, hotels, restaurants, attractions)
• location (string) - Location filter
• lat (number) - Latitude for geo search
• lon (number) - Longitude for geo search
• page (integer) - Page number
• num (integer) - Number of results

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tripadvisor","q":"best%20restaurants%20NYC"}}'

YouTube Comments

Get comments on a YouTube video

Parameters:

• engine* (string)
• video_id* (string) - YouTube video ID
• gl (string) - Country code
• hl (string) - Language code
• next_page_token (string) - Pagination token

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_comments","video_id":"dQw4w9WgXcQ"}}'

YouTube Channel

Get YouTube channel info

Parameters:

• engine* (string)
• channel_id* (string) - YouTube channel ID
• gl (string) - Country code
• hl (string) - Language code

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_channel","channel_id":"UC_x5XG1OV2P6uZZ5FSM9Ttw"}}'

Reddit Ad Library

Search Reddit ads library

Parameters:

• engine* (string)
• q* (string) - Search query
• industry (string) - Industry filter
• objective_type (string) - Campaign objective
• budget_category (string) - Budget category
• placements (string) - Ad placements
• post_type (string) - Post type filter

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"reddit_ad_library","q":"software"}}'

Meta Ad Library

Search Meta/Facebook ads library

Parameters:

• engine* (string)
• q (string) - Search query
• page_id (string) - Facebook page ID
• location_id (string) - Location ID
• country (string) - Country code
• content_languages (string) - Content language filter
• active_status (string) - Active status filter
• ad_type (string) - Ad type filter
• media_type (string) - Media type filter
• platforms (string) - Platform filter (facebook, instagram)
• sort_by (string) - Sort order
• start_date (string) - Start date filter
• end_date (string) - End date filter
• next_page_token (string) - Pagination token

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"meta_ad_library","q":"AI%20tools"}}'

YouTube Transcripts

Get video transcript/captions

Parameters:

• engine* (string)
• video_id* (string) - YouTube video ID
• lang (string) - Transcript language code
• transcript_type (string) - Type of transcript
• transcript_name (string) - Name of specific transcript
• only_available (boolean) - Only return available transcripts

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_transcripts","video_id":"dQw4w9WgXcQ"}}'

Amazon Search

Search Amazon products

Parameters:

• engine* (string)
• q* (string) - Search query
• amazon_domain (string) - Amazon domain (e.g. amazon.com, amazon.co.uk)
• language (string) - Language code
• delivery_country (string) - Delivery country code
• page (integer) - Page number
• sort_by (string) - Sort order
• price_min (number) - Minimum price filter
• price_max (number) - Maximum price filter
• rh (string) - Refinement filters

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"amazon_search","q":"wireless%20headphones"}}'

eBay Search

Search eBay listings

Parameters:

• engine* (string)
• q* (string) - Search query
• ebay_domain (string) - eBay domain (e.g. ebay.com)
• country (string) - Country code
• delivery_country (string) - Delivery country
• page (integer) - Page number
• num (integer) - Number of results
• layout (string) - Results layout
• sort_by (string) - Sort order
• price_min (number) - Minimum price
• price_max (number) - Maximum price
• condition (string) - Item condition filter
• buying_format (string) - Buying format filter
• category_id (string) - Category ID
• postal_code (string) - Postal code for local
• distance_radius (integer) - Distance radius in miles

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"ebay_search","q":"vintage%20watch"}}'

YouTube Video Details

Get detailed info about a YouTube video

Parameters:

• engine* (string)
• video_id* (string) - YouTube video ID
• gl (string) - Country code
• hl (string) - Language code

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_video","video_id":"dQw4w9WgXcQ"}}'

YouTube Channel Videos

Get videos from a YouTube channel

Parameters:

• engine* (string)
• channel_id* (string) - YouTube channel ID
• gl (string) - Country code
• hl (string) - Language code

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_channel_videos","channel_id":"UC_x5XG1OV2P6uZZ5FSM9Ttw"}}'

Apple App Store Search

Search Apple App Store apps

Parameters:

• engine* (string)
• term* (string) - Search term
• country (string) - Country code (e.g. us, gb)
• lang (string) - Language code
• page (integer) - Page number
• num (integer) - Number of results
• device (string) - Device filter (iphone, ipad)
• property (string) - Property filter
• include_explicit (boolean) - Include explicit content

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"apple_app_store","term":"productivity"}}'

Airbnb Search

Search Airbnb listings

Parameters:

• engine* (string)
• q* (string) - Location query
• airbnb_domain (string) - Airbnb domain
• currency (string) - Currency code (e.g. USD, EUR)
• check_in_date (string) - Check-in date (YYYY-MM-DD)
• check_out_date (string) - Check-out date (YYYY-MM-DD)
• time_period (string) - Flexible time period
• adults (integer) - Number of adults
• children (integer) - Number of children
• infants (integer) - Number of infants
• pets (integer) - Number of pets
• price_min (number) - Minimum price
• price_max (number) - Maximum price
• bedrooms (integer) - Number of bedrooms
• beds (integer) - Number of beds
• bathrooms (integer) - Number of bathrooms
• property_types (string) - Property type filter
• type_of_place (string) - Entire place/private room/shared
• amenities (string) - Amenities filter

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"airbnb","q":"Paris"}}'

TikTok Profile

Get TikTok user profile info

Parameters:

• engine* (string)
• username* (string) - TikTok username

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tiktok_profile","username":"openai"}}'

Instagram Profile

Get Instagram profile info

Parameters:

• engine* (string)
• username* (string) - Instagram username

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"instagram_profile","username":"openai"}}'

Walmart Search

Search Walmart products

Parameters:

• engine* (string)
• q* (string) - Search query
• page (integer) - Page number
• sort_by (string) - Sort order
• price_min (number) - Minimum price
• price_max (number) - Maximum price
• category_id (string) - Category ID
• store_id (string) - Store ID for local inventory
• filters (string) - Additional filters

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"walmart_search","q":"laptop"}}'

TikTok Ads Library

Search TikTok ads library

Parameters:

• engine* (string)
• q (string) - Search query
• advertiser_id (string) - Advertiser ID
• country (string) - Country code
• time_period (string) - Time period filter
• sort_by (string) - Sort order
• next_page_token (string) - Pagination token

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tiktok_ads_library","q":"AI"}}'

LinkedIn Ad Library

Search LinkedIn ads library

Parameters:

• engine* (string)
• q (string) - Search query
• advertiser (string) - Advertiser name
• country (string) - Country code
• time_period (string) - Time period filter
• next_page_token (string) - Pagination token

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"linkedin_ad_library","q":"hiring"}}'

YouTube Search

Search YouTube videos by query

Parameters:

• engine* (string)
• q* (string) - Search query
• sp (string) - Search filter parameter
• gl (string) - Country code (e.g. us, uk, de)
• hl (string) - Language code (e.g. en, de, fr)

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube","q":"AI%20agents"}}'

Use Cases

1. Product Research: Compare products across Amazon, eBay, Walmart
2. Video Intelligence: Search YouTube videos, channels, and transcripts
3. Ad Research: Monitor ads on Meta, TikTok, Reddit, LinkedIn
4. Social Media: Get TikTok and Instagram profiles
5. Travel: Search Airbnb listings and TripAdvisor reviews

Discover More

For full endpoint details and parameters:

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"searchapi API endpoints"}' List all endpoints
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search"}'   # Get endpoint details