{
  "openapi": "3.0.1",
  "info": {
    "title": "Etimad Scraper | Tenders, Awards and Deadlines",
    "description": "Etimad scraper (اعتماد, منصة اعتماد) for Saudi government tenders: deadlines, agency, purpose, region and city, contract duration, guarantees, bidders and winners. Search Arabic keywords, filter by activity, region and stage, or look up reference numbers. 10 tenders in 13 seconds, 41 fields each.",
    "version": "1.0",
    "x-build-id": "NlDXsHBbtuQa97BBb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~etimad-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-etimad-scraper",
        "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/silentflow~etimad-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-etimad-scraper",
        "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/silentflow~etimad-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-etimad-scraper",
        "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": {
          "keywords": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "Words to find in Etimad tenders, in Arabic as published, for example <code>صيانة</code> (maintenance), <code>تقنية المعلومات</code> (IT) or <code>نظافة</code> (cleaning). Spelling variants are covered for you: <code>اعمال</code> also finds <code>أعمال</code>, <code>صيانه</code> also finds <code>صيانة</code>. One search per keyword, results merged without duplicates. Leave empty to read the newest tenders that match the filters.",
            "items": {
              "type": "string"
            }
          },
          "tenderIds": {
            "title": "🔗 Tender reference numbers or links",
            "type": "array",
            "description": "Look up tenders you already know: paste Etimad reference numbers (الرقم المرجعي, such as <code>261139002558</code>) or tender page links (<code>https://tenders.etimad.sa/Tender/DetailsForVisitor?STenderId=...</code>), one per line. Every tender listed is returned, whatever <b>Max tenders</b> says. Useful to refresh the deadline, the stage and the award results of tenders you follow.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max tenders",
            "minimum": 1,
            "type": "integer",
            "description": "How many tenders the keyword and filter searches return at most. Tenders listed by reference number or link are always all returned. Etimad lists about 1,400 open tenders at any time. Our test runs read 10 tenders with full pages in 11 seconds and 12 in under 3 minutes; with full pages off, 30 tenders came back in 4 seconds.",
            "default": 50
          },
          "status": {
            "title": "🚦 Tender stage",
            "enum": [
              "open",
              "opening",
              "evaluation",
              "awarding",
              "awarded",
              "closed",
              "all"
            ],
            "type": "string",
            "description": "<b>Open for offers</b> returns tenders you can still bid on. Pick <b>Award announced</b> or <b>Closed</b> to get past tenders with their bidders, offers and winners.",
            "default": "open"
          },
          "activities": {
            "title": "🏗️ Business activities",
            "type": "array",
            "description": "Etimad's main activities (نشاط المنافسة). One search per activity, results merged.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19"
              ],
              "enumTitles": [
                "Trade (التجارة)",
                "Contracting (المقاولات)",
                "Facility operation, maintenance and cleaning (التشغيل والصيانة والنظافة للمنشآت)",
                "Real estate and land (العقارات والأراضي)",
                "Industry, mining and recycling (الصناعة والتعدين والتدوير)",
                "Gas, water and energy (الغاز والمياه والطاقة)",
                "Mines, petroleum and quarries (المناجم والبترول والمحاجر)",
                "Media, publishing and distribution (الإعلام والنشر والتوزيع)",
                "Telecom and IT (الاتصالات وتقنية المعلومات)",
                "Agriculture and fishing (الزراعة والصيد)",
                "Healthcare (الرعاية الصحية والنقاهة)",
                "Education and training (التعليم والتدريب)",
                "Employment and recruitment (التوظيف والاستقدام)",
                "Security and safety (الأمن والسلامة)",
                "Transport, mail and storage (النقل والبريد والتخزين)",
                "Consulting (المهن الاستشارية)",
                "Tourism, hospitality and events (السياحة والمطاعم والفنادق وتنظيم المعارض)",
                "Finance and insurance (المالية والتمويل والتأمين)",
                "Other services (الخدمات الأخرى)"
              ]
            }
          },
          "regions": {
            "title": "📍 Regions",
            "type": "array",
            "description": "Saudi regions where the work is carried out (منطقة التنفيذ). Several regions are searched together.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13"
              ],
              "enumTitles": [
                "Riyadh (منطقة الرياض)",
                "Makkah (منطقة مكة المكرمة)",
                "Madinah (منطقة المدينة المنورة)",
                "Qassim (منطقة القصيم)",
                "Eastern Province (المنطقة الشرقية)",
                "Asir (منطقة عسير)",
                "Tabuk (منطقة تبوك)",
                "Hail (منطقة حائل)",
                "Northern Borders (منطقة الحدود الشمالية)",
                "Jazan (منطقة جازان)",
                "Najran (منطقة نجران)",
                "Al Bahah (منطقة الباحة)",
                "Al Jouf (منطقة الجوف)"
              ]
            }
          },
          "tenderTypes": {
            "title": "📑 Tender types",
            "type": "array",
            "description": "Public tender, direct purchase, limited tender, reverse auction and the other Etimad tender types. One search per type.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "4",
                "5",
                "6",
                "7",
                "8",
                "11",
                "12",
                "15"
              ],
              "enumTitles": [
                "Public tender (منافسة عامة)",
                "Direct purchase (شراء مباشر)",
                "Limited tender (منافسة محدودة)",
                "Electronic reverse auction (المزايدة العكسية الالكترونية)",
                "Two-stage tender, first stage (المنافسة على مرحلتين (المرحلة الاولى))",
                "Two-stage tender, second stage (المنافسة على مرحلتين (المرحلة الثانية))",
                "Post-qualification (تأهيل لاحق)",
                "Framework agreement (منافسة إتفاقية إطارية)",
                "Design contest (مسابقة)",
                "Large companies tender (منافسات الشركات الكبرى)"
              ]
            }
          },
          "agency": {
            "title": "🏛️ Government agency contains",
            "type": "string",
            "description": "Keep only tenders whose agency or branch name contains this text, any spelling, for example <code>أمانة منطقة الرياض</code> or <code>وزارة الصحة</code>."
          },
          "publishedWithin": {
            "title": "📅 Published within",
            "enum": [
              "any",
              "2days",
              "week",
              "month",
              "3months"
            ],
            "type": "string",
            "description": "Only tenders Etimad published in this window. <b>Last 2 days</b> plus a daily schedule makes a new-tender alert.",
            "default": "any"
          },
          "closingWithinDays": {
            "title": "⏳ Closing within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Only open tenders whose offer deadline is at most this many days away, for example <code>7</code> for a closing-soon list. Empty or 0: no limit."
          },
          "includeDetails": {
            "title": "📄 Full tender page and award results",
            "type": "boolean",
            "description": "On: each row adds the tender purpose, place of execution (region and city), contract duration, guarantees, insurance, contractor classification, local content rules, expected award and work start dates, and for past tenders every bidder with its offer and the winners with the award value. Off: faster, the search list fields only.",
            "default": 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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}