Search GitHub repositories using natural language
Natural language search that uses AI to understand your query and automatically generate search terms and filters. Requires SEARCH service. Credits: 1 per result returned + 1 for AI processing + graph relationship credits if includeAttributes is specified.
Body Parameters
Natural language query describing the repositories you want to find
Cursor for pagination (from previous response pageInfo.endCursor)
When true, applies the LLM-generated filter to all user-returning includeAttributes (contributors, starrers). Alias for filterUserIncludeAttributes.
Enable cursor-based pagination to fetch results across multiple requests
[Deprecated: Use applyFiltersToIncludeAttributes] When true, applies the LLM-generated filter to all user-returning includeAttributes (contributors, starrers).
Alias for maxResults (takes precedence if both provided)
Maximum number of results to return (default: 100, max: 1000)
Returns
Number of repositories returned
The generated search query used for semantic search
Search GitHub repositories using natural language
curl https://api.bountylab.io/v2/search/repos/natural-language \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $BOUNTYLAB_API_KEY" \
-d '{
"query": "Find React libraries with over 1000 stars that have good TypeScript support and are actively maintained",
"after": "Y3Vyc29yOjEyMzQ1",
"applyFiltersToIncludeAttributes": true,
"enablePagination": true,
"filterUserIncludeAttributes": true,
"first": 50,
"includeAttributes": {
"contributors": {
"first": 10
},
"owner": true
},
"maxResults": 50
}'{
"count": 20,
"repositories": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
"name": "Hello-World",
"ownerLogin": "octocat",
"stargazerCount": 1500,
"totalIssuesClosed": 108,
"totalIssuesCount": 150,
"totalIssuesOpen": 42,
"contributors": {
"edges": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
}
],
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
},
"createdAt": "2011-01-26T19:01:12Z",
"description": "My first repository on GitHub!",
"embeddedAt": "2024-01-15T14:00:00Z",
"language": "JavaScript",
"lastContributorLocations": [
"San Francisco, CA",
"Berlin, Germany"
],
"owner": {
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
},
"ownerDevrank": {
"community": 0,
"crackedScore": 0,
"createdAt": "createdAt",
"followersIn": 0,
"followingOut": 0,
"pc": 0,
"rawScore": 0,
"tier": "tier",
"trust": 0,
"updatedAt": "updatedAt"
},
"ownerProfessional": {
"awards": [
"string"
],
"certifications": [
"string"
],
"city": "city",
"connectionsCount": 0,
"country": "country",
"currentIndustry": "currentIndustry",
"departments": [
"string"
],
"education": [
{
"campus": "campus",
"endDate": "endDate",
"major": "major",
"specialization": "specialization",
"startDate": "startDate"
}
],
"experience": [
{
"company": "company",
"endDate": "endDate",
"industry": "industry",
"isCurrent": true,
"location": "location",
"startDate": "startDate",
"summary": "summary",
"title": "title"
}
],
"expertise": [
"string"
],
"firstName": "firstName",
"followerCount": 0,
"functionalArea": "functionalArea",
"headline": "headline",
"languages": [
"string"
],
"lastName": "lastName",
"linkedinUrl": "linkedinUrl",
"location": "location",
"memberships": [
"string"
],
"organization": "organization",
"patents": [
"string"
],
"priorIndustries": [
"string"
],
"publications": [
"string"
],
"seniority": "seniority",
"seniorityLevel": "seniorityLevel",
"state": "state",
"title": "title"
},
"readmePreview": "# Hello World\n\nThis is my first repository...",
"score": 0.08,
"starrers": {
"edges": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
}
],
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
},
"updatedAt": "2024-01-15T12:30:00Z"
}
],
"searchQuery": "react component library",
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
}Returns Examples
{
"count": 20,
"repositories": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
"name": "Hello-World",
"ownerLogin": "octocat",
"stargazerCount": 1500,
"totalIssuesClosed": 108,
"totalIssuesCount": 150,
"totalIssuesOpen": 42,
"contributors": {
"edges": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
}
],
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
},
"createdAt": "2011-01-26T19:01:12Z",
"description": "My first repository on GitHub!",
"embeddedAt": "2024-01-15T14:00:00Z",
"language": "JavaScript",
"lastContributorLocations": [
"San Francisco, CA",
"Berlin, Germany"
],
"owner": {
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
},
"ownerDevrank": {
"community": 0,
"crackedScore": 0,
"createdAt": "createdAt",
"followersIn": 0,
"followingOut": 0,
"pc": 0,
"rawScore": 0,
"tier": "tier",
"trust": 0,
"updatedAt": "updatedAt"
},
"ownerProfessional": {
"awards": [
"string"
],
"certifications": [
"string"
],
"city": "city",
"connectionsCount": 0,
"country": "country",
"currentIndustry": "currentIndustry",
"departments": [
"string"
],
"education": [
{
"campus": "campus",
"endDate": "endDate",
"major": "major",
"specialization": "specialization",
"startDate": "startDate"
}
],
"experience": [
{
"company": "company",
"endDate": "endDate",
"industry": "industry",
"isCurrent": true,
"location": "location",
"startDate": "startDate",
"summary": "summary",
"title": "title"
}
],
"expertise": [
"string"
],
"firstName": "firstName",
"followerCount": 0,
"functionalArea": "functionalArea",
"headline": "headline",
"languages": [
"string"
],
"lastName": "lastName",
"linkedinUrl": "linkedinUrl",
"location": "location",
"memberships": [
"string"
],
"organization": "organization",
"patents": [
"string"
],
"priorIndustries": [
"string"
],
"publications": [
"string"
],
"seniority": "seniority",
"seniorityLevel": "seniorityLevel",
"state": "state",
"title": "title"
},
"readmePreview": "# Hello World\n\nThis is my first repository...",
"score": 0.08,
"starrers": {
"edges": [
{
"id": "9f0b8901cf1848298a60a60083b5aac0",
"githubId": "MDQ6VXNlcjU4MzIzMQ==",
"login": "octocat",
"bio": "I build things for GitHub",
"company": "GitHub",
"createdAt": "2011-01-25T18:44:36Z",
"displayName": "The Octocat",
"emails": [
"***at@github.com",
"***hn@gmail.com"
],
"embeddedAt": "2024-01-15T14:00:00Z",
"location": "San Francisco, CA",
"resolvedCity": "San Francisco",
"resolvedCountry": "United States",
"resolvedState": "California",
"score": 0.12,
"socialAccounts": [
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
],
"updatedAt": "2024-01-15T12:30:00Z",
"websiteUrl": "https://github.blog"
}
],
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
},
"updatedAt": "2024-01-15T12:30:00Z"
}
],
"searchQuery": "react component library",
"pageInfo": {
"endCursor": "endCursor",
"hasNextPage": true
}
}