Serpent API Documentation

Getting Started

Serpent API provides programmatic access to search results from Google, Bing, Yahoo, DuckDuckGo, and Brave, plus AI ranking and social media data. It supports three categories of endpoints:

SERP Endpoints

• Quick Search — speed-optimized organic results, ~10 by default and up to num=100 requested (best-effort at the high end — num is a ceiling, not a promise, and short deliveries carry meta.partialResults). Web billing is flat: one call, one charge, whatever the page count. Use /api/search Deep Search when you need rich SERP features. "Google SERP" here means search results from Google · Bing · Yahoo · DuckDuckGo · Brave.
• Deep Search — up to 10 pages (~100 results requested) with related searches, ads, PAA, featured snippets, and AI overviews. Defaults to 1 page — set num or pages to go deeper, and note that every page you ask for is charged — /api/search bills one Web unit per requested page, at every tier and every balance.
• News Search — News articles with sources, timestamps, and snippets
• Image Search — Images with thumbnails, originals, dimensions, and sources
• Video Search — Video results with titles, thumbnails, durations, and views
• Shopping Search coming soon — product results with titles, prices where available, merchant/store names, URLs, and thumbnails. Not callable yet — /api/shopping answers 404 today.

AI Ranking Endpoints

• Combined AI Rank — Check how AI models (Claude, ChatGPT, Gemini, Perplexity) cite your domain
• Single Engine Rank — Query a specific LLM for citation analysis

Social Media Endpoints

• YouTube Search — Search for videos, channels, and playlists
• YouTube Video/Channel — Get detailed video and channel information
• Instagram Profile — Public profile data and recent posts

Google Maps Endpoints

• Quick Place Search — up to 20 ranked places; draws from the shared 10-call free pool for new accounts
• Deep Place Search — attempts up to 100 ranked places with truthful partial-detail status
• Place Details — one richest-available normalized place record
• Reviews — up to 20 public reviews per call with opaque pagination

curl "https://apiserpent.com/api/search?q=hello+world" \
  -H "X-API-Key: YOUR_KEY"

Base URL

All API requests use the following base URL:

All endpoints are relative to this base. For example, the web search endpoint is:

Authentication

All search endpoints require an API key. You can authenticate in two ways:

Option 1: HTTP Header (Recommended)

X-API-Key: sk_live_your_api_key_here

Option 2: Query Parameter (discouraged)

GET /api/search?q=keyword&api_key=sk_live_your_api_key_here

Free Tier

Every new account receives one shared lifetime allowance of free calls (no credit card required), usable across:

• Quick Search (/api/search/quick) — all engines (Google, Bing, Yahoo, DDG, Brave) — draws from the same shared pool
• Deep Search (/api/search) — all engines
• Maps Quick (/api/maps/search/quick) — draws from the same shared pool
• Maps Deep and Maps List (/api/maps/search) — draw from the same shared pool, and count as one free call at any detail or limit
• Amazon (/api/amazon/product, /search, /bestsellers) — draws from the same shared pool
• TikTok (/api/tiktok/profile, /video, /hashtag, /search, /music) — draws from the same shared pool, and counts as one free call at any limit or field-group count
• X (Twitter) (/api/x/tweet, /api/x/profile) — draws from the same shared pool. A profile call with hydrate=true costs one free call, not one and a half — the pool counts calls, not multipliers
• Reddit (/api/reddit/posts, /comments, /search, /user, /subreddit) — draws from the same shared pool, and counts as one free call at any limit, even the four-block limit=100

Quick Search

Perform a fast organic web search. Returns ~10 organic results by default, and can be asked for up to 100 organic results in a single call via num=. num is a ceiling, not a promise: num=50 and below delivers in full, and above that a call is best-effort — a short answer carries meta.partialResults and the top-level delivery block saying exactly what arrived and why. Quick Search is organic-only on engine=google; on Yahoo, Bing, DuckDuckGo and Brave it still returns that engine’s supported feature blocks. Every feature key is always present in results, so the response shape never changes — a block this engine or this page does not carry arrives empty ([]) or null. Use Deep Search (/api/search) for the full Google feature set. "Google SERP" here means search results from Google · Bing · Yahoo · DuckDuckGo · Brave. Web billing is flat: one call, one charge, whatever the page count, balance or tier.

Parameters

Example Request

curl "https://apiserpent.com/api/search/quick?q=weather+today&engine=google&country=uk" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

{
  "success": true,
  "query": "weather today",
  "engine": "google",
  "country": "uk",
  "results": {
    "organic": [
      {
        "position": 1,
        "title": "Weather Forecast - Today",
        "url": "https://example.com/weather",
        "snippet": "Today's weather forecast...",
        "displayedUrl": "example.com"
      }
    ],
    "ads": { "top": [], "bottom": [], "totalCount": 0 },
    "peopleAlsoAsk": [],
    "relatedSearches": [],
    "featuredSnippet": null,
    "aiOverview": null,
    "knowledgePanel": null,
    "localPack": [],
    "richSnippets": [],
    "videos": [],
    "shopping": []
  },
  "meta": {
    "totalOrganic": 7,
    "elapsed": "1200ms",
    "timestamp": "2026-03-03T10:30:00.000Z"
  }
}

Deep Search

Perform a deep web search that can be asked for up to 100 organic results with related searches, ads, People Also Ask, featured snippets, AI overviews, and more. For more than 10 results, the API automatically retrieves multiple pages; num is the depth you request, not a count that is guaranteed, and a short answer carries meta.partialResults and the top-level delivery block. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/search?q=best+seo+tools&num=30&engine=google&country=us" \
  -H "X-API-Key: sk_live_your_api_key"

The results object is the same on every engine

Deep Search returns one results shape, identical on google, yahoo, bing, ddg and brave: organic, ads, peopleAlsoAsk, relatedSearches, featuredSnippet, aiOverview, knowledgePanel, localPack, richSnippets, videos and shopping. Every one of those keys is always present. A block the result page did not contain — or that the engine you asked for does not carry — comes back as its own empty value (null for the object-shaped blocks, [] for the array-shaped ones), never as a missing key, so you can write one parser and point it at any engine.

metadata follows the same rule on every engine and always carries totalOrganicResults, hasAds, hasRelatedSearches, hasPeopleAlsoAsk, hasVideos, hasShopping, hasFeaturedSnippet, hasAiOverview, hasKnowledgePanel, hasLocalPack and source. Each has* boolean describes what this response actually published, so it is the cheapest way to test whether a block is worth reading. What varies by engine is how often a block is filled in, not which keys you get — see Search Engines.

Example Response

{
  "success": true,
  "query": "best seo tools",
  "engine": "google",
  "country": "us",
  "pagesRequested": 3,
  "pagesScraped": 3,
  "results": {
    "organic": [
      {
        "position": 1,
        "title": "10 Best SEO Tools for 2026",
        "url": "https://example.com/seo-tools",
        "snippet": "Discover the top SEO tools...",
        "displayedUrl": "example.com"
      }
    ],
    "relatedSearches": [{ "query": "free seo tools" }],
    "ads": { "top": [], "bottom": [], "totalCount": 0 },
    "peopleAlsoAsk": [],
    "featuredSnippet": null,
    "aiOverview": null,
    "knowledgePanel": null,
    "localPack": [],
    "richSnippets": [],
    "videos": [],
    "shopping": []
  },
  "metadata": {
    "totalOrganicResults": 30,
    "hasAds": false,
    "hasRelatedSearches": true,
    "hasPeopleAlsoAsk": false,
    "hasVideos": false,
    "hasShopping": false,
    "hasFeaturedSnippet": false,
    "hasAiOverview": false,
    "hasKnowledgePanel": false,
    "hasLocalPack": false,
    "source": "google"
  },
  "meta": {
    "totalOrganic": 30,
    "requestedNum": 30,
    "elapsed": "8500ms",
    "timestamp": "2026-03-10T10:30:00.000Z"
  }
}

AI Mode

AI Mode is a parameter on Deep Search, not a separate endpoint. Add include_ai_mode=true to a /api/search call and the response carries one extra top-level key, aiMode, beside results: a written answer to your query, the pages that answer draws on, and a short list of suggested follow-up questions. Everything else in the response is exactly what it was.

Parameter

Example Request

curl "https://apiserpent.com/api/search?q=how+to+tie+a+tie&engine=google&country=us&include_ai_mode=true" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

aiMode sits at the top level, beside results — it is not inside it. The results object, metadata and meta are untouched and are abbreviated here.

{
  "success": true,
  "query": "how to tie a tie",
  "engine": "google",
  "results": { "...": "unchanged" },
  "aiMode": {
    "answer": "The four-in-hand is the easiest knot to learn...",
    "sources": [
      { "url": "https://example.com/guide", "title": "How to Tie a Tie" }
    ],
    "followUps": [
      "How do I tie a Windsor knot?",
      "Which tie knot works best for a wide collar?"
    ]
  },
  "metadata": { "...": "unchanged" },
  "meta": { "...": "unchanged" }
}

The shape never varies

When you ask for AI Mode you always get the same object: answer is a string, sources is an array of { url, title }, and followUps is an array of strings. It is never null and never a different type. A response that could not be filled carries an empty version of that same object — answer: "", sources: [], followUps: [] — and the search results ship with it as usual. So branch on the array lengths and on whether answer is empty, never on whether the key exists. The key exists whenever you asked for it and is absent whenever you did not.

Pricing

A flat $0.004 per call, added to what the Deep Search call itself costs — never instead of it. It is charged once per request whether that request returns one page or ten, and it is the same on every plan: Growth and Scale do not discount it. See the rate card.

If the answer comes back empty, the $0.004 is refunded automatically and the search you asked for is still delivered and still billed at its own rate. You are never charged the surcharge for an aiMode object with nothing in it. A free-tier call that asks for AI Mode is never charged the surcharge at all.

On a paid account, asking for AI Mode takes the call out of your free allowance. A Deep Search carrying include_ai_mode=true is never served from your remaining free calls: it is billed in full — the Web rate for every page you asked for, plus the $0.004 — even when free calls are still left. Those free calls are not spent on it; they are simply not available to it, so leave the parameter off and the same search draws on the allowance exactly as before.

News Search API

Search for news articles from various sources. Returns article titles, sources, publication times, and snippets.

Parameters

Example Request

curl "https://apiserpent.com/api/news?q=artificial+intelligence&num=20&country=us" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

{
  "success": true,
  "query": "artificial intelligence",
  "type": "news",
  "engine": "google",
  "country": "us",
  "pagesScraped": 2,
  "results": {
    "articles": [
      {
        "position": 1,
        "title": "AI Breakthroughs Reshape Industry",
        "url": "https://example.com/ai-news",
        "source": "Tech News Daily",
        "publishedTime": "2026-03-02",
        "snippet": "Major advances in AI...",
        "image": "https://example.com/ai-news-thumb.jpg"
      }
    ],
    "totalResults": 20
  },
  "meta": {
    "totalArticles": 20,
    "elapsed": "1800ms",
    "timestamp": "2026-03-03T10:30:00.000Z"
  }
}

Image Search API

Search for images across the web. Returns thumbnails, original image URLs, and source websites. A single request can ask for up to 100 images via num=, but that is a ceiling, not a promise — no engine has been measured returning the full 100 in one call. Measured at num=100: about 60 on google, bing and yahoo, ~95 on ddg, ~50 on brave. A short answer carries meta.partialResults and the top-level delivery block.

Parameters

Example Request

curl "https://apiserpent.com/api/images?q=mountain+landscape&num=20" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

{
  "success": true,
  "query": "mountain landscape",
  "type": "images",
  "engine": "google",
  "country": "us",
  "results": {
    "images": [
      {
        "position": 1,
        "title": "Beautiful Mountain View",
        "thumbnail": "https://example.com/thumb/...",
        "original": "https://example.com/image.jpg",
        "width": 1920,
        "height": 1080,
        "source": "example.com",
        "pageUrl": "https://example.com/gallery"
      }
    ],
    "totalResults": 20
  },
  "meta": {
    "totalImages": 20,
    "elapsed": "2100ms",
    "timestamp": "2026-03-03T10:30:00.000Z"
  }
}

Video Search API

Search for videos on Google, DuckDuckGo, Yahoo, Bing or Brave. Returns video titles, thumbnails, durations, view counts, and source URLs. Available with engine=ddg (the default), engine=google, engine=yahoo, engine=bing or engine=brave. num asks for up to 100, but that is a ceiling, not a promise — measured at num=100: Google ~60, Yahoo ~60, Bing ~59, DDG ~59, Brave ~50. A short answer carries meta.partialResults and the top-level delivery block.

Parameters

Example Request

curl "https://apiserpent.com/api/videos?q=python+tutorial&num=20&engine=ddg" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

{
  "success": true,
  "query": "python tutorial",
  "type": "videos",
  "engine": "ddg",
  "country": "us",
  "results": {
    "videos": [
      {
        "position": 1,
        "title": "Python Tutorial for Beginners",
        "url": "https://www.youtube.com/watch?v=...",
        "duration": "6:14:07",
        "source": "www.youtube.com",
        "views": 45000000,
        "thumbnail": "https://i.ytimg.com/vi/.../hqdefault.jpg",
        "description": "A full beginner course covering syntax, data structures, and functions.",
        "publisher": "Dev Tutorials",
        "embedUrl": "https://www.youtube.com/embed/...",
        "publishedTime": "2026-01-14"
      }
    ],
    "totalResults": 20
  },
  "meta": {
    "totalVideos": 20,
    "elapsed": "3800ms",
    "timestamp": "2026-03-10T10:30:00.000Z"
  }
}

Shopping Search API

Search product results with engine=google, engine=yahoo (default), engine=ddg, or engine=brave. All four serve product listings with distinct, engine-specific field names: engine=google returns Google-style fields (link, source, product_rating, product_reviews); engine=yahoo, engine=ddg, and engine=brave return card-style fields (url, merchant, store, rating, reviews). Each item also includes price when available, a separate currency field, thumbnail, sponsored flag, and snippet.

Parameters

Example Request

curl "https://apiserpent.com/api/shopping?q=nike+running+shoes&engine=google&num=10" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

{
  "success": true,
  "query": "nike running shoes",
  "type": "shopping",
  "engine": "google",
  "country": "us",
  "results": {
    "shopping": [
      {
        "position": 1,
        "title": "Nike Vomero 18 Men's Road Running Shoes",
        "link": "https://www.nike.com/...",
        "source": "Nike",
        "price": "$150.00",
        "currency": "USD",
        "thumbnail": "https://example.com/product.jpg",
        "product_rating": 4.7,
        "product_reviews": 128,
        "sponsored": false,
        "snippet": "A stable, responsive daily trainer for neutral runners."
      }
    ],
    "totalResults": 10
  },
  "meta": {
    "totalShopping": 10,
    "elapsed": "4200ms",
    "timestamp": "2026-08-03T10:30:00.000Z"
  }
}

Pixel Position BETA

Add pixel_position=true to /api/search on engine=google, yahoo, bing or ddg, and every item in the response — organic, AI Overview, PAA, ads, featured snippet, knowledge panel, local pack, shopping, videos — gets two extra fields: a pixel_position integer (y-coordinate in pixels from the top of the rendered desktop SERP) and a pixel_box object with the element's full bounding rectangle ({ x, y, w, h }). Useful for above-the-fold analysis, share-of-voice scoring, and SERP layout audits.

AI Ranking API — Combined

Check how AI language models cite and rank your domain or brand. This endpoint queries multiple LLMs (Claude, ChatGPT, Gemini, Perplexity) simultaneously and returns citation analysis for each.

Parameters

Example Request

curl "https://apiserpent.com/api/ai/rank?keyword=best+seo+tools&domain=ahrefs.com&engines=claude,chatgpt" \
  -H "X-API-Key: sk_live_your_api_key"

Per-Engine Response Fields

Subdomain matching is implicit — the API tries an exact match first, then falls back to a subdomain match. Use target_match_type on the client to differentiate the two when displaying ranking results.

AI Ranking API — Single Engine

Query a specific AI engine for citation analysis. Available engines: claude, chatgpt, gemini, perplexity.

URL Paths

Prices shown are Default tier. Growth (10× off) locks in with a one-time $100 deposit and Scale (20× off) with a one-time $500 deposit.

Parameters

Example Request

curl "https://apiserpent.com/api/ai/rank/claude?keyword=best+crm+software&domain=hubspot.com" \
  -H "X-API-Key: sk_live_your_api_key"

YouTube Search API

Search YouTube videos, channels, and playlists by keyword. Each result carries its title, channel, publish date and thumbnail, and the list can be filtered by type, order and duration. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/social/youtube/search?q=machine+learning&type=video&num=10&order=viewCount" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

Captured live from GET /api/social/youtube/search?q=how+to+solve+a+rubiks+cube&num=3. Verbatim except the three description values, trimmed for print — on a real call they carry the video's full description text.

{
  "success": true,
  "query": "how to solve a rubiks cube",
  "type": "video",
  "results": [
    {
      "position": 1,
      "id": "7Ron6MN45LY",
      "type": "video",
      "title": "Learn How to Solve a Rubik's Cube in 10 Minutes (Beginner Tutorial)",
      "description": "Learning to solve a Rubik's Cube can be easy! Read the pinned comment for common questions.\n\nHow To Solve FASTER ► https://www.youtube.co...",
      "channelId": "UCqTVfT9JQqhA6_Hi_h_h97Q",
      "channelTitle": "J Perm",
      "publishedAt": "2018-09-19T16:36:25Z",
      "thumbnail": "https://i.ytimg.com/vi/7Ron6MN45LY/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=7Ron6MN45LY"
    },
    {
      "position": 2,
      "id": "PW2J8IblczM",
      "type": "video",
      "title": "How to Solve a Rubik's Cube [Best Method 2026]",
      "description": "I have taught millions of people to solve their first 3x3 Rubik's Cube using this beginner's method. For this tutorial, I collaborated wi...",
      "channelId": "UC9wvQsn9VGQsX9uFWEuQW4A",
      "channelTitle": "CubeHead",
      "publishedAt": "2024-02-14T14:00:16Z",
      "thumbnail": "https://i.ytimg.com/vi/PW2J8IblczM/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=PW2J8IblczM"
    },
    {
      "position": 3,
      "id": "iAa7_mDgjTw",
      "type": "video",
      "title": "How to solve a Rubik's Cube In 2026",
      "description": "If you have always wanted to learn how to solve a Rubik's Cube, today I am showing you the EASIEST way to understand Cubing! That does no...",
      "channelId": "UCpp1GoykvTBuPiZt3FiFHjg",
      "channelTitle": "SoupTimmy",
      "publishedAt": "2026-01-24T00:01:02Z",
      "thumbnail": "https://i.ytimg.com/vi/iAa7_mDgjTw/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=iAa7_mDgjTw"
    }
  ],
  "totalResults": 1000000,
  "nextPageToken": "CAMQAA",
  "prevPageToken": null,
  "meta": {
    "elapsed": "2535ms",
    "timestamp": "2026-09-02T10:14:15.354Z"
  }
}

YouTube Video Details

Get detailed information about one or more YouTube videos, including statistics (views, likes, comments), descriptions, and tags. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/social/youtube/video?id=dQw4w9WgXcQ" \
  -H "X-API-Key: sk_live_your_api_key"

YouTube Channel Details

Get channel information including subscriber count, video count, total views, and optionally recent videos. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/social/youtube/channel?handle=@mkbhd&include_videos=true&video_count=5" \
  -H "X-API-Key: sk_live_your_api_key"

YouTube Playlist Videos

List the public videos in a YouTube playlist, in playlist order, each with the same statistics (views, likes, comments), description and tags that Video Details returns. The rows carry the same best-effort fields and empty values as Video Details. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/social/youtube/playlist?id=PLBCF2DAC6FFB574DE&video_count=2" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

Every row has the same fields as a Video Details result. Abbreviated to the first of the two videos:

{
  "playlist_id": "PLBCF2DAC6FFB574DE",
  "total_results": 2,
  "videos": [
    {
      "id": "dQw4w9WgXcQ",
      "title": "Example video",
      "description": "The first line of the description.",
      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "channelTitle": "Example channel",
      "publishedAt": "2009-10-25T06:57:33Z",
      "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
      "tags": ["music", "pop"],
      "categoryId": "10",
      "duration": "PT3M34S",
      "durationFormatted": "3:34",
      "durationSeconds": 214,
      "isShort": false,
      "viewCount": 1600000000,
      "likeCount": 18000000,
      "commentCount": 2300000,
      "engagementRate": 1.27
    }
  ],
  "meta": {
    "elapsed": "420ms",
    "timestamp": "2026-03-12T10:00:00.000Z"
  }
}

YouTube — Fields That Can Come Back Empty

Applies to all four YouTube endpoints. Every YouTube response carries the same keys, in the same order, with the same types on every call. A field we cannot state exactly is its documented empty value — never null, and never a guess.

engagementRate is 0 and isShort is false whenever the counts or the duration they are derived from are empty.

Instagram Profile API

Retrieve public Instagram profile data including follower counts, bio, and recent posts. This endpoint is free-tier eligible.

Parameters

Example Request

curl "https://apiserpent.com/api/social/instagram/profile?username=natgeo" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

Captured from that basic call (no include_*), showing the fields documented below. profilePicUrl is abbreviated for print — it is a long signed URL that expires:

{
  "success": true,
  "username": "natgeo",
  "profileUrl": "https://www.instagram.com/natgeo/",
  "fullName": "National Geographic",
  "biography": "Step into wonder and find your inner explorer with National Geographic 🌎",
  "externalUrl": "http://visitstore.bio/natgeo",
  "profilePicUrl": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-19/…_n.jpg",
  "followersCount": 268636947,
  "followingCount": 194,
  "postsCount": 32000,
  "isVerified": true,
  "isBusiness": false,
  "isPrivate": false,
  "accountType": "personal",
  "engagementRate": null,
  "avgLikesPerPost": null,
  "avgCommentsPerPost": null,
  "postsSampled": 0,
  "followerFollowingRatio": 1384726.53,
  "lastPostDate": null,
  "daysSinceLastPost": null,
  "isActive": null,
  "recentPosts": [],
  "accessLevel": "full",
  "meta": {
    "elapsed": "22040ms",
    "timestamp": "2026-09-02T11:39:06.438Z"
  }
}

LinkedIn Company API

Serpent's LinkedIn API returns public company firmographics — name, industry, size, headcount, headquarters, specialities, and more — from a company's LinkedIn URL or vanity slug. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/company?url=https://www.linkedin.com/company/microsoft" \
  -H "X-API-Key: sk_live_your_api_key"

LinkedIn Job Search API

Serpent's LinkedIn API returns an array of public job cards matching a keyword search, narrowed by any combination of location, geo ID, date posted, job type, experience level, workplace type, company, Easy Apply, early applicant and sort order. Every response carries a filters object echoing exactly which filters were applied. Use start to page through results. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/jobs?keywords=software+engineer&location=San+Francisco+Bay+Area&start=0" \
  -H "X-API-Key: sk_live_your_api_key"

Example Request (with filters)

curl "https://apiserpent.com/api/linkedin/jobs?keywords=software+engineer&location=United+States&date_posted=past_week&job_type=full_time,contract&experience_level=mid_senior,director&remote=remote,hybrid&easy_apply=true&sort=recent" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response (abridged — one of the 10 job cards shown)

{
  "success": true,
  "data": {
    "keywords": "software engineer",
    "location": "United States",
    "start": 0,
    "filters": {
      "date_posted": "past_week",
      "job_type": ["full_time", "contract"],
      "experience_level": ["mid_senior", "director"],
      "remote": ["remote", "hybrid"],
      "easy_apply": true,
      "sort": "recent"
    },
    "count": 10,
    "jobs": [
      {
        "job_id": "3901234567",
        "job_url": "https://www.linkedin.com/jobs/view/3901234567",
        "job_title": "Senior Software Engineer",
        "company_name": "Microsoft",
        "company_linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_logo": "https://media.licdn.com/dms/image/company-logo.png",
        "location": "Redmond, WA",
        "job_posted_date": "2026-06-24"
      }
    ]
  }
}

LinkedIn Job Details API

Serpent's LinkedIn API returns the full detail for a single public job posting by ID — description, seniority, employment type, applicant count, salary range, and the job poster. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/job?job_id=3901234567" \
  -H "X-API-Key: sk_live_your_api_key"

LinkedIn Profile Search API BETA

Resolve a person's name to a short list of candidate public LinkedIn profiles, so you can pick the right one and then call Profile or Full Profile with its public_identifier. Narrow the match with the optional company, title and location parameters. Up to 10 candidates are returned. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/search?name=Bill+Gates&company=Microsoft" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response (abridged — one of the 7 candidates shown)

{
  "success": true,
  "data": {
    "query_name": "Bill Gates",
    "count": 7,
    "results": [
      {
        "profile_url": "https://www.linkedin.com/in/williamhgates",
        "public_identifier": "williamhgates",
        "name": "Bill Gates",
        "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy"
      }
    ]
  }
}

LinkedIn Profile API

Serpent's LinkedIn API returns best-effort public profile basics — name, headline, occupation, location, follower/connection counts, profile flags, and current company — from a profile URL or vanity slug. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/profile?username=williamhgates" \
  -H "X-API-Key: sk_live_your_api_key"

LinkedIn Full Profile API

Premium endpoint. Serpent's LinkedIn API returns richer public profile detail — identity, summary, full experience history, education, photo, and follower/connection counts. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/profile/full?username=williamhgates" \
  -H "X-API-Key: sk_live_your_api_key"

LinkedIn Posts API

Serpent's LinkedIn API returns a person's recent public posts — content, publish date, and engagement (reactions/comments/reposts) — resolved from the person's profile URL, username, or name. This endpoint is free-eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/linkedin/posts?username=williamhgates" \
  -H "X-API-Key: sk_live_your_api_key"

Google Maps Quick Place Search

Returns up to 20 ranked place records. New accounts get Free to start, shared across every endpoint — Web Search, News, Images, Videos, AI Rank, LinkedIn, Maps, YouTube, and Instagram. The four Maps endpoints serve on https://api.apiserpent.com/api/maps/*; verify your exact query in the playground before production integration.

Parameters

Tested cURL

BASE_URL="${SERPENT_BASE_URL:-http://localhost:3001}"
curl --get "$BASE_URL/api/maps/search/quick" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "q=coffee" \
  --data-urlencode "location=New York, NY" \
  --data-urlencode "country=us"

Search response

{
  "success": true,
  "type": "maps",
  "endpoint": "quick",
  "places": [{
    "rank": 1, "place_id": "...", "name": "Example Coffee",
    "website": "https://example.com", "rating": 4.6,
    "detail_status": "complete"
  }],
  "counts": { "requested": 20, "discovered": 20, "returned": 20, "fully_enriched": 19, "core_only": 1 },
  "meta": { "elapsed_ms": 27498, "partial": true }
}

Google Maps Deep Place Search

Attempts positions 1–100 using the same parameters and place schema as Quick, plus detail. Deep draws on the same shared 10-call free pool as every other endpoint; a free call counts as one call whatever detail you ask for.

Parameters

Everything Quick accepts except start, plus two Deep-only parameters:

curl --get "$BASE_URL/api/maps/search" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "q=coffee" \
  --data-urlencode "location=New York, NY" \
  --data-urlencode "detail=20"

A local acceptance run on 2026-07-02 returned 97 places in 88.2 seconds: 85 complete and 12 core_only. That was a full-depth (detail=100) pass run directly against the worker, which is deeper than the synchronous cap allows and is not a production latency guarantee — real latency varies with detail, query, country, and platform load.

Maps List (detail=0)

detail=0 is a different product at a different price, on the same route. It returns the ranked business list and nothing else — nothing comes back enriched — and it is billed as Maps List, not as Maps Deep. There is no separate endpoint and no flag: send detail=0 and this is what you are buying.

curl --get "$BASE_URL/api/maps/search" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "q=dentist" \
  --data-urlencode "location=Austin, TX" \
  --data-urlencode "detail=0" \
  --data-urlencode "limit=20"

limit picks the band, and it counts places returned — not places enriched, which is what Deep’s band counts. Same shape, same edge, a different quantity:

Google Maps Place Details

Returns one richest-available normalized place. Provide exactly one identifier.

curl --get "$BASE_URL/api/maps/place" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "place_id=ChIJ..."

Place response fields

Every one of those keys is always present, in that order, on every place record. The ones typed … | null carry null rather than disappearing; the ones marked always an object/array are never null. So 'phone' in place is always true — test the value, not the key. A null means Google does not expose that field for that place; absence is honest, never fabricated.

Google Maps Reviews

Returns up to 20 public reviews per call. Provide exactly one place identifier and reuse the returned opaque token for the next page.

curl --get "$BASE_URL/api/maps/reviews" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "place_id=ChIJ..." \
  --data-urlencode "sort=newest"

Top-level response fields

Review response fields (reviews[])

Review fields can be null when Google does not expose them for a given review. Absolute review dates are not always available; relative_date is the reliable label.

Amazon Search API

Serpent's Amazon API returns one page of ranked product cards for a keyword search on any supported marketplace — ASIN, title, image, price, currency, rating, ratings total and badges. This endpoint is free-tier eligible (shared 10-call pool). Amazon bills per 1,000 requests, never per 1,000 results: one request is one page, and a page carries 16–48 product cards depending on the marketplace (measured: 16 on amazon.com and amazon.co.uk, 48 on amazon.de and amazon.co.jp).

Parameters

Response fields

Example Request

curl "https://apiserpent.com/api/amazon/search?q=laptop+stand&domain=amazon.com" \
  -H "X-API-Key: sk_live_your_api_key"

Amazon Product API

Returns one full product record for an ASIN on any supported marketplace — pricing, availability, seller, ratings, feature bullets, images, variants, category ranks and specs, plus the review sample and the rating histogram Amazon renders on the product page. This endpoint is free-tier eligible (shared 10-call pool).

Parameters

Response fields

Example Request

curl "https://apiserpent.com/api/amazon/product?asin=B08N5WRWNW&domain=amazon.com" \
  -H "X-API-Key: sk_live_your_api_key"

Amazon Bestsellers API

Returns a ranked Best Sellers chart — about 30 entries for a category chart, and somewhat more for the site-wide one — for a category on any supported marketplace, or for the site-wide chart when no category is given. This endpoint is free-tier eligible (shared 10-call pool).

Parameters

Response fields

Example Request

curl "https://apiserpent.com/api/amazon/bestsellers?category=electronics&domain=amazon.com" \
  -H "X-API-Key: sk_live_your_api_key"

TikTok Profile API

Returns a public TikTok creator profile — identity, bio, link-in-bio, verification, region, interaction settings and exact follower/like/video counts — and optionally the creator's posts, followers, following or liked lists. This endpoint is free-tier eligible (shared 10-call pool).

Parameters

Example Request

curl "https://apiserpent.com/api/tiktok/profile?username=zachking" \
  -H "X-API-Key: sk_live_your_api_key"

Example Response

A basic call with no include_* group. Avatar URLs are abbreviated for print — they are signed and expiring:

{
  "success": true,
  "username": "zachking",
  "user_id": "6612508400412",
  "sec_uid": "MS4wLjABAAAA…",
  "nickname": "Zach King",
  "biography": "Make the impossible possible",
  "bio_link": "https://zachkingmagic.com",
  "profile_url": "https://www.tiktok.com/@zachking",
  "verified": true,
  "private_account": false,
  "is_organization": false,
  "commerce_user": false,
  "tt_seller": false,
  "is_ad_virtual": false,
  "region": null,
  "language": null,
  "created_at": "2018-09-25T18:33:20.000Z",
  "avatar": {
    "thumb": "https://p16-sign.tiktokcdn-us.com/…~c5_100x100.jpeg?x-expires=…",
    "medium": "https://p16-sign.tiktokcdn-us.com/…~c5_720x720.jpeg?x-expires=…",
    "large": "https://p16-sign.tiktokcdn-us.com/…~c5_1080x1080.jpeg?x-expires=…"
  },
  "stats": {
    "follower_count": 82100000,
    "following_count": 67,
    "like_count": 1000000000,
    "video_count": 1024,
    "friend_count": 42
  },
  "settings": {
    "comment": 0,
    "duet": 0,
    "stitch": 0,
    "download": 0,
    "following_visibility": 1,
    "liked_videos_public": false
  },
  "tabs": {
    "music": false,
    "question": false,
    "playlist": true
  },
  "meta": {
    "elapsed": "3184ms",
    "timestamp": "2026-09-08T09:14:22.118Z"
  }
}

TikTok Video API

Returns a single public TikTok video record — caption, creation time and region, the true author, the sound, technical media metadata, exact engagement counts, hashtags, mentions and content labels — and optionally its comments, related videos, or a header-free hosted copy of the file. This endpoint is free-tier eligible (shared 10-call pool) except when include_media is set.

Parameters

Response fields

Example Request

curl "https://apiserpent.com/api/tiktok/video?url=https://www.tiktok.com/@zachking/video/7137423965982686469" \
  -H "X-API-Key: sk_live_your_api_key"

TikTok Hashtag, Search & Music APIs

Three list endpoints that return full video records in one shared envelope: videos carrying a hashtag, videos matching a keyword search, and videos using a sound. All three are free-tier eligible (shared 10-call pool) and all three bill on the enriched band, because each returns a whole list rather than a single record.

Parameters

The list envelope

Example Request

curl "https://apiserpent.com/api/tiktok/hashtag?tag=cooking&limit=30" \
  -H "X-API-Key: sk_live_your_api_key"

X (Twitter) Post API

Returns one public post, looked up by its numeric id or its permalink — text, language, timestamp, author identity, engagement counts, media, hashtags, mentions, links, and the post it quotes or replies to. Billed per request, never per item: one call is one charge whatever the post carries. This endpoint is free-tier eligible (shared 10-call pool).

Parameters

One of the two is required — send neither and the call is a 400. Sending a list (?id=1&id=2) is also a 400: one post per call. Time limit: 20 seconds. Read the live value from limits.endpoints["/api/x/tweet"].max_seconds on GET /api/status.

Response fields

Every key below is always present, in this order. A value we could not read comes back as its own empty (null, [], false) — never as a missing key.

Example Request

curl "https://apiserpent.com/api/x/tweet?id=1234567890123456789" \
  -H "X-API-Key: sk_live_your_api_key"

X (Twitter) Profile API

Returns a public profile by handle — display name, bio, avatar, follower/following/post counts, join date, website link, and the recent posts the profile itself lists. Billed per request, one charge whatever the profile holds. This endpoint is free-tier eligible (shared 10-call pool).

Parameters

One of handle or url is required. X's own route names are not handles and are refused with a 400: i, home, explore, search, messages, notifications, settings, compose, login, logout, signup, about, tos, privacy, hashtag. Time limit: 45 seconds. Read the live value from limits.endpoints["/api/x/profile"].max_seconds on GET /api/status.

Response fields

There is no verified field on a profile, and that is deliberate. The badge is not reliably readable from a public profile, and a wrong false on a verified account is worse than no field at all. Where you need it, the post endpoint carries author.verified on that account's posts.

Example Request

curl "https://apiserpent.com/api/x/profile?handle=example&hydrate=true" \
  -H "X-API-Key: sk_live_your_api_key"

Reddit Subreddit Listing API

Returns a community's post listing — up to 100 records synchronously, each with title, author, score, comment count, timestamps, flair, awards, media and body text. Five Reddit endpoints share one rate; all five are free-tier eligible (shared 10-call pool) and all five sit in the standard discount band. Three are flat per call; these two are priced by limit.

Parameters

Time limit: 45 seconds.

Response fields

The envelope carries subreddit (echoed as served and identity-checked — a listing belonging to a different community answers 404 rather than arriving under the name you asked for), sort as used, count, and posts[]. t is not echoed. A delivery block is added only when the response is short of limit.

Every post key is always present; a value the listing did not carry comes back as null, 0 or false, never as a missing key. The three nested objects — flair, top_award, media — work the other way round: they are null when there is nothing to carry, and when present they hold only the keys that were actually there. Check for a key inside them rather than assuming it.

Example Request

curl "https://apiserpent.com/api/reddit/posts?subreddit=python&sort=top&t=week&limit=50" \
  -H "X-API-Key: sk_live_your_api_key"

Reddit Comments API

Returns a post's comment thread, flat or nested, up to 100 comments synchronously. Same rate and same block billing as the subreddit listing. Free-tier eligible (shared 10-call pool).

Parameters

Time limit: 45 seconds.

Response fields

The envelope carries post_id, subreddit, total_comments, count and comments[]. total_comments is the thread's own stated total, never our count of what we returned — it is null when no total was stated, and it is never back-filled from count, which would turn “we returned 100” into “there are 100”. Every comment served is identity-checked against post_id; one comment belonging to a different post makes the whole call a 404 rather than a mixed thread.

Example Request

curl "https://apiserpent.com/api/reddit/comments?subreddit=python&post_id=1abcdef&limit=100&tree=true" \
  -H "X-API-Key: sk_live_your_api_key"

Reddit Search, User & Community APIs

Three flat-rate lookups: post search, a user summary card and a community summary. Each is one charge at any depth — there is no block curve on these three, and on /search the limit is a page size and nothing more. All three are free-tier eligible (shared 10-call pool). Time limit: 45 seconds on each.

Parameters

Response fields

Example Request

curl "https://apiserpent.com/api/reddit/search?q=async%20python&limit=50" \
  -H "X-API-Key: sk_live_your_api_key"

curl "https://apiserpent.com/api/reddit/user?username=example_user" \
  -H "X-API-Key: sk_live_your_api_key"

curl "https://apiserpent.com/api/reddit/subreddit?name=python" \
  -H "X-API-Key: sk_live_your_api_key"

Async Jobs

Some pulls legitimately take longer than any synchronous request should hold a connection open — detail=100 on Maps, limit=50 on LinkedIn posts, or a few hundred searches you want run in one go. For those, submit the work as a job: you get a job id back immediately and collect the results when they are ready, by polling, by webhook, or from a results file.

Jobs are billed on exactly the same price curve as the equivalent synchronous call — there is no async surcharge and no async discount.

Which form to use

The first two are convenience wrappers: they take the same query parameters as their synchronous twin and submit a one-item job. Their 202 body is the same as POST /api/bulk/jobs plus two ready-made paths, poll and results, so you do not have to build the URLs yourself. Whichever form you use, you poll, collect and cancel through the same /api/bulk/jobs/… endpoints below.

1. Submit a job

curl -X POST "https://apiserpent.com/api/bulk/jobs" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "clientRef": "nightly-run-2026-08-21",
    "items": [
      { "endpoint": "serp_web",    "params": { "q": "mesothelioma lawyer", "country": "us", "num": 100 } },
      { "endpoint": "serp_news",   "params": { "q": "insurance rates", "country": "gb" } },
      { "endpoint": "maps_search", "params": { "q": "dentist", "location": "Austin, TX", "detail": 100 } }
    ],
    "delivery": {
      "webhook": { "url": "https://yourapp.example.com/hooks/serpent", "secret": "whsec_your_secret" },
      "storage": { "enabled": true, "format": "jsonl" }
    }
  }'

Request body

Endpoint keys

Response — 202 Accepted

{
  "success": true,
  "job": {
    "id": "job_9f2c41a8b7d05e6314ca7b90f2ee18d3",
    "status": "queued",
    "itemCount": 3,
    "counts": { "pending": 3, "processing": 0, "succeeded": 0, "failed": 0 },
    "billing": { "estimated": 0.0758, "settled": 0, "refunded": 0, "released": 0 },
    "delivery": {
      "poll": true,
      "webhook": { "url": "https://yourapp.example.com/hooks/serpent", "hasSecret": true },
      "storage": { "enabled": true, "format": "jsonl" }
    },
    "webhook": { "state": "pending" },
    "clientRef": "nightly-run-2026-08-21",
    "createdAt": "2026-08-21T09:14:22.518Z",
    "updatedAt": "2026-08-21T09:14:22.518Z",
    "completedAt": null,
    "results": null
  }
}

Keep job.id. Everything below is addressed by it.

2. Poll the job

curl "https://apiserpent.com/api/bulk/jobs/job_9f2c41a8b7d05e6314ca7b90f2ee18d3" \
  -H "X-API-Key: sk_live_your_api_key"

The response is the same job object as the submit reply, with counts, status and billing updated. Poll it on your own schedule; there is no long-poll and no streaming.

Job status values

Per-item status is pending, processing, succeeded or failed.

3. Collect the results

curl -L "https://apiserpent.com/api/bulk/jobs/job_9f2c41a8b7d05e6314ca7b90f2ee18d3/results" \
  -H "X-API-Key: sk_live_your_api_key"

If you asked for a results file and it is ready, this responds 302 with a signed download URL — use curl -L (or follow the redirect in your client) to fetch it. Otherwise the results come back inline. Each result is the same body the synchronous endpoint returns — the example is abbreviated to the envelope of a serp_web item that asked for num=100 and received 63 rows, its results.organic list left out:

{
  "success": true,
  "status": "partial",
  "jobId": "job_9f2c41a8b7d05e6314ca7b90f2ee18d3",
  "itemCount": 3,
  "count": 3,
  "offset": 0,
  "limit": 100,
  "items": [
    {
      "index": 0,
      "endpoint": "serp_web",
      "status": "succeeded",
      "result": {
        "success": true,
        "query": "mesothelioma lawyer",
        "type": "web",
        "engine": "google",
        "country": "us",
        "pagesRequested": 10,
        "requestedNum": 100,
        "pagesScraped": 7,
        "results": { "organic": [] },
        "delivery": {
          "requested": 100,
          "returned": 63,
          "note": "Delivered the results gathered within this request. Fewer than requested were returned."
        }
      }
    },
    { "index": 1, "endpoint": "serp_news",   "status": "succeeded", "result": { "success": true, "query": "insurance rates", "type": "news", "engine": "google", "country": "gb", "results": { "articles": [] } } },
    { "index": 2, "endpoint": "maps_search", "status": "failed",    "error": { "code": "request_failed", "message": "We are undergoing maintenance. Please try again shortly." } }
  ]
}

index matches the position of the item in the items array you submitted, so results line up with your input regardless of the order they finished in.

A failed item carries error as an object, never a string:

A failed item is refunded in full — except not_found, which is charged. An item whose target genuinely does not exist — an Instagram username, a YouTube video, channel or playlist id — fails with { "code": "not_found", "message": "The requested resource was not found." }, and that is charged: a resource that does not exist is an answer, exactly as it is on the synchronous call. Every other failure code returns the item's credits in full.

4. List your jobs

curl "https://apiserpent.com/api/bulk/jobs?limit=25" \
  -H "X-API-Key: sk_live_your_api_key"

Returns { "success": true, "count": n, "jobs": [ … ] }, newest first. limit is 1–100 (default: 25).

5. Cancel a job

curl -X POST "https://apiserpent.com/api/bulk/jobs/job_9f2c41a8b7d05e6314ca7b90f2ee18d3/cancel" \
  -H "X-API-Key: sk_live_your_api_key"

Best effort: items already running are allowed to finish and are charged; items not yet dispatched are cancelled and refunded. Results for whatever completed stay retrievable.

6. Webhook callback

If you supplied delivery.webhook.url, we POST a JSON body to it once, when the job reaches a terminal state.

{
  "type": "bulk.job.completed",
  "jobId": "job_9f2c41a8b7d05e6314ca7b90f2ee18d3",
  "status": "partial",
  "counts": { "pending": 0, "processing": 0, "succeeded": 2, "failed": 1 },
  "results": {
    "downloadUrl": "https://…signed-download-url…",
    "expiresAt": "2026-08-21T10:14:22.518Z"
  }
}

results is present only when you asked for a results file. The callback carries the summary, never the result payloads — fetch those from the download URL or the results endpoint.

Webhook headers

Verifying the signature

Standard Webhooks scheme. Sign the string {webhook-id}.{webhook-timestamp}.{raw body} with your secret and compare in constant time. A secret beginning whsec_ is base64-decoded after the prefix; any other secret is used as raw UTF-8.

const crypto = require('crypto');

function verify(headers, rawBody, secret) {
  const id = headers['webhook-id'];
  const ts = headers['webhook-timestamp'];
  const sent = headers['webhook-signature'];              // "v1,<base64>"
  if (!id || !ts || !sent) return false;
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;   // 5-minute replay window

  const key = secret.startsWith('whsec_')
    ? Buffer.from(secret.slice(6), 'base64')
    : Buffer.from(secret, 'utf8');
  const expected = 'v1,' + crypto.createHmac('sha256', key)
    .update(`${id}.${ts}.${rawBody}`).digest('base64');

  const a = Buffer.from(sent), b = Buffer.from(expected);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Delivery rules

• HTTPS only, and the URL must resolve to a public address.
• Up to 3 attempts, 10 seconds each. Any 2xx counts as delivered.
• Redirects are not followed — a 3xx counts as not delivered.
• Delivery never blocks polling. If the callback fails every attempt the results are still there, and job.webhook.state reads failed.

7. How long jobs and results live

8. Billing

Credits are reserved per item when the job is submitted, at the price tier locked at submission time — so a long-running job cannot change price partway through. Every item is settled on its own, and the rules are the synchronous ones:

job.billing reports it as it happens: estimated at submit, then settled (charged, including the charged not_found items and the delivered part of any partly-refunded item), refunded (refunded items and refunded bands) and released (cancelled items). settled + refunded always adds up to estimated once a job reaches a terminal state, so the ledger reconciles against your own estimate without inspecting a single item. That ledger, not the item body, is the record of what you paid: a failed item's error body is identical whether it was charged or refunded.

9. Errors on submission

On poll, results and cancel, a 404 with code: "not_found" means no job with that id belongs to this account — check the id returned by the submit call, and remember jobs are deleted after 7 days. These three management calls consume no credits at all, so this 404 costs nothing; the charged not_found above is an item's result, not a job-lookup miss.

Search Engines

Serpent API supports five search engines: Google (default), Bing, Yahoo, DuckDuckGo and Brave. Use the engine parameter on any SERP endpoint to choose.

On Deep Search the results object carries the same keys on every engine — the notes below describe which blocks each engine tends to fill in, not which keys you get back. On Quick Search the answer is the same for all five: organic results only. AI Mode (include_ai_mode=true) is engine-independent — unlike include_aio, it is returned on all five Deep Search engines.

Country/Region Support

Get localized search results by specifying a country code. This affects the language, regional rankings, and availability of results.

Returns a list of all supported country codes programmatically. This endpoint does not require an API key.

Example Response

Abbreviated — the real list carries every supported code, and count is its length:

{
  "success": true,
  "count": 112,
  "countries": [
    { "code": "us", "region": "us" },
    { "code": "uk", "region": "uk" }
  ]
}

Supported Countries

We support 112 countries for localized search results (gb is an alias for uk).

Popular Countries

Example: Search in Germany

curl "https://apiserpent.com/api/search?q=beste+seo+tools&country=de" \
  -H "X-API-Key: sk_live_your_api_key"

Language Support

Restrict search results to a specific language by passing a 2-letter ISO 639-1 code to the language parameter. Accepted on all engines across web, news and image search — and on shopping search when that endpoint ships; language coverage is broadest on Yahoo, Bing and Brave, and narrower on DuckDuckGo. It is not accepted on video search.

Common Languages