{
  "info": {
    "name": "Techmap's Job Postings API",
    "description": "Search the last 3 months of job postings from 185 sources in 250 countries & territories. Returns JSON (or CSV, RSS, Atom, XML, Parquet).\n\nSet the collection variable rapidapiKey to your key. Docs: https://api.techmap.io/jobs-api",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://daily-international-job-postings.p.rapidapi.com"
    },
    {
      "key": "rapidapiKey",
      "value": "YOUR_API_KEY"
    }
  ],
  "item": [
    {
      "name": "Search job postings",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-RapidAPI-Key",
            "value": "{{rapidapiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/jobs/search?title=developer&countryCode=us",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "jobs",
            "search"
          ],
          "query": [
            {
              "key": "format",
              "value": "",
              "description": "The format of the output in json, csv, rss, atom, xml, or parquet (e.g., `format=rss`)",
              "disabled": true
            },
            {
              "key": "dateCreated",
              "value": "",
              "description": "The day the job posting was created / posted on using the format `YYYY-MM-DD` or `YYYY-MM`. If empty, the current day minus 2 days is used.",
              "disabled": true
            },
            {
              "key": "dateCreatedMin",
              "value": "",
              "description": "The starting date for a date range search of when the job posting was created or posted, using the format `YYYY-MM-DD`. Only used if `dateCreated` is empty; `dateCreatedMin` and `dateCreatedMax` must be used together.",
              "disabled": true
            },
            {
              "key": "dateCreatedMax",
              "value": "",
              "description": "The ending date for a date range search of when the job posting was created or posted, using the format `YYYY-MM-DD`. Only used if `dateCreated` is empty; `dateCreatedMin` and `dateCreatedMax` must be used together.",
              "disabled": true
            },
            {
              "key": "page",
              "value": "",
              "description": "The page of the paginated search results starting at 1. Pages contain 10 jobs and the defaults to 1 if not stated.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "",
              "description": "The cursor in a cursor-based pagination search started with 'true'. Does not work together with page-based pagination. Defaults to null if not stated.",
              "disabled": true
            },
            {
              "key": "sort",
              "value": "",
              "description": "The sort order of the results by the time the job posting was collected: 'oldest' (default) or 'newest'. 'oldest' keeps page-based pagination stable while new jobs are added; 'newest' returns the most recent jobs first. Works with page-based and cursor-based pagination (a cursor keeps the sort order it was created with).",
              "disabled": true
            },
            {
              "key": "isDirect",
              "value": "",
              "description": "A flag indicating if the job posting URL or externalApplyUrl links directly to the company's website.",
              "disabled": true
            },
            {
              "key": "isDuplicate",
              "value": "",
              "description": "A flag indicating whether the job posting is considered a duplicate of another, either within the same source or across multiple sources. Note: We currently err on the safe side, resulting in more false duplicates than there are.",
              "disabled": true
            },
            {
              "key": "isActive",
              "value": "",
              "description": "A flag indicating if the job posting has a dateActive not yet reached.",
              "disabled": true
            },
            {
              "key": "isRecruiter",
              "value": "",
              "description": "A flag indicating if the job posting was posted by a recruiting firm.",
              "disabled": true
            },
            {
              "key": "title",
              "value": "developer",
              "description": "Free-text search within the title of the job postings.",
              "disabled": false
            },
            {
              "key": "skills",
              "value": "",
              "description": "The skills, keywords, or tags associated with the job posting.",
              "disabled": true
            },
            {
              "key": "language",
              "value": "",
              "description": "The language the job posting is written in described by a 2-letter language code from ISO 639-1 such as 'en', 'de' or 'zh'.",
              "disabled": true
            },
            {
              "key": "contractType",
              "value": "",
              "description": "The type of employment contract extracted from the job posting such as permanent, temporary, internship, etc.",
              "disabled": true
            },
            {
              "key": "workType",
              "value": "",
              "description": "The type of work duration extracted from the job posting such as fulltime, parttime, flextime, etc.",
              "disabled": true
            },
            {
              "key": "workPlace",
              "value": "",
              "description": "The workplace of the job, extracted from the job posting such as remote, hybrid, onsite, field, offshore, etc.",
              "disabled": true
            },
            {
              "key": "hasSalary",
              "value": "",
              "description": "A flag indicating if the job posting contains salary information.",
              "disabled": true
            },
            {
              "key": "minSalary",
              "value": "",
              "description": "The minimum salary of the job posting. Can be yearly, monthly, or hourly and any currency (exact data is stated in JsonLD result).",
              "disabled": true
            },
            {
              "key": "industry",
              "value": "",
              "description": "The industry extracted from the job posting or categorization in the job board, such as advertising, agriculture, it, healthcare, etc.",
              "disabled": true
            },
            {
              "key": "company",
              "value": "",
              "description": "The company that posted the job posting (can be a recruiting firm).",
              "disabled": true
            },
            {
              "key": "department",
              "value": "",
              "description": "The department extracted from the job title such as, finance, it, hr, sales, etc.",
              "disabled": true
            },
            {
              "key": "occupation",
              "value": "",
              "description": "The occupation type extracted from the job title reduced to a stem form incl. several synonyms. For example: programmer, executive, manager, engineer, nurse, etc.",
              "disabled": true
            },
            {
              "key": "countryCode",
              "value": "us",
              "description": "The country the job is located in described by a 2-letter country code from ISO 3166-1 alpha-2. Internally, we lower-case the countryCode and convert 'gb' into 'uk' and 'el' into 'gr' - you can use both spellings.",
              "disabled": false
            },
            {
              "key": "state",
              "value": "",
              "description": "The state the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "city",
              "value": "",
              "description": "The city the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "postCode",
              "value": "",
              "description": "The postal / zip code the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "timezone",
              "value": "",
              "description": "The timezone the job is located in such as CET, PST, or UTC",
              "disabled": true
            },
            {
              "key": "timezoneOffset",
              "value": "",
              "description": "The numeric offset of the timezone from UTC.",
              "disabled": true
            },
            {
              "key": "timezoneMin",
              "value": "",
              "description": "The minimum numeric offset of the timezone from UTC. Requires a 'timezoneMax' value greater than 'timezoneMin' to search in a timezone range.",
              "disabled": true
            },
            {
              "key": "timezoneMax",
              "value": "",
              "description": "The maximum numeric offset of the timezone from UTC. Must be larger than 'timezoneMin' to search in a timezone range.",
              "disabled": true
            },
            {
              "key": "geoPointLat",
              "value": "",
              "description": "The geographic latitude of a GeoPoint used in a distance search.",
              "disabled": true
            },
            {
              "key": "geoPointLng",
              "value": "",
              "description": "The geographic longitude of a GeoPoint used in a distance search.",
              "disabled": true
            },
            {
              "key": "geoDistance",
              "value": "",
              "description": "The distance from a GeoPoint specified with 'geoPointLat' and 'geoPointLng'.",
              "disabled": true
            },
            {
              "key": "geoTopLeftLat",
              "value": "",
              "description": "The geographic latitude of the top left GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoTopLeftLng",
              "value": "",
              "description": "The geographic longitude of the top left GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoBottomRightLat",
              "value": "",
              "description": "The geographic latitude of the bottom right GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoBottomRightLng",
              "value": "",
              "description": "The geographic longitude of the bottom right GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "portal",
              "value": "",
              "description": "The portal the job postings originated from.",
              "disabled": true
            },
            {
              "key": "source",
              "value": "",
              "description": "The specific source with countrycode the job postings originated from such as careerjet, monster, linkedin, techmap, etc.",
              "disabled": true
            }
          ]
        },
        "description": "Use this endpoint to get the job postings themselves (10 per request). If you only need the number of matching postings, use count instead. This endpoint returns the paginated search results for a search query using various query parameters. The response is returned per default in JSON format and primarily consists of a JSON-LD payload containing up to 10 JobPostings per page (see https://schema.org/JobPosting). With the format parameter other output formats can be requested.\nThis structured data can be directly integrated into a webpage to enhance visibility and indexing by search engines (e.g., https://developers.google.com/search/docs/appearance/structured-data/job-posting)."
      }
    },
    {
      "name": "Count job postings",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-RapidAPI-Key",
            "value": "{{rapidapiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/jobs/count?countryCode=de",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "jobs",
            "count"
          ],
          "query": [
            {
              "key": "format",
              "value": "",
              "description": "The format of the output in json, csv, rss, atom, xml, or parquet (e.g., `format=rss`)",
              "disabled": true
            },
            {
              "key": "dateCreated",
              "value": "",
              "description": "The day the job posting was created / posted on using the format `YYYY-MM-DD` or `YYYY-MM`. If empty, the current day minus 2 days is used.",
              "disabled": true
            },
            {
              "key": "dateCreatedMin",
              "value": "",
              "description": "The starting date for a date range search of when the job posting was created or posted, using the format `YYYY-MM-DD`. Only used if `dateCreated` is empty; `dateCreatedMin` and `dateCreatedMax` must be used together.",
              "disabled": true
            },
            {
              "key": "dateCreatedMax",
              "value": "",
              "description": "The ending date for a date range search of when the job posting was created or posted, using the format `YYYY-MM-DD`. Only used if `dateCreated` is empty; `dateCreatedMin` and `dateCreatedMax` must be used together.",
              "disabled": true
            },
            {
              "key": "isDirect",
              "value": "",
              "description": "A flag indicating if the job posting URL or externalApplyUrl links directly to the company's website.",
              "disabled": true
            },
            {
              "key": "isDuplicate",
              "value": "",
              "description": "A flag indicating whether the job posting is considered a duplicate of another, either within the same source or across multiple sources. Note: We currently err on the safe side, resulting in more false duplicates than there are.",
              "disabled": true
            },
            {
              "key": "isActive",
              "value": "",
              "description": "A flag indicating if the job posting has a dateActive not yet reached.",
              "disabled": true
            },
            {
              "key": "isRecruiter",
              "value": "",
              "description": "A flag indicating if the job posting was posted by a recruiting firm.",
              "disabled": true
            },
            {
              "key": "title",
              "value": "",
              "description": "Free-text search within the title of the job postings.",
              "disabled": true
            },
            {
              "key": "skills",
              "value": "",
              "description": "The skills, keywords, or tags associated with the job posting.",
              "disabled": true
            },
            {
              "key": "language",
              "value": "",
              "description": "The language the job posting is written in described by a 2-letter language code from ISO 639-1 such as 'en', 'de' or 'zh'.",
              "disabled": true
            },
            {
              "key": "contractType",
              "value": "",
              "description": "The type of employment contract extracted from the job posting such as permanent, temporary, internship, etc.",
              "disabled": true
            },
            {
              "key": "workType",
              "value": "",
              "description": "The type of work duration extracted from the job posting such as fulltime, parttime, flextime, etc.",
              "disabled": true
            },
            {
              "key": "workPlace",
              "value": "",
              "description": "The workplace of the job, extracted from the job posting such as remote, hybrid, onsite, field, offshore, etc.",
              "disabled": true
            },
            {
              "key": "hasSalary",
              "value": "",
              "description": "A flag indicating if the job posting contains salary information.",
              "disabled": true
            },
            {
              "key": "minSalary",
              "value": "",
              "description": "The minimum salary of the job posting. Can be yearly, monthly, or hourly and any currency (exact data is stated in JsonLD result).",
              "disabled": true
            },
            {
              "key": "industry",
              "value": "",
              "description": "The industry extracted from the job posting or categorization in the job board, such as advertising, agriculture, it, healthcare, etc.",
              "disabled": true
            },
            {
              "key": "company",
              "value": "",
              "description": "The company that posted the job posting (can be a recruiting firm).",
              "disabled": true
            },
            {
              "key": "department",
              "value": "",
              "description": "The department extracted from the job title such as, finance, it, hr, sales, etc.",
              "disabled": true
            },
            {
              "key": "occupation",
              "value": "",
              "description": "The occupation type extracted from the job title reduced to a stem form incl. several synonyms. For example: programmer, executive, manager, engineer, nurse, etc.",
              "disabled": true
            },
            {
              "key": "countryCode",
              "value": "de",
              "description": "The country the job is located in described by a 2-letter country code from ISO 3166-1 alpha-2. Internally, we lower-case the countryCode and convert 'gb' into 'uk' and 'el' into 'gr' - you can use both spellings.",
              "disabled": false
            },
            {
              "key": "state",
              "value": "",
              "description": "The state the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "city",
              "value": "",
              "description": "The city the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "postCode",
              "value": "",
              "description": "The postal / zip code the workplace is located in, extracted from the job posting or geo-location.",
              "disabled": true
            },
            {
              "key": "timezone",
              "value": "",
              "description": "The timezone the job is located in such as CET, PST, or UTC",
              "disabled": true
            },
            {
              "key": "timezoneOffset",
              "value": "",
              "description": "The numeric offset of the timezone from UTC.",
              "disabled": true
            },
            {
              "key": "timezoneMin",
              "value": "",
              "description": "The minimum numeric offset of the timezone from UTC. Requires a 'timezoneMax' value greater than 'timezoneMin' to search in a timezone range.",
              "disabled": true
            },
            {
              "key": "timezoneMax",
              "value": "",
              "description": "The maximum numeric offset of the timezone from UTC. Must be larger than 'timezoneMin' to search in a timezone range.",
              "disabled": true
            },
            {
              "key": "geoPointLat",
              "value": "",
              "description": "The geographic latitude of a GeoPoint used in a distance search.",
              "disabled": true
            },
            {
              "key": "geoPointLng",
              "value": "",
              "description": "The geographic longitude of a GeoPoint used in a distance search.",
              "disabled": true
            },
            {
              "key": "geoDistance",
              "value": "",
              "description": "The distance from a GeoPoint specified with 'geoPointLat' and 'geoPointLng'.",
              "disabled": true
            },
            {
              "key": "geoTopLeftLat",
              "value": "",
              "description": "The geographic latitude of the top left GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoTopLeftLng",
              "value": "",
              "description": "The geographic longitude of the top left GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoBottomRightLat",
              "value": "",
              "description": "The geographic latitude of the bottom right GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "geoBottomRightLng",
              "value": "",
              "description": "The geographic longitude of the bottom right GeoPoint in a bounding box search.",
              "disabled": true
            },
            {
              "key": "portal",
              "value": "",
              "description": "The portal the job postings originated from.",
              "disabled": true
            },
            {
              "key": "source",
              "value": "",
              "description": "The specific source with countrycode the job postings originated from such as careerjet, monster, linkedin, techmap, etc.",
              "disabled": true
            }
          ]
        },
        "description": "Use this endpoint when you only need numbers - e.g. for labour market analysis or to size a query before paging through search. It accepts the same filters as search. This endpoint returns the total number of job postings matching the specified query parameters. The response is per default a simple JSON object containing the count of job postings as well as the used query send to the underlying database. With the format parameter other output formats can be requested."
      }
    },
    {
      "name": "List distinct values of a field",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-RapidAPI-Key",
            "value": "{{rapidapiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/meta/jobs/distinct?field=workPlace",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "meta",
            "jobs",
            "distinct"
          ],
          "query": [
            {
              "key": "field",
              "value": "workPlace",
              "description": "A field name used in a query as a parameter",
              "disabled": false
            },
            {
              "key": "format",
              "value": "",
              "description": "The format of the output in json, csv, rss, atom, xml, or parquet (e.g., `format=rss`)",
              "disabled": true
            }
          ]
        },
        "description": "Use this endpoint to find valid filter values (e.g. which industries or workplaces exist) - not to get job postings. This endpoint returns a list of distinct field values for the given query parameter. The response is per default a simple JSON object containing a list of keys usable as query parameter values and the count of jobs with this field value. With the format parameter other output formats can be requested. \nNotes\n This endpoint is not included in every plan (see Errors & billing). Without it, the response is 403 with requiredPlan and pricingUrl. \n The results are capped at 500 values and are calculated from job postings within the last month (i.e., current date minus 1 month). \nUsage Examples\nUsed workPlace values:\n `/api/v2/meta/jobs/distinct?field=workPlace`\nUsed industry values:\n `/api/v2/meta/jobs/distinct?field=industry`"
      }
    },
    {
      "name": "Get value statistics of a field",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-RapidAPI-Key",
            "value": "{{rapidapiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/meta/jobs/statistics?field=industry",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "meta",
            "jobs",
            "statistics"
          ],
          "query": [
            {
              "key": "field",
              "value": "industry",
              "description": "A field name used in a query as a parameter",
              "disabled": false
            },
            {
              "key": "format",
              "value": "",
              "description": "The format of the output in json, csv, rss, atom, xml, or parquet (e.g., `format=rss`)",
              "disabled": true
            }
          ]
        },
        "description": "Use this endpoint to see how job postings are distributed over the values of a field (count and percentage per value). For a single number, use count. This endpoint returns a list of statistics of field values for the given query parameter. The response is per default a simple JSON object containing a list of keys usable as query parameter values, the count of jobs with this field value, and the percentage of jobs with this value. With the format parameter other output formats can be requested. \nNotes\n This endpoint is not included in every plan (see Errors & billing). Without it, the response is 403 with requiredPlan and pricingUrl. \n The results are capped at 100 values and are calculated from job postings within the last month (i.e., current date minus 1 month). \nUsage Examples\nStatistics on the workPlace field:\n `/api/v2/meta/jobs/statistics?field=workPlace`\nStatistics on the industry field:\n `/api/v2/meta/jobs/statistics?field=industry`"
      }
    }
  ]
}