> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > ## Agent Instructions (AIsa) > > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # eBay Search API -test > Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/ebay/search * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/ebay/search](https://api.aisa.one/apis/v1/ebay/search) * **advanced\_filters:** query; optional * **buying\_format:** query; optional * **category\_id:** query; optional * **condition:** query; optional * **country:** query; optional * **delivery\_country:** query; optional * **distance\_radius:** query; optional * **ebay\_domain:** query; optional * **engine:** query; required * **filters:** query; optional * **include\_related\_results:** query; optional * **layout:** query; optional * **num:** query; optional * **page:** query; optional * **postal\_code:** query; optional * **preferred\_location:** query; optional * **price\_max:** query; optional * **price\_min:** query; optional * **product\_origin\_country:** query; optional * **q:** query; optional * **sort\_by:** query; optional * **Runtime facts:** 7856a6c3cdb43dbf15e31461496a037f7df2217d189dadb9d27f406316aa651d [Complete OpenAPI definition](https://aisa.one/docs/openapi/youtube.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_youtube_apis_v1_ebay_search", "method": "GET", "path": "/apis/v1/ebay/search", "servers": [ { "url": "https://api.aisa.one" } ], "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" ] } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "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" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.001 * **Cost contract:** fixed\_success * **Published reference multiplier:** 1.0 * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/youtube.json GET /apis/v1/ebay/search openapi: 3.1.0 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 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 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 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/ebay/search: get: tags: - default summary: eBay Search API -test description: >- Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ. operationId: any_youtube_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 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 x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request GET \ --url 'https://api.aisa.one/apis/v1/ebay/search?engine=ebay_search' \ --header 'Authorization: Bearer ' components: schemas: 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_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_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_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) 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_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_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 securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.