Etsy-API

Etsy-Suche-API

Search Etsy listings by keyword, the same results an Etsy search or /market page shows, with optional sort, price range and page, and get title, price, original price, image, shop, rating and ad flag for each listing in one normalized response.

POST/v1/run/etsy.search
Verfügbarkeit
100,00%
30d · 1 Aufruf
Anfragen
1
30d
Antwort
2,9s
Median · 30d

Preise und Anbieter

Preise der Etsy-Suche-API: eine API, 2 austauschbare Anbieter

Der günstigste Anbieter bedient zuerst. Fällt er aus, übernimmt der nächste im selben Aufruf.

Du zahlst
8,50 USD
0,85 USD/1k Anfr., nur für das, was du nutzt. Kein Monatstarif.
Deine ersten 117 Anfragen sind mit dem Startguthaben von 0,10 USD kostenlos.

Ausprobieren

Etsy Suche mit einer Anfrage abrufen

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `rating`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Öffnen in
Beispielantwort
Kostenlose Läufe liefern nur die ersten 3 Ergebnisse. Lade einen Schlüssel auf, um die vollständige Antwort zu bekommen.
{
  "data": {
    "items": [
      {
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "isSponsored": true,
        "listingId": "a1b2c3d4",
        "originalPrice": 19.99,
        "price": 19.99,
        "rating": 4.6,
        "reviewsCount": 12500,
        "shopId": "a1b2c3d4",
        "shopName": "Example title",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "totalResults": 12500
  },
  "found": true,
  "reason": "not_found"
}

Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.

Referenz

Eine Anfrage, eine Antwortstruktur.

Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.

Zuletzt geprüft 2026-10-23 · Verfügbarkeit und Latenz gemessen über 30d

Request-Body

JSON, per POST an diesen Endpoint gesendet.

  • querystring

    cover letter template

    Search keywords, e.g. "cover letter template". For an Etsy /market page, pass its words: https://www.etsy.com/market/habit_tracker_2027 is the query "habit tracker 2027".

  • maxPricenumber

    Optional maximum listing price, in USD.

  • minPricenumber

    Optional minimum listing price, in USD.

  • pageinteger

    1-based results page. Each page is billed as one request.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `rating`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • sortenum

    Result order: relevance (Etsy's own order, the default), newest, price_low, or price_high.

Du sendest. Ein kleiner JSON-Body. Die gezeigten Werte sind Beispiele, die du durch deine eigenen ersetzt.

Antwort

JSON, ein Beispielwert pro Feld.

each itemdata.items[]

Matching Etsy listing cards for the requested page, ads included where Etsy shows them. Populated whenever the provider has data for the entity.

  • currencystring

    Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.

  • imagestring

    Primary listing image URL, or null when the listing has none. Populated whenever the provider has data for the entity.

  • isSponsoredboolean

    True when the listing is an ad Etsy placed in the results, or null when not reported.

  • listingIdstring

    Etsy listing id, the number in the listing URL (https://www.etsy.com/listing/<id>/...); pass it to the Etsy Product SKU. Populated whenever the provider has data for the entity.

  • originalPricenumber

    Price before the current sale, or null when the listing is not on sale.

  • pricenumber

    Current price in the listing currency, or null when not shown. Populated whenever the provider has data for the entity.

  • ratingnumberkann erfordern

    Average rating of the listing, 0-5, or null when unrated or the serving source does not report it.

  • reviewsCountintegerkann erfordern

    Number of reviews of the listing, or null when not reported.

  • shopIdstring

    Etsy's numeric shop id, or null when not reported.

  • shopNamestring

    Name of the shop selling the listing; pass it to the Etsy Shop or Etsy Shop Listings SKU. Null when not reported. Populated whenever the provider has data for the entity.

  • titlestring

    Listing title. Populated whenever the provider has data for the entity.

  • urlstring

    Etsy listing page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.

datadata

Search result wrapper, or null when nothing matched.

  • totalResultsintegerkann erfordern

    Total listings Etsy reports for the search, or null when the serving source does not report it.

top level
  • foundboolean

    True when the search returned at least one listing.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Du bekommst zurück. Benannte, typisierte Felder in derselben Struktur, egal welche Quelle antwortet.

FAQ

Über die Etsy-Suche-API

Die AnyAPI-Etsy-Suche-API liefert Etsy-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/etsy.search. Search Etsy listings by keyword, the same results an Etsy search or /market page shows, with optional sort, price range and page, and get title, price, original price, image, shop, rating and ad flag for each listing in one normalized response. AnyAPI routet jede Anfrage über 2 Quellen und weicht automatisch aus, wenn eine ausfällt. Sie kostet ab 0,85 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 100,0% der Etsy Suche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 2,9 Sekunden über 1 gemessene Aufrufe.

Sie kostet ab 0,85 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. Du lädst ein USD-Guthabenkonto auf, und jeder Aufruf bucht davon ab. Bei manchen fehlgeschlagenen, vom Guthabenkonto bezahlten Anfragen fallen Bearbeitungsgebühren an, die wir zum Selbstkostenpreis ohne Aufschlag weitergeben. Die Fehlerantwort zeigt den berechneten Betrag.

Search Etsy listings by keyword, the same results an Etsy search or /market page shows, with optional sort, price range and page, and get title, price, original price, image, shop, rating and ad flag for each listing in one normalized response. Die Antwort ist normalisiertes JSON mit demselben Envelope, den jeder AnyAPI-Endpoint liefert, sodass das Parsen eines zweiten Endpoints nur eine geänderte URL bedeutet.

In den letzten 30 Tagen waren 100,0% der Etsy Suche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 2,9 Sekunden über 1 gemessene Aufrufe. Das sind AnyAPIs eigene Messungen des Traffics durch das Gateway, laufend neu berechnet, kein veröffentlichtes Service-Level-Ziel.

Ja. Ein neues AnyAPI-Konto startet mit 0,10 USD Gratis-Guthaben, ohne Karte. Das deckt 117 Etsy-Suche-Aufrufe zu je 0,00085 USD.

AnyAPI fragt in derselben Anfrage die nächste seiner 2 Quellen, die günstigste zuerst, sodass der Ausfall einer Quelle deinen Aufruf nicht scheitern lässt.

Sende eine POST-Anfrage an https://api.getanyapi.com/v1/run/etsy.search mit deinem AnyAPI-Schlüssel in einem Header „Authorization: Bearer“ und der Eingabe als JSON-Body. Derselbe Schlüssel und dasselbe Guthabenkonto funktionieren bei jedem AnyAPI-Endpoint.

Nein. Du lädst US-Dollar auf ein Prepaid-AnyAPI-Guthaben, und jede Anfrage bucht davon ab. Es gibt keinen Monatstarif und kein Minimum, und dasselbe Guthaben bezahlt jeden AnyAPI-Endpoint.

Ja. Installiere @getanyapi/sdk von npm für TypeScript oder getanyapi von pip für Python. Beide rufen jeden AnyAPI-Endpoint mit demselben Schlüssel auf, und jeder HTTP-Client funktioniert ebenfalls.

Ja. Ein Agent kann sich mit dem AnyAPI-MCP-Server unter https://api.getanyapi.com/mcp verbinden oder mit einem unauthentifizierten POST an https://api.getanyapi.com/agent/signup einen eigenen kostenlosen Test-Schlüssel erstellen und diesen Endpoint über HTTP aufrufen.