https://github.com/go-api-libs/jobicy

Go library for the Remote Jobs API/RSS Feed. Discover and integrate a diverse range of remote job listings with Jobicy's public API. This API offers the latest remote job opportunities across various industries and regions, making it a valuable resource for developers and businesses looking to enhance their job feed platforms.
https://github.com/go-api-libs/jobicy

api api-client api-library go golang integration job-search job-search-website jobicy jobicy-api jobs jobsearch openapi openapi3

Last synced: 3 months ago
JSON representation

Go library for the Remote Jobs API/RSS Feed. Discover and integrate a diverse range of remote job listings with Jobicy's public API. This API offers the latest remote job opportunities across various industries and regions, making it a valuable resource for developers and businesses looking to enhance their job feed platforms.

• Host: GitHub
• URL: https://github.com/go-api-libs/jobicy
• Owner: go-api-libs
• License: mit
• Created: 2024-12-04T23:59:05.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-12-22T12:12:49.000Z (5 months ago)
• Last Synced: 2025-01-14T02:35:58.085Z (5 months ago)
• Topics: api, api-client, api-library, go, golang, integration, job-search, job-search-website, jobicy, jobicy-api, jobs, jobsearch, openapi, openapi3
• Homepage:
• Size: 691 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🌍 Remote Jobs API

[![Go Reference](https://pkg.go.dev/badge/github.com/go-api-libs/jobicy.svg)](https://pkg.go.dev/github.com/go-api-libs/jobicy/pkg/jobicy)

[![Official Documentation](https://img.shields.io/badge/docs-API-blue)](https://jobicy.com/jobs-rss-feed)

[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-blue)](/api/openapi.json)

[![Go Report Card](https://goreportcard.com/badge/github.com/go-api-libs/jobicy)](https://goreportcard.com/report/github.com/go-api-libs/jobicy)

![Code Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)

![API Health](https://img.shields.io/badge/API_health-65%25-yellowgreen)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

Discover and integrate a diverse range of remote job listings with Jobicy's public API. This API offers the latest remote job opportunities across various industries and regions, making it a valuable resource for developers and businesses looking to enhance their job feed platforms. Supports filters for job region, industry, and keywords to help you target specific job markets.

## Installation

To install the library, use the following command:

```shell

go get github.com/go-api-libs/jobicy/pkg/jobicy

```

## Usage

### Example: 

```go

package main

import (

	"context"

	"github.com/go-api-libs/jobicy/pkg/jobicy"

)

func main() {

	c, err := jobicy.NewClient()

	if err != nil {

		panic(err)

	}

	ctx := context.Background()

	jobsList, err := c.ListRemoteJobs(ctx, &jobicy.ListRemoteJobsParams{

		Count:    20,

		Geo:      "usa",

		Industry: "marketing",

		Tag:      "seo",

	})

	if err != nil {

		panic(err)

	}

	// Use jobsList object

}

```

## Additional Information

- [**Go Reference**](https://pkg.go.dev/github.com/go-api-libs/jobicy/pkg/jobicy): The Go reference documentation for the client package.

- [**Official Documentation**](https://jobicy.com/jobs-rss-feed): The official API documentation.

- [**OpenAPI Specification**](./api/openapi.json): The OpenAPI 3.1.0 specification.

- [**Go Report Card**](https://goreportcard.com/report/github.com/go-api-libs/jobicy): Check the code quality report.

## Contributing

If you have any contributions to make, please submit a pull request or open an issue on the [GitHub repository](https://github.com/go-api-libs/jobicy).

## License

This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.