majiayu000 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
- Product Research: Compare products across Amazon, eBay, Walmart
- Video Intelligence: Search YouTube videos, channels, and transcripts
- Ad Research: Monitor ads on Meta, TikTok, Reddit, LinkedIn
- Social Media: Get TikTok and Instagram profiles
- 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