Goose-skills orthogonal-searchapi

Multi-platform search - YouTube, Amazon, eBay, Walmart, TikTok, Instagram, and more

install
source · Clone the upstream repo
git clone https://github.com/gooseworks-ai/goose-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/gooseworks-ai/goose-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/capabilities/orthogonal-searchapi" ~/.claude/skills/gooseworks-ai-goose-skills-orthogonal-searchapi && rm -rf "$T"
manifest: skills/capabilities/orthogonal-searchapi/SKILL.md
source content

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