@scrapecreators/cli 1.0.12 → 1.0.14

package/api-config/apis.js

@@ -5651,7 +5651,7 @@ export const apis = [
         name: "Ad Details",
         method: "GET",
         description:
-          "Pass the Ad ID and get back details about the ad. Be careful that if an ad has multiple versions, you're actually going to want to get the title from the 'cards' object. If you ask for the transcipt, we will only transcribe the video if it's under 2 minutes.",
+          "Pass the Ad ID and get back details about the ad. Be careful that if an ad has multiple versions, you're actually going to want to get the title from the 'cards' object.",
         fullDescription:
           "Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body.",
         path: "/v1/facebook/adLibrary/ad",
@@ -5979,14 +5979,6 @@ export const apis = [
             placeholder:
               "https://www.facebook.com/ads/library?id=1185617869915074",
           },
-          {
-            name: "get_transcript",
-            type: "boolean",
-            required: false,
-            description:
-              "Get the transcript of the ad. Only works if the video is under 2 minutes.",
-            placeholder: "false",
-          },
           {
             name: "trim",
             type: "boolean",
@@ -6004,6 +5996,48 @@ export const apis = [
           },
         ],
       },
+      {
+        name: "Ad Transcript",
+        method: "GET",
+        description:
+          "Get the transcript for a Facebook Ad Library video ad by ad ID or URL. Credits are only charged when a transcript is returned.",
+        fullDescription:
+          "Retrieves a transcript for a single Facebook Ad Library video ad by ID or URL. If Facebook exposes captions, those are used. Otherwise we try to transcribe the public video URL. Credits are only deducted when transcript is returned. If the ad has no video or no transcript is available, transcript will be null and no credit is charged.",
+        path: "/v1/facebook/adLibrary/ad/transcript",
+        sampleResponse: {
+          success: true,
+          credits_remaining: 100,
+          data: {
+            ad_id: "1020359190509080",
+            url: "https://www.facebook.com/ads/library?id=1020359190509080",
+            transcript: "Sample transcript text from the ad video...",
+            transcript_available: true,
+          },
+        },
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: false,
+            description: "Facebook Ad Id",
+            placeholder: "1020359190509080",
+          },
+          {
+            name: "url",
+            type: "string",
+            required: false,
+            description: "Facebook Ad URL",
+            placeholder:
+              "https://www.facebook.com/ads/library?id=1020359190509080",
+          },
+        ],
+        responseFields: [
+          {
+            path: "data.transcript",
+            description: "Transcript text for the ad video, or null when unavailable.",
+          },
+        ],
+      },
       {
         name: "Search",
         method: "GET",
@@ -28839,6 +28873,140 @@ export const apis = [
           ]
         },
       },
+      {
+        name: "Search",
+        method: "GET",
+        description: "Search Spotify",
+        fullDescription:
+          "Search Spotify for tracks, artists, albums, episodes, podcasts, and audiobooks. Use type=podcasts when you need podcast ids for the podcast endpoints.",
+        path: "/v1/spotify/search",
+        params: [
+          {
+            name: "query",
+            type: "string",
+            required: true,
+            description: "Search query",
+            placeholder: "joe rogan",
+          },
+          {
+            name: "type",
+            type: "string",
+            required: false,
+            description: "Optional result type. Use one of: all, tracks, artists, albums, episodes, podcasts, audiobooks.",
+            placeholder: "podcasts",
+          },
+          {
+            name: "offset",
+            type: "number",
+            required: false,
+            description: "Result offset for pagination",
+            placeholder: "0",
+          },
+          {
+            name: "limit",
+            type: "number",
+            required: false,
+            description: "Number of results to return",
+            placeholder: "10",
+          },
+        ],
+        sampleResponse: {
+          "success": true,
+          "credits_remaining": 49997935401,
+          "query": "joe rogan",
+          "podcasts": [
+            {
+              "id": "4rOoJ6Egrf8K2IrywzwOMk",
+              "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
+              "name": "The Joe Rogan Experience",
+              "description": "The official podcast of comedian Joe Rogan."
+            }
+          ]
+        },
+      },
+      {
+        name: "Podcast",
+        method: "GET",
+        description: "Get Spotify podcast",
+        fullDescription:
+          "Retrieves detailed information about a Spotify podcast by its id or URL. Spotify calls podcasts shows internally, so Spotify podcast URLs use /show/.",
+        path: "/v1/spotify/podcast",
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: false,
+            description: "Spotify podcast id. If you'd prefer to use the URL instead, you can use the url parameter instead.",
+            placeholder: "4rOoJ6Egrf8K2IrywzwOMk",
+          },
+          {
+            name: "url",
+            type: "string",
+            required: false,
+            description: "Spotify podcast URL. If you'd prefer to use the id instead, you can use the id parameter instead.",
+            placeholder: "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
+          },
+        ],
+        sampleResponse: {
+          "success": true,
+          "credits_remaining": 49997935400,
+          "id": "4rOoJ6Egrf8K2IrywzwOMk",
+          "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
+          "name": "The Joe Rogan Experience",
+          "publisher": {
+            "name": "Joe Rogan"
+          },
+          "type": "PODCAST"
+        },
+      },
+      {
+        name: "Podcast Episodes",
+        method: "GET",
+        description: "Get Spotify podcast episodes",
+        fullDescription:
+          "Returns episodes for a Spotify podcast. Pass the cursor returned by a response to get the next page.",
+        path: "/v1/spotify/podcast/episodes",
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: false,
+            description: "Spotify podcast id. If you'd prefer to use the URL instead, you can use the url parameter instead.",
+            placeholder: "4rOoJ6Egrf8K2IrywzwOMk",
+          },
+          {
+            name: "url",
+            type: "string",
+            required: false,
+            description: "Spotify podcast URL. If you'd prefer to use the id instead, you can use the id parameter instead.",
+            placeholder: "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
+          },
+          {
+            name: "cursor",
+            type: "number",
+            required: false,
+            description: "Cursor returned by the previous response. Omit for the first page.",
+            placeholder: "50",
+          },
+        ],
+        sampleResponse: {
+          "success": true,
+          "credits_remaining": 49997935399,
+          "data": {
+            "id": "4rOoJ6Egrf8K2IrywzwOMk",
+            "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
+            "episodes": [
+              {
+                "id": "46MudXmYxlZldT0NIXjlb6",
+                "uri": "spotify:episode:46MudXmYxlZldT0NIXjlb6",
+                "name": "#2506 - Michelle Thaller"
+              }
+            ],
+            "cursor": 50,
+            "totalCount": 2698
+          }
+        },
+      },
     ],
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrapecreators/cli",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "CLI for the ScrapeCreators API — scrape 27+ social media platforms from the terminal",
   "type": "module",
   "bin": {