{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "ResponseBfde03595B3D_SearchResponse": { "type": "object", "properties": { "search_metadata": { "$ref": "#/components/schemas/ResponseBfde03595B3D_SearchMetadata" }, "search_parameters": { "$ref": "#/components/schemas/ResponseBfde03595B3D_SearchParameters" }, "search_information": { "$ref": "#/components/schemas/ResponseBfde03595B3D_SearchInformation" }, "properties": { "type": "array", "description": "List of property results", "items": { "$ref": "#/components/schemas/ResponseBfde03595B3D_Property" } }, "pagination": { "$ref": "#/components/schemas/ResponseBfde03595B3D_Pagination" }, "error": { "type": "string", "description": "Error message when no results are found" } } }, "ResponseBfde03595B3D_SearchMetadata": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier for the search request" }, "status": { "type": "string", "description": "Status of the search request" }, "created_at": { "type": "string", "format": "date-time", "description": "Timestamp when the search was created" }, "request_time_taken": { "type": "number", "description": "Time taken to make the request in seconds" }, "parsing_time_taken": { "type": "number", "description": "Time taken to parse the results in seconds" }, "total_time_taken": { "type": "number", "description": "Total time taken for the search in seconds" }, "request_url": { "type": "string", "description": "Airbnb URL for this search" }, "html_url": { "type": "string", "description": "URL to view HTML results" }, "json_url": { "type": "string", "description": "URL to view JSON results" } } }, "ResponseBfde03595B3D_SearchParameters": { "type": "object", "properties": { "engine": { "type": "string", "description": "Search engine used" }, "airbnb_domain": { "type": "string", "description": "Airbnb domain searched" }, "currency": { "type": "string", "description": "Currency code for pricing" }, "include_taxes": { "type": "string", "description": "Whether tax-inclusive pricing was requested" }, "q": { "type": "string", "description": "Search query location" }, "bounding_box": { "type": "string", "description": "Geographic bounding box coordinates" }, "check_in_date": { "type": "string", "description": "Check-in date" }, "check_out_date": { "type": "string", "description": "Check-out date" }, "time_period": { "type": "string", "description": "Flexible trip length" }, "price_min": { "type": "integer", "description": "Minimum price filter" }, "price_max": { "type": "integer", "description": "Maximum price filter" }, "adults": { "type": "integer", "description": "Number of adults" }, "children": { "type": "integer", "description": "Number of children" }, "infants": { "type": "integer", "description": "Number of infants" }, "pets": { "type": "integer", "description": "Number of pets" }, "type_of_place": { "type": "string", "description": "Type of accommodation" }, "bedrooms": { "type": "integer", "description": "Minimum bedrooms" }, "beds": { "type": "integer", "description": "Minimum beds" }, "bathrooms": { "type": "integer", "description": "Minimum bathrooms" }, "amenities": { "type": "string", "description": "Amenities filter" }, "property_types": { "type": "string", "description": "Property types filter" }, "next_page_token": { "type": "string", "description": "Pagination token" } } }, "ResponseBfde03595B3D_SearchInformation": { "type": "object", "properties": { "query_displayed": { "type": "string", "description": "Location query as displayed by Airbnb" }, "results": { "type": "string", "description": "Results summary text" }, "time_period": { "type": "string", "description": "Time period display text" }, "check_in_date": { "type": "string", "description": "Check-in date from search" }, "check_out_date": { "type": "string", "description": "Check-out date from search" }, "guests": { "type": "string", "description": "Guest count display text" }, "adults": { "type": "integer", "description": "Number of adult guests" }, "children": { "type": "integer", "description": "Number of child guests" }, "infants": { "type": "integer", "description": "Number of infant guests" }, "pets": { "type": "integer", "description": "Number of pets" } } }, "ResponseBfde03595B3D_Property": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "Unique property listing ID" }, "title": { "type": "string", "description": "Property title" }, "description": { "type": "string", "description": "Property description" }, "link": { "type": "string", "description": "URL to property details page" }, "booking_link": { "type": "string", "description": "Direct booking URL with dates and guest parameters" }, "time_period": { "type": "string", "description": "Date range display text" }, "check_in_date": { "type": "string", "description": "Check-in date for this property" }, "check_out_date": { "type": "string", "description": "Check-out date for this property" }, "price": { "$ref": "#/components/schemas/ResponseBfde03595B3D_Price" }, "accommodations": { "type": "array", "description": "Accommodation details (bedrooms, beds, bathrooms)", "items": { "type": "string" } }, "distance": { "type": "string", "description": "Distance from search location" }, "extracted_distance": { "type": "number", "description": "Numeric distance value" }, "gps_coordinates": { "$ref": "#/components/schemas/ResponseBfde03595B3D_GpsCoordinates" }, "rating": { "type": "number", "description": "Average rating score" }, "reviews": { "type": "integer", "description": "Number of reviews" }, "has_free_cancellation": { "type": "boolean", "description": "Present and true when the card shows a \"Free cancellation\" highlight. Omitted otherwise." }, "badges": { "type": "array", "description": "Property badges (e.g., Guest favorite, Superhost)", "items": { "type": "string" } }, "images": { "type": "array", "description": "Property image URLs", "items": { "type": "string" } } } }, "ResponseBfde03595B3D_Price": { "type": "object", "properties": { "total_price": { "type": "string", "description": "Total price display text" }, "extracted_total_price": { "type": "number", "description": "Numeric total price value" }, "qualifier": { "type": "string", "description": "Price qualifier text (e.g., per night, per week)" }, "extracted_qualifier": { "type": "integer", "description": "Numeric qualifier value" }, "original_price": { "type": "string", "description": "Original price before discount" }, "extracted_original_price": { "type": "number", "description": "Numeric original price value" }, "discount": { "type": "string", "description": "Discount amount display text" }, "extracted_discount": { "type": "number", "description": "Numeric discount value" }, "price_per_qualifier": { "type": "string", "description": "Price breakdown per qualifier" }, "extracted_price_per_qualifier": { "type": "number", "description": "Numeric price per qualifier value" }, "breakdown": { "type": "array", "description": "Every itemized price line: the stay subtotal, any discount lines, any tax or fee lines, and the total. The lines sum to the total, so a listing's taxes are read from here rather than from a single field, since a card can carry several tax lines. Line descriptions are localized to the airbnb_domain.", "items": { "$ref": "#/components/schemas/ResponseBfde03595B3D_PriceBreakdownItem" } }, "total_with_taxes": { "type": "string", "description": "Formatted all-in total including taxes and fees. Exact, where `total_price` is Airbnb's rounded display figure. Present only when Airbnb provides an all-in figure, so its absence means no tax-inclusive price was available." }, "extracted_total_with_taxes": { "type": "number", "description": "Numeric all-in total extracted from `total_with_taxes`" } } }, "ResponseBfde03595B3D_PriceBreakdownItem": { "type": "object", "properties": { "description": { "type": "string", "description": "Breakdown item description" }, "price": { "type": "string", "description": "Breakdown item price display text" }, "extracted_price": { "type": "number", "description": "Numeric breakdown item price. Signed, so discount lines are negative and the lines sum to the total." } } }, "ResponseBfde03595B3D_GpsCoordinates": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate" }, "longitude": { "type": "number", "description": "Longitude coordinate" } } }, "ResponseBfde03595B3D_Pagination": { "type": "object", "properties": { "next_page_token": { "type": "string", "description": "Token to retrieve the next page of results" } } }, "ResponseDce247884A6B_SearchResponse": { "type": "object", "properties": { "search_metadata": { "$ref": "#/components/schemas/ResponseDce247884A6B_SearchMetadata" }, "search_parameters": { "$ref": "#/components/schemas/ResponseDce247884A6B_SearchParameters" }, "search_information": { "$ref": "#/components/schemas/ResponseDce247884A6B_SearchInformation" }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_Category" } }, "filters": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_Filter" } }, "organic_results": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_OrganicResult" } }, "related_results": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_OrganicResult" }, "description": "eBay's \"Results matching fewer words\" items." }, "sections": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_Section" } }, "related_searches": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_RelatedSearch" } }, "pagination": { "$ref": "#/components/schemas/ResponseDce247884A6B_Pagination" }, "error": { "type": "string", "description": "Error message when no results are found" } } }, "ResponseDce247884A6B_SearchMetadata": { "type": "object", "required": [ "id", "status", "created_at" ], "properties": { "id": { "type": "string", "description": "Unique identifier for the search request" }, "status": { "type": "string", "description": "Status of the search request" }, "created_at": { "type": "string", "format": "date-time", "description": "Timestamp when the search was created" }, "request_time_taken": { "type": "number", "description": "Time taken to make the request in seconds" }, "parsing_time_taken": { "type": "number", "description": "Time taken to parse the results in seconds" }, "total_time_taken": { "type": "number", "description": "Total time taken for the search in seconds" }, "request_url": { "type": "string", "description": "eBay URL for this search" }, "html_url": { "type": "string", "description": "URL to view HTML results" }, "json_url": { "type": "string", "description": "URL to view JSON results" } } }, "ResponseDce247884A6B_SearchParameters": { "type": "object", "properties": { "engine": { "type": "string", "description": "Search engine used" }, "q": { "type": "string", "description": "Search query" }, "category_id": { "type": "integer", "description": "Category ID searched" }, "ebay_domain": { "type": "string", "description": "eBay domain used" }, "country": { "type": "string", "description": "Country code" }, "layout": { "type": "string", "description": "Layout format" }, "buying_format": { "type": "string", "description": "Buying format filter" }, "condition": { "type": "string", "description": "Condition filters" }, "delivery_country": { "type": "string", "description": "Delivery country" }, "postal_code": { "type": "string", "description": "Postal code" }, "distance_radius": { "type": "number", "description": "Distance radius" }, "product_origin_country": { "type": "string", "description": "Product origin country" }, "sort_by": { "type": "string", "description": "Sort order" }, "price_min": { "type": "number", "description": "Minimum price" }, "price_max": { "type": "number", "description": "Maximum price" }, "filters": { "type": "string", "description": "Applied filters" }, "advanced_filters": { "type": "string", "description": "Advanced filters" }, "page": { "type": "integer", "description": "Page number" }, "num": { "type": "integer", "description": "Results per page" }, "include_related_results": { "type": "string", "description": "Whether to return \"Results matching fewer words\" items under a separate `related_results` key" } } }, "ResponseDce247884A6B_SearchInformation": { "type": "object", "properties": { "query_displayed": { "type": "string", "description": "Query as displayed on eBay" }, "category_displayed": { "type": "string", "description": "Category name displayed" }, "total_results": { "type": "integer", "description": "Total number of results found" }, "sorted_by": { "type": "string", "description": "Current sort order" }, "filters_applied": { "type": "array", "items": { "type": "string" }, "description": "List of applied filters" }, "buying_format": { "type": "string", "description": "Selected buying format" }, "shipping_to": { "type": "string", "description": "Shipping destination" }, "language": { "type": "string", "description": "Page language code" }, "notice": { "type": "string", "description": "Notice eBay surfaces above the results (e.g. \"No exact matches found\" when `related_results` is returned)." } } }, "ResponseDce247884A6B_Category": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "Category name" }, "link": { "type": "string", "description": "Category link" }, "category_id": { "type": "string", "description": "Category identifier" }, "is_selected": { "type": "boolean", "description": "Whether this category is currently selected" }, "subcategories": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_Category" }, "description": "Nested subcategories" } } }, "ResponseDce247884A6B_Filter": { "type": "object", "required": [ "options" ], "properties": { "type": { "type": "string", "description": "Filter type name" }, "options": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseDce247884A6B_FilterOption" }, "description": "Available filter options" } } }, "ResponseDce247884A6B_FilterOption": { "type": "object", "properties": { "text": { "type": "string", "description": "Option display text" }, "items": { "type": "integer", "description": "Number of items matching this option" }, "is_selected": { "type": "boolean", "description": "Whether this option is currently selected" }, "link": { "type": "string", "description": "Link to apply this filter" }, "type": { "type": "string", "description": "Option type (for size filters)" } } }, "ResponseDce247884A6B_OrganicResult": { "type": "object", "required": [ "position" ], "properties": { "position": { "type": "integer", "description": "Result position in search results" }, "product_id": { "type": "string", "description": "eBay product identifier" }, "item_id": { "type": "string", "description": "eBay item identifier" }, "title": { "type": "string", "description": "Item title" }, "subtitle": { "type": "string", "description": "Item subtitle" }, "tag": { "type": "string", "description": "Special tag (e.g., \"SPONSORED\")" }, "link": { "type": "string", "description": "Link to item page" }, "seller": { "$ref": "#/components/schemas/ResponseDce247884A6B_Seller" }, "brand": { "type": "string", "description": "Item brand" }, "condition": { "type": "string", "description": "Item condition" }, "extensions": { "type": "array", "items": { "type": "string" }, "description": "Additional item information" }, "authenticity": { "type": "string", "description": "Authenticity guarantee information" }, "is_sponsored": { "type": "boolean", "description": "Whether this is a sponsored result" }, "rating": { "type": "number", "description": "Product rating" }, "reviews": { "type": "integer", "description": "Number of reviews" }, "reviews_link": { "type": "string", "description": "Link to reviews" }, "buying_format": { "type": "string", "description": "Buying format (e.g., \"Buy It Now\", \"Auction\")" }, "is_best_offer": { "type": "boolean", "description": "Whether best offer is available" }, "is_buy_it_now": { "type": "boolean", "description": "Whether buy it now is available" }, "is_auction": { "type": "boolean", "description": "Whether this is an auction" }, "price": { "type": "string", "description": "Price as displayed" }, "extracted_price": { "type": "number", "description": "Numeric price value" }, "extracted_price_range": { "type": "object", "properties": { "from": { "type": "number", "description": "Minimum price in range" }, "to": { "type": "number", "description": "Maximum price in range" } }, "description": "Price range for items with variable pricing" }, "is_price_range": { "type": "boolean", "description": "Whether price is a range" }, "original_price": { "type": "string", "description": "Original price before discount" }, "extracted_original_price": { "type": "number", "description": "Numeric original price value" }, "unit_price": { "type": "string", "description": "Price per unit" }, "extracted_unit_price": { "type": "number", "description": "Numeric unit price value" }, "bids": { "type": "integer", "description": "Number of bids (for auctions)" }, "time_left": { "type": "string", "description": "Time remaining (for auctions)" }, "deal": { "type": "string", "description": "Deal information" }, "discount": { "type": "string", "description": "Discount percentage" }, "items_sold": { "type": "string", "description": "Number of items sold text" }, "extracted_items_sold": { "type": "integer", "description": "Numeric items sold value" }, "stock": { "type": "string", "description": "Stock status" }, "watching": { "type": "string", "description": "Number of watchers text" }, "extracted_watching": { "type": "integer", "description": "Numeric watchers value" }, "shipping": { "type": "string", "description": "Shipping cost text" }, "extracted_shipping": { "type": "number", "description": "Numeric shipping cost" }, "shipping_details": { "type": "string", "description": "Additional shipping information" }, "is_free_return": { "type": "boolean", "description": "Whether free returns are offered" }, "is_in_psa_vault": { "type": "boolean", "description": "Whether item is in PSA vault" }, "trending": { "type": "string", "description": "Trending information" }, "thumbnail": { "type": "string", "description": "Main item image URL" }, "images": { "type": "array", "items": { "type": "string" }, "description": "Additional item images" } } }, "ResponseDce247884A6B_Seller": { "type": "object", "properties": { "name": { "type": "string", "description": "Seller username" }, "reviews": { "type": "integer", "description": "Number of seller reviews" }, "positive_feedback_percent": { "type": "number", "description": "Percentage of positive feedback" }, "is_top_rated_plus": { "type": "boolean", "description": "Whether seller is top rated plus" }, "is_direct_from_seller": { "type": "boolean", "description": "Whether item is direct from brand/manufacturer" }, "thumbnail": { "type": "string", "description": "Seller logo or image URL" } } }, "ResponseDce247884A6B_Section": { "type": "object", "properties": { "title": { "type": "string", "description": "Section title" }, "subtitle": { "type": "string", "description": "Section subtitle" }, "is_sponsored": { "type": "boolean", "description": "Whether this section is sponsored" }, "has_items": { "type": "boolean", "description": "Whether results contain item listings" }, "results": { "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/ResponseDce247884A6B_SectionResult" }, { "$ref": "#/components/schemas/ResponseDce247884A6B_OrganicResult" } ] }, "description": "Section results (either category links or item listings)" } } }, "ResponseDce247884A6B_SectionResult": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position within section" }, "title": { "type": "string", "description": "Result title" }, "link": { "type": "string", "description": "Result link" }, "category_id": { "type": "string", "description": "Category identifier" }, "release_date": { "type": "string", "description": "Release date (for certain sections)" }, "thumbnail": { "type": "string", "description": "Result thumbnail URL" } } }, "ResponseDce247884A6B_RelatedSearch": { "type": "object", "properties": { "query": { "type": "string", "description": "Related search query" }, "link": { "type": "string", "description": "Link to perform this search" } } }, "ResponseDce247884A6B_Pagination": { "type": "object", "properties": { "current": { "type": "integer", "description": "Current page number" }, "previous": { "type": "string", "description": "Link to previous page" }, "next": { "type": "string", "description": "Link to next page" }, "other_pages": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Links to other pages (page number as key, URL as value)" } } }, "ResponseFc5Af1Fcba22_SearchResponse": { "type": "object", "properties": { "search_metadata": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchMetadata" }, "search_parameters": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchParameters" }, "search_information": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchInformation" }, "suggestions": { "type": "array", "description": "Search query suggestions", "items": { "type": "string" } }, "ads": { "type": "array", "description": "Advertisement results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Ad" } }, "channels": { "type": "array", "description": "YouTube channel results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Channel" } }, "movies": { "type": "array", "description": "Movie results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Movie" } }, "videos": { "type": "array", "description": "Video search results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Video" } }, "playlists": { "type": "array", "description": "Playlist results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Playlist" } }, "sections": { "type": "array", "description": "Section results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Section" } }, "shorts": { "type": "array", "description": "YouTube Shorts results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Shorts" } }, "posts": { "type": "array", "description": "Community post results", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Posts" } }, "people_also_search_for": { "type": "array", "description": "Related search suggestions", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PeopleAlsoSearchFor" } }, "featured_channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedChannel" }, "pagination": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Pagination" }, "error": { "type": "string", "description": "Error message if the search failed" } } }, "ResponseFc5Af1Fcba22_SearchMetadata": { "type": "object", "required": [ "id", "status", "created_at" ], "properties": { "id": { "type": "string", "description": "Unique identifier for the search request" }, "status": { "type": "string", "description": "Status of the search request" }, "created_at": { "type": "string", "format": "date-time", "description": "Timestamp when the search was created" }, "request_time_taken": { "type": "number", "description": "Time taken to make the request in seconds" }, "parsing_time_taken": { "type": "number", "description": "Time taken to parse the results in seconds" }, "total_time_taken": { "type": "number", "description": "Total time taken for the search in seconds" }, "request_url": { "type": "string", "description": "YouTube URL for this search" }, "html_url": { "type": "string", "description": "URL to view HTML results" }, "json_url": { "type": "string", "description": "URL to view JSON results" } } }, "ResponseFc5Af1Fcba22_SearchParameters": { "type": "object", "properties": { "engine": { "type": "string", "description": "Search engine used" }, "q": { "type": "string", "description": "Search query that was used" }, "sp": { "type": "string", "description": "Filter/pagination parameter that was used" }, "hl": { "type": "string", "description": "Interface language that was used" }, "gl": { "type": "string", "description": "Country code that was used" } } }, "ResponseFc5Af1Fcba22_SearchInformation": { "type": "object", "properties": { "total_results": { "type": "integer", "description": "Total number of results found" }, "state": { "type": "string", "description": "State of query correction if applicable" }, "original_query": { "type": "string", "description": "Original query before correction" }, "original_query_sp": { "type": "string", "description": "SP parameter for original query" }, "corrected_query": { "type": "string", "description": "Corrected query if spelling fix was applied" } } }, "ResponseFc5Af1Fcba22_Ad": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "Video ID for video ads" }, "title": { "type": "string", "description": "Ad title" }, "link": { "type": "string", "description": "Ad link" }, "description": { "type": "string", "description": "Ad description" }, "website": { "type": "string", "description": "Advertiser website URL" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_AdChannel" }, "length": { "type": "string", "description": "Video duration for video ads" }, "thumbnail": { "type": "string", "description": "Ad thumbnail URL" } } }, "ResponseFc5Af1Fcba22_AdChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" } } }, "ResponseFc5Af1Fcba22_Channel": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "YouTube channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" }, "description": { "type": "string", "description": "Channel description" }, "is_verified": { "type": "boolean", "description": "Whether the channel is verified" }, "video_count": { "type": "integer", "description": "Number of videos" }, "subscribers": { "type": "integer", "description": "Number of subscribers" }, "thumbnail": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Thumbnail" } } }, "ResponseFc5Af1Fcba22_Thumbnail": { "type": "object", "properties": { "static": { "type": "string", "description": "Static thumbnail URL" }, "rich": { "type": "string", "description": "Rich/animated thumbnail URL" } } }, "ResponseFc5Af1Fcba22_Movie": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "Movie video ID" }, "title": { "type": "string", "description": "Movie title" }, "link": { "type": "string", "description": "Link to the movie" }, "description": { "type": "string", "description": "Movie description" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_MovieChannel" }, "length": { "type": "string", "description": "Movie duration" }, "metadata_items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_MetadataItems" }, "badges": { "type": "array", "description": "Movie badges", "items": { "type": "string" } }, "buttons": { "type": "array", "description": "Action buttons", "items": { "type": "string" } }, "thumbnail": { "type": "string", "description": "Movie thumbnail URL" } } }, "ResponseFc5Af1Fcba22_MovieChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" }, "is_verified": { "type": "boolean", "description": "Whether the channel is verified" } } }, "ResponseFc5Af1Fcba22_MetadataItems": { "type": "object", "properties": { "top": { "type": "array", "description": "Top metadata items", "items": { "type": "string" } }, "bottom": { "type": "array", "description": "Bottom metadata items", "items": { "type": "string" } } } }, "ResponseFc5Af1Fcba22_Video": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "YouTube video ID" }, "title": { "type": "string", "description": "Video title" }, "link": { "type": "string", "description": "Link to the video" }, "description": { "type": "string", "description": "Video description snippet" }, "views": { "type": "integer", "description": "Number of views" }, "is_live": { "type": "boolean", "description": "Whether the video is currently live" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_VideoChannel" }, "length": { "type": "string", "description": "Video duration" }, "published_time": { "type": "string", "description": "Time since publication" }, "badges": { "type": "array", "description": "Video badges", "items": { "type": "string" } }, "thumbnail": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Thumbnail" }, "key_moments": { "type": "array", "description": "Key moments in the video", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_KeyMoment" } } } }, "ResponseFc5Af1Fcba22_VideoChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" }, "is_verified": { "type": "boolean", "description": "Whether the channel is verified" }, "thumbnail": { "type": "string", "description": "Channel thumbnail URL" } } }, "ResponseFc5Af1Fcba22_KeyMoment": { "type": "object", "properties": { "title": { "type": "string", "description": "Key moment title" }, "start_seconds": { "type": "integer", "description": "Start time of the moment in seconds" }, "thumbnail": { "type": "string", "description": "Key moment thumbnail URL" } } }, "ResponseFc5Af1Fcba22_Playlist": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position in search results" }, "id": { "type": "string", "description": "Playlist ID" }, "title": { "type": "string", "description": "Playlist title" }, "link": { "type": "string", "description": "Link to the playlist" }, "video_count": { "type": "integer", "description": "Number of videos in playlist" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PlaylistChannel" }, "published_time": { "type": "string", "description": "Time since publication" }, "videos": { "type": "array", "description": "Videos in the playlist", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PlaylistVideo" } }, "thumbnail": { "type": "string", "description": "Playlist thumbnail URL" } } }, "ResponseFc5Af1Fcba22_PlaylistChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "is_verified": { "type": "boolean", "description": "Whether the channel is verified" }, "link": { "type": "string", "description": "Link to the channel" } } }, "ResponseFc5Af1Fcba22_PlaylistVideo": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID" }, "title": { "type": "string", "description": "Video title" }, "link": { "type": "string", "description": "Link to the video" }, "length": { "type": "string", "description": "Video duration" } } }, "ResponseFc5Af1Fcba22_Section": { "type": "object", "properties": { "section_title": { "type": "string", "description": "Section title" }, "position": { "type": "integer", "description": "Position in search results" }, "items": { "type": "array", "description": "Items in the section", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SectionItem" } } } }, "ResponseFc5Af1Fcba22_SectionItem": { "type": "object", "properties": { "id": { "type": "string", "description": "Item ID" }, "title": { "type": "string", "description": "Item title" }, "link": { "type": "string", "description": "Link to the item" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SectionChannel" }, "views": { "type": "integer", "description": "Number of views" }, "published_time": { "type": "string", "description": "Time since publication" }, "length": { "type": "string", "description": "Item duration" }, "thumbnail": { "type": "string", "description": "Item thumbnail URL" } } }, "ResponseFc5Af1Fcba22_SectionChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" } } }, "ResponseFc5Af1Fcba22_Shorts": { "type": "object", "properties": { "section_title": { "type": "string", "description": "Section title for shorts" }, "position": { "type": "integer", "description": "Position in search results" }, "items": { "type": "array", "description": "Short videos", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Short" } } } }, "ResponseFc5Af1Fcba22_Short": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position within shorts section" }, "id": { "type": "string", "description": "Short video ID" }, "title": { "type": "string", "description": "Short title" }, "link": { "type": "string", "description": "Link to the short" }, "duration": { "type": "string", "description": "Short duration" }, "views": { "type": "integer", "description": "Number of views" }, "thumbnail": { "type": "string", "description": "Short thumbnail URL" } } }, "ResponseFc5Af1Fcba22_Posts": { "type": "object", "properties": { "section_title": { "type": "string", "description": "Section title for posts" }, "position": { "type": "integer", "description": "Position in search results" }, "items": { "type": "array", "description": "Community posts", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Post" } } } }, "ResponseFc5Af1Fcba22_Post": { "type": "object", "properties": { "position": { "type": "integer", "description": "Position within posts section" }, "id": { "type": "string", "description": "Post ID" }, "link": { "type": "string", "description": "Link to the post" }, "text": { "type": "string", "description": "Post text content" }, "likes": { "type": "string", "description": "Number of likes text" }, "extracted_likes": { "type": "integer", "description": "Number of likes as integer" }, "comments": { "type": "string", "description": "Number of comments text" }, "extracted_comments": { "type": "integer", "description": "Number of comments as integer" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PostChannel" }, "published_time": { "type": "string", "description": "Time since publication" }, "thumbnail": { "type": "string", "description": "Post thumbnail URL" } } }, "ResponseFc5Af1Fcba22_PostChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" }, "is_verified": { "type": "boolean", "description": "Whether the channel is verified" }, "thumbnail": { "type": "string", "description": "Channel thumbnail URL" } } }, "ResponseFc5Af1Fcba22_PeopleAlsoSearchFor": { "type": "object", "properties": { "query": { "type": "string", "description": "Suggested search query" }, "link": { "type": "string", "description": "Link to perform the search" }, "thumbnail": { "type": "string", "description": "Thumbnail for the suggestion" } } }, "ResponseFc5Af1Fcba22_FeaturedChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Featured channel ID" }, "title": { "type": "string", "description": "Featured channel title" }, "subtitle": { "type": "string", "description": "Featured channel subtitle" }, "link": { "type": "string", "description": "Link to the featured channel" }, "highlighted_video": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_HighlightedVideo" }, "videos": { "type": "array", "description": "Featured channel videos", "items": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideo" } } } }, "ResponseFc5Af1Fcba22_HighlightedVideo": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID" }, "title": { "type": "string", "description": "Video title" }, "subtitle": { "type": "string", "description": "Video subtitle" }, "link": { "type": "string", "description": "Link to the video" }, "length": { "type": "string", "description": "Video duration" } } }, "ResponseFc5Af1Fcba22_FeaturedVideo": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID" }, "title": { "type": "string", "description": "Video title" }, "subtitle": { "type": "string", "description": "Video subtitle" }, "link": { "type": "string", "description": "Link to the video" }, "length": { "type": "string", "description": "Video duration" }, "channel": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideoChannel" }, "thumbnail": { "type": "string", "description": "Video thumbnail URL" } } }, "ResponseFc5Af1Fcba22_FeaturedVideoChannel": { "type": "object", "properties": { "id": { "type": "string", "description": "Channel ID" }, "title": { "type": "string", "description": "Channel name" }, "link": { "type": "string", "description": "Link to the channel" } } }, "ResponseFc5Af1Fcba22_Pagination": { "type": "object", "properties": { "next_page_token": { "type": "string", "description": "Token to fetch the next page of results" } } } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "Youtube", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-configured-paths": [ "/apis/v1/airbnb/search", "/apis/v1/ebay/search", "/apis/v1/youtube/search" ], "x-aisa-document": { "facts_hash": "7856a6c3cdb43dbf15e31461496a037f7df2217d189dadb9d27f406316aa651d", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "20", "response_pending": [], "document_hash": "sha256:3f4f90c4d989360c749762862df5a9c3c3d6141081173116f6f05e7c52034190" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "youtube", "x-aisa-catalogs": { "youtube": { "title": "Youtube", "description": "", "x-aisa-document": { "facts_hash": "7856a6c3cdb43dbf15e31461496a037f7df2217d189dadb9d27f406316aa651d", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/airbnb/search": { "get": { "description": "\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_youtube_apis_v1_airbnb_search", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseBfde03595B3D_SearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Airbnb Listings", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "5", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "567af6becf6d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c99d9611f9fc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "youtube", "x-aisa-runtime-operation": { "operation_id": "any_youtube_apis_v1_airbnb_search", "method": "ANY", "path": "/apis/v1/airbnb/search" }, "parameters": [ { "name": "adults", "in": "query", "required": false, "description": "Number of adult guests", "schema": { "type": "integer", "minimum": 0, "maximum": 16 } }, { "name": "airbnb_domain", "in": "query", "required": false, "description": "Airbnb domain to search (affects language and regional results)", "schema": { "type": "string", "default": "airbnb.com" } }, { "name": "amenities", "in": "query", "required": false, "description": "Comma-separated list of amenity keys (e.g., \"wifi,pool,kitchen\"). Supports hundreds of amenities including wifi, pool, kitchen, air_conditioning, heating, washer, dryer, parking, pets_allowed, wheelchair_accessible, gym, hot_tub, ev_charger, and many more. Also supports special filters: guest_favorite, instant_book, luxe.", "schema": { "type": "string" } }, { "name": "bathrooms", "in": "query", "required": false, "description": "Minimum number of bathrooms", "schema": { "type": "integer", "minimum": 0, "maximum": 8 } }, { "name": "bedrooms", "in": "query", "required": false, "description": "Minimum number of bedrooms", "schema": { "type": "integer", "minimum": 0, "maximum": 8 } }, { "name": "beds", "in": "query", "required": false, "description": "Minimum number of beds", "schema": { "type": "integer", "minimum": 0, "maximum": 8 } }, { "name": "bounding_box", "in": "query", "required": false, "description": "Geographic bounding box coordinates for map-based search. Format: [[ne_lat,ne_lng],[sw_lat,sw_lng]]. Either q or bounding_box is required.", "schema": { "type": "string" } }, { "name": "check_in_date", "in": "query", "required": false, "description": "Check-in date in YYYY-MM-DD format. Must be a future date. Cannot be used together with time_period.", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, { "name": "check_out_date", "in": "query", "required": false, "description": "Check-out date in YYYY-MM-DD format. Must be after check-in date. Requires check_in_date to be set.", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, { "name": "children", "in": "query", "required": false, "description": "Number of children guests", "schema": { "type": "integer", "minimum": 0, "maximum": 15 } }, { "name": "currency", "in": "query", "required": false, "description": "Currency code for pricing. Defaults to USD on airbnb.com; country-specific domains use their own local currency unless this parameter is set.", "schema": { "type": "string", "enum": [ "USD", "AUD", "BRL", "BGN", "BAM", "CAD", "CLP", "CNY", "COP", "CRC", "CZK", "DKK", "EGP", "AED", "EUR", "GHS", "GTQ", "HNL", "HKD", "HUF", "INR", "IDR", "ILS", "JPY", "KZT", "KES", "MYR", "MXN", "MAD", "TWD", "NZD", "NOK", "PEN", "PHP", "PLN", "GBP", "QAR", "RON", "RUB", "SAR", "SGD", "ZAR", "KRW", "SEK", "CHF", "THB", "TRY", "UGX", "UAH", "UYU", "VND" ], "default": "USD" } }, { "name": "engine", "in": "query", "required": true, "description": "Search engine identifier", "schema": { "type": "string", "enum": [ "airbnb" ] }, "example": "airbnb" }, { "name": "include_taxes", "in": "query", "required": false, "description": "When `true`, returns tax-inclusive search-card pricing. Each property's `price` then carries `total_with_taxes` and itemizes its tax lines in `breakdown`, without any extra per-property call. Applies to airbnb.com, where taxes normally appear only at checkout; other country-specific domains are unaffected (many, like EU domains, already show tax-inclusive totals by default). The nightly prices are the same as the default response; taxes are itemized on top.", "schema": { "type": "string", "enum": [ "true", "false" ], "default": "false" } }, { "name": "infants", "in": "query", "required": false, "description": "Number of infant guests", "schema": { "type": "integer", "minimum": 0, "maximum": 5 } }, { "name": "next_page_token", "in": "query", "required": false, "description": "Token for pagination to retrieve subsequent pages of results", "schema": { "type": "string" } }, { "name": "pets", "in": "query", "required": false, "description": "Number of pets", "schema": { "type": "integer", "minimum": 0, "maximum": 5 } }, { "name": "price_max", "in": "query", "required": false, "description": "Maximum price filter per night", "schema": { "type": "integer", "minimum": 0 } }, { "name": "price_min", "in": "query", "required": false, "description": "Minimum price filter per night", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_types", "in": "query", "required": false, "description": "Comma-separated list of property type keys", "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "description": "Search query for location (e.g., \"Barcelona\", \"Paris\"). Either q or bounding_box is required.", "schema": { "type": "string" } }, { "name": "time_period", "in": "query", "required": false, "description": "Flexible trip length for searches without specific dates. Cannot be used together with check_in_date.", "schema": { "type": "string", "enum": [ "weekend_trip", "one_week", "one_month" ], "default": "one_week" } }, { "name": "type_of_place", "in": "query", "required": false, "description": "Type of accommodation", "schema": { "type": "string", "enum": [ "any", "room", "entire_home" ] } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://www.searchapi.io/openapi/airbnb.yaml", "content_hash": "sha256:d968ef17258b9802867c93fc28a2af57e54b9047b441d90df86e6aba102583da", "fetched_at": "2026-09-29T18:43:53.639646+00:00", "converter": "scripts/import_upstream.py@2", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:e82cc3ef1506c44531ecbea95a3df4cd2d033f254208a9b5c415604c7326abf3" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://www.searchapi.io/openapi/airbnb.yaml", "content_hash": "sha256:d968ef17258b9802867c93fc28a2af57e54b9047b441d90df86e6aba102583da", "fetched_at": "2026-09-29T18:43:53.639646+00:00", "converter": "scripts/import_upstream.py@2", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:e82cc3ef1506c44531ecbea95a3df4cd2d033f254208a9b5c415604c7326abf3" }, "content_hash": "sha256:d310a3cc4184e9ac5812170a779c83b70941ea896310569b44a73a9684a41423" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/airbnb/search?engine=airbnb' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/youtube/any_youtube_apis_v1_airbnb_search" } }, "/apis/v1/ebay/search": { "get": { "description": "\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "any_youtube_apis_v1_ebay_search", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseDce247884A6B_SearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "eBay Search API -test", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "5", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "567af6becf6d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "356985c443c7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "youtube", "x-aisa-runtime-operation": { "operation_id": "any_youtube_apis_v1_ebay_search", "method": "ANY", "path": "/apis/v1/ebay/search" }, "parameters": [ { "name": "advanced_filters", "in": "query", "required": false, "description": "Comma-separated list of advanced filters in key=value format", "schema": { "type": "string" } }, { "name": "buying_format", "in": "query", "required": false, "description": "Buying format filter", "schema": { "type": "string", "enum": [ "auction", "buy_it_now", "best_offer" ] } }, { "name": "category_id", "in": "query", "required": false, "description": "Category ID to search within. Either 'q' or 'category_id' must be present", "schema": { "type": "integer" } }, { "name": "condition", "in": "query", "required": false, "description": "Comma-separated list of item conditions", "schema": { "type": "string", "pattern": "^(new|new_opened|like_new|new_with_defects|pre_owned_fair|pre_owned_excellent|used_very_good|used_good|used_acceptable|certified_refurbished|excellent_refurbished|very_good_refurbished|good_refurbished|seller_refurbished|for_parts_or_not_working|not_specified)(,(new|new_opened|like_new|new_with_defects|pre_owned_fair|pre_owned_excellent|used_very_good|used_good|used_acceptable|certified_refurbished|excellent_refurbished|very_good_refurbished|good_refurbished|seller_refurbished|for_parts_or_not_working|not_specified))*$" } }, { "name": "country", "in": "query", "required": false, "description": "ISO 3166-1 alpha-2 country code", "schema": { "type": "string", "enum": [ "US", "CA", "GB", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BR", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CO", "KM", "CD", "CG", "CK", "CR", "CI", "HR", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FJ", "FI", "FR", "GF", "PF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "SH", "KN", "LC", "PM", "VC", "SM", "SA", "SN", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "ES", "LK", "SR", "SZ", "SE", "CH", "TW", "TJ", "TZ", "TH", "TG", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "UY", "UZ", "VU", "VA", "VE", "VN", "VI", "WF", "EH", "WS", "YE", "FM", "RE", "ME", "RS" ] } }, { "name": "delivery_country", "in": "query", "required": false, "description": "Delivery country ISO 3166-1 alpha-2 code", "schema": { "type": "string", "enum": [ "US", "CA", "GB", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BR", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CO", "KM", "CD", "CG", "CK", "CR", "CI", "HR", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FJ", "FI", "FR", "GF", "PF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "SH", "KN", "LC", "PM", "VC", "SM", "SA", "SN", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "ES", "LK", "SR", "SZ", "SE", "CH", "TW", "TJ", "TZ", "TH", "TG", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "UY", "UZ", "VU", "VA", "VE", "VN", "VI", "WF", "EH", "WS", "YE", "FM", "RE", "ME", "RS" ] } }, { "name": "distance_radius", "in": "query", "required": false, "description": "Distance radius in miles from postal code. Requires postal code to be set", "schema": { "type": "number", "minimum": 1 } }, { "name": "ebay_domain", "in": "query", "required": false, "description": "eBay domain to search on", "schema": { "type": "string", "enum": [ "ebay.com", "ebay.com.au", "ebay.at", "befr.ebay.be", "benl.ebay.be", "ebay.ca", "cafr.ebay.ca", "ebay.fr", "ebay.de", "ebay.com.hk", "ebay.ie", "ebay.it", "ebay.com.my", "ebay.nl", "ebay.pl", "ebay.com.sg", "ebay.es", "ebay.ch", "ebay.co.uk" ], "default": "ebay.com" } }, { "name": "engine", "in": "query", "required": true, "description": "Search engine to use", "schema": { "type": "string", "enum": [ "ebay_search" ] }, "example": "ebay_search" }, { "name": "filters", "in": "query", "required": false, "description": "Comma-separated list of filters to apply", "schema": { "type": "string", "pattern": "^(search_description|sale_items|deals_and_savings|free_shipping|local_pickup|fast_arrival|free_returns|returns_accepted|listed_as_lots|authenticity_guarantee|authorized_seller|benefits_charity|psa_vault)(,(search_description|sale_items|deals_and_savings|free_shipping|local_pickup|fast_arrival|free_returns|returns_accepted|listed_as_lots|authenticity_guarantee|authorized_seller|benefits_charity|psa_vault))*$" } }, { "name": "include_related_results", "in": "query", "required": false, "description": "When set to `true`, returns eBay's \"Results matching fewer words\" items under a separate `related_results` key, both after the exact matches and when there are none. Defaults to `false`, which leaves them out and returns an error when no exact matches are found.", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "layout", "in": "query", "required": false, "description": "Results layout format", "schema": { "type": "string", "enum": [ "list", "grid" ] } }, { "name": "num", "in": "query", "required": false, "description": "Number of results per page", "schema": { "type": "integer", "enum": [ 60, 120, 240 ] } }, { "name": "page", "in": "query", "required": false, "description": "Page number (starts at 1)", "schema": { "type": "integer", "minimum": 1 } }, { "name": "postal_code", "in": "query", "required": false, "description": "Postal code for distance-based searches. Only supported for certain delivery countries (US, CA, GB, AU, AT, BE, CZ, FR, DE, IT, NL, PL)", "schema": { "type": "string" } }, { "name": "preferred_location", "in": "query", "required": false, "description": "Preferred seller location", "schema": { "type": "string", "enum": [ "domestic", "regional", "worldwide" ] } }, { "name": "price_max", "in": "query", "required": false, "description": "Maximum price filter (must be greater than or equal to price_min)", "schema": { "type": "number", "minimum": 0 } }, { "name": "price_min", "in": "query", "required": false, "description": "Minimum price filter", "schema": { "type": "number", "minimum": 0 } }, { "name": "product_origin_country", "in": "query", "required": false, "description": "Product origin country ISO 3166-1 alpha-2 code", "schema": { "type": "string", "enum": [ "US", "CA", "GB", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BR", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CO", "KM", "CD", "CG", "CK", "CR", "CI", "HR", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FJ", "FI", "FR", "GF", "PF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "SH", "KN", "LC", "PM", "VC", "SM", "SA", "SN", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "ES", "LK", "SR", "SZ", "SE", "CH", "TW", "TJ", "TZ", "TH", "TG", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "UY", "UZ", "VU", "VA", "VE", "VN", "VI", "WF", "EH", "WS", "YE", "FM", "RE", "ME", "RS" ] } }, { "name": "q", "in": "query", "required": false, "description": "Search query. Either 'q' or 'category_id' must be present", "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "description": "Sort results by", "schema": { "type": "string", "enum": [ "best_match", "price_shipping_low_to_high", "price_shipping_high_to_low", "distance_nearest", "time_ending_soonest", "time_newly_listed", "price_low_to_high", "price_high_to_low", "condition_new_first", "condition_used_first" ] } } ], "x-aisa-source": { "kind": "provider_openapi", "url": "https://www.searchapi.io/openapi/ebay_search.yaml", "fetched_at": "2026-10-10T05:04:45.340960+00:00", "content_hash": "sha256:fe554629d8714eac034e0aa800d0a7f3d6654ceedf426044c7a7ca72a1f4496f", "converter": "scripts/import_upstream.py@2", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:2c8c351abf26db189ca3b0d69af116adc0796701aedf785a51ec4cb76c3646ef" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "provider_openapi", "url": "https://www.searchapi.io/openapi/ebay_search.yaml", "fetched_at": "2026-10-10T05:04:45.340960+00:00", "content_hash": "sha256:fe554629d8714eac034e0aa800d0a7f3d6654ceedf426044c7a7ca72a1f4496f", "converter": "scripts/import_upstream.py@2", "owner": "AIsa-team/docs", "refresh_policy": "automatic", "review_period_days": 30, "refresh_interval_hours": 24, "policy_revision": "sha256:2c8c351abf26db189ca3b0d69af116adc0796701aedf785a51ec4cb76c3646ef" }, "content_hash": "sha256:0f9612d580be814639fbed95aa5f5059e5acca33973d513b61afb31d54d41e2d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/ebay/search?engine=ebay_search' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/youtube/any_youtube_apis_v1_ebay_search" } }, "/apis/v1/youtube/search": { "get": { "description": "Search YouTube and get back matching videos, channels, and playlists. Set `engine=youtube` and pass the query in `q`; both are required. Optionally narrow by country (`gl`) and interface language (`hl`), or pass a YouTube filter token in `sp` for pagination and advanced filters such as upload date, duration, or result type. Use this to find video content on a topic, track a channel's recent uploads, or gauge how much video coverage a subject has. Note: this is served through the AIsa mapped path `/apis/v1/youtube/search`; the upstream provider's canonical path is not mounted directly.\n\n\nPublished reference price: $0.0029 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_youtube_search", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Videos", "tags": [ "group1000" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "5", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0029, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "e9703f1ea902", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a3b7a875d2f0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/search", "x-aisa-upstream-selector": { "in": "query", "mode": "default", "name": "engine", "value": "youtube" }, "x-aisa-validation": "provider", "x-aisa-catalog-id": "youtube", "x-aisa-runtime-operation": { "operation_id": "get_youtube_search", "method": "ANY", "path": "/apis/v1/youtube/search" }, "parameters": [ { "name": "engine", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "youtube" ] }, "description": "SearchApi engine identifier. Use `youtube` for this YouTube endpoint." }, { "name": "gl", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country code (e.g. us, jp)" }, { "name": "hl", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Interface language" }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query. Required by runtime and upstream SearchApi." }, { "name": "sp", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YouTube filter token (pagination or advanced filters)" } ], "x-aisa-source": { "kind": "manual", "url": "https://www.searchapi.io/openapi/youtube.yaml", "fetched_at": "2026-10-11T18:03:19.694215+00:00", "content_hash": "sha256:ed522f6b9fdadbbeff31908a1b8619ff04cea5995ceda354a0f6c98fc232b2f0", "converter": "reviewed-official-response-import@1", "path_space": "public", "request_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/youte-search.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:a5940a16dfe22a9939f4e56b4ea8982d7731d9ad8981dfa4026bd3fde0a8d3fb", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:243a20fa66610e965d1cf3ee7a180624a465776ae33381a53b99116b925e42c8" }, "response_source": { "url": "https://www.searchapi.io/openapi/youtube.yaml", "raw_content_hash": "sha256:f14fa8544c09c6cbb8084d4e804b2f514a3a6e3304da3c9ebbbafd4cfca0a26d" }, "scope": "Only success response and referenced schemas replaced from the official YouTube definition; existing public request and error responses preserved.", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:145d7723ee706db86c86a06ef436efa07328aa43b4500f40ef0b0cc1d5c25778" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://www.searchapi.io/openapi/youtube.yaml", "fetched_at": "2026-10-11T18:03:19.694215+00:00", "content_hash": "sha256:ed522f6b9fdadbbeff31908a1b8619ff04cea5995ceda354a0f6c98fc232b2f0", "converter": "reviewed-official-response-import@1", "path_space": "public", "request_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/youte-search.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:a5940a16dfe22a9939f4e56b4ea8982d7731d9ad8981dfa4026bd3fde0a8d3fb", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:243a20fa66610e965d1cf3ee7a180624a465776ae33381a53b99116b925e42c8" }, "response_source": { "url": "https://www.searchapi.io/openapi/youtube.yaml", "raw_content_hash": "sha256:f14fa8544c09c6cbb8084d4e804b2f514a3a6e3304da3c9ebbbafd4cfca0a26d" }, "scope": "Only success response and referenced schemas replaced from the official YouTube definition; existing public request and error responses preserved.", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:145d7723ee706db86c86a06ef436efa07328aa43b4500f40ef0b0cc1d5c25778" }, "content_hash": "sha256:0becc3a0bfba2377be42f7170635fd0f879192d02b2d266092189ae3c62e1293" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/get_youtube-search" } } } }