Pricing

from $250.00 / 1,000 tadawul stock records

Tadawul Saudi Stock Screener — TASI Market Data API

Screen TASI stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. Saudi Arabia fundamentals for analysts and AI agents.

Pricing

from $250.00 / 1,000 tadawul stock records

Rating

0.0

(0)

Developer

NexGenData

Actor stats

Bookmarked

Total users

Monthly active users

8 days ago

Last modified

Categories

Business

Automation

Developer tools

You can access the Tadawul Saudi Stock Screener — TASI Market Data API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "CPLpJiDGmmog9SURv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgendata~tadawul-saudi-stock-screener/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgendata-tadawul-saudi-stock-screener",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nexgendata~tadawul-saudi-stock-screener/runs": {
      "post": {
        "operationId": "runs-sync-nexgendata-tadawul-saudi-stock-screener",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nexgendata~tadawul-saudi-stock-screener/run-sync": {
      "post": {
        "operationId": "run-sync-nexgendata-tadawul-saudi-stock-screener",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "index": {
            "title": "Index / Market",
            "enum": [
              "TASI",
              "Tadawul-all"
            ],
            "type": "string",
            "description": "Which Saudi market scope to screen: TASI (Tadawul All Share Index large-cap constituents — Aramco 2222, Al Rajhi 1120, SABIC 2010, STC 7010, SNB 1180, Maaden 1211, etc.) or Tadawul-all (entire Tadawul main-market universe — ~380 listed companies). TASI is the headline Saudi blue-chip benchmark; Tadawul-all gives you the full Saudi listed universe.",
            "default": "TASI"
          },
          "limit": {
            "title": "Limit (stocks returned)",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Maximum number of Saudi-listed stocks to return. Stocks are returned in descending market-cap order. Use 10 for a quick smoke test, 50 for the TASI top-cap names, 100 for broad TASI coverage, 380+ to pull the entire Tadawul main-market universe. The Saudi Stock Exchange has roughly 380 listed companies.",
            "default": 50
          },
          "min_market_cap_sar_billion": {
            "title": "Min market cap (billion SAR)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Filter to stocks with market cap above this threshold, in BILLIONS of Saudi Riyal (SAR). Examples: 10 = 10B SAR (mid-cap floor), 50 = 50B SAR (TASI heavy-weight), 200 = 200B SAR (top 5 Saudi mega-caps like Aramco, Al Rajhi, Maaden, SNB, STC), 1000 = 1T SAR (Aramco-tier). Leave at 0 for no filter. Note: 1 USD ≈ 3.75 SAR (Saudi Riyal is pegged to USD).",
            "default": 0
          },
          "sector": {
            "title": "Sector / industry / name keyword",
            "type": "string",
            "description": "Optional case-insensitive substring filter applied to sector, industry, and company name. Examples: 'bank' (Al Rajhi, SNB, Riyad Bank, Alinma, Saudi Awwal Bank), 'oil' (Aramco), 'petrochemical' (SABIC), 'telecom' (STC, Etihad Etisalat / Mobily, Zain), 'mining' (Maaden), 'real estate', 'utilities' (Saudi Electricity), 'healthcare' (Dr. Sulaiman Al Habib). Leave blank for no filter. Note: sector matching requires enrich_fundamentals=true."
          },
          "enrich_fundamentals": {
            "title": "Enrich with fundamentals (slower)",
            "type": "boolean",
            "description": "If true, fetch each stock's detail page on stockanalysis.com to extract P/E ratio, forward P/E, EPS, dividend yield, shares outstanding, beta, RSI, 52-week range, sector and industry classification, and earnings dates. Adds ~1 HTTP request per stock and roughly doubles runtime. Required if you want to filter by sector.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy configuration. Defaults to Apify datacenter proxy for reliable global access to stockanalysis.com. Switch to RESIDENTIAL group only if you hit rate limits — the Saudi listing page is lightweight and rarely throttles.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Tadawul Saudi Stock Screener — TASI Quotes & Fundamentals OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Tadawul Saudi Stock Screener — TASI Market Data API from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Tadawul Saudi Stock Screener — TASI Market Data API API in Python

Tadawul Saudi Stock Screener — TASI Market Data API API in JavaScript

Tadawul Saudi Stock Screener — TASI Market Data API API through CLI

Tadawul Saudi Stock Screener — TASI Market Data API API

STAR Market China Screener — 科创板 A股 API

nexgendata/star-market-china-stock-screener

Screen STAR 50 stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. China fundamentals for analysts and AI agents.

NexGenData

B3 Brazil Stock Screener — Ibovespa Market Data API

nexgendata/b3-brasil-stock-screener

Screen Ibovespa stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. Brazil fundamentals for analysts and AI agents.

NexGenData

BSE India Stock Screener — SENSEX Data API

nexgendata/bse-india-stock-screener

Screen SENSEX stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. India fundamentals for analysts and AI agents.

NexGenData

NSE India Stock Screener — NIFTY 50 Data API

nexgendata/nse-india-stock-screener

Screen NIFTY 50 stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. India fundamentals for analysts and AI agents.

NexGenData

Chinese ADRs Stock Screener — US Market Data API

nexgendata/chinese-adrs-stock-screener

Screen US-listed Chinese ADRs stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. United States fundamentals for analysts and AI agents.

NexGenData

PSE Philippines Stock Screener — PSEi Data API

nexgendata/pse-philippines-stock-screener

Screen PSEi stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. Philippines fundamentals for analysts and AI agents.

NexGenData

ChiNext China Stock Screener — 创业板 A股 API

nexgendata/chinext-china-stock-screener

Screen ChiNext stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. China fundamentals for analysts and AI agents.

NexGenData

SET Thailand Stock Screener — SET50 Data API

nexgendata/set-thailand-stock-screener

Screen SET50 / SET100 stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. Thailand fundamentals for analysts and AI agents.

NexGenData

SGX Singapore Stock Screener — STI Data API

nexgendata/sgx-singapore-stock-screener

Screen Straits Times Index (STI) stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. Singapore fundamentals for analysts and AI agents.

NexGenData

KOSPI Korea Stock Screener — 한국 주식 Data API

nexgendata/kospi-stock-screener

Screen KOSPI stocks by market cap, P/E, dividend yield and more — clean JSON, no data-vendor contract. South Korea fundamentals for analysts and AI agents.

NexGenData